Integracijos diegimas

Pagrindiniai punktai, ką reikia žinoti ir atlikti GPAIS sistemoje, aprašyti GPAIS pagrindai.

Pagrindiniai diegimo žingsniai :

• suinstaliuojamas OpenSSL - aprašymas ;
• iš GPAIS atsisiunčiamas privatus raktas;
• iš GPAIS atsisiunčiamas vartotojo atstovaujamų subjektų registracijos sąrašas;
• failas gpais.app įrašomas į RIV_GAMA arba RIV_GAMA\ALL katalogą;
• SISTEMOS INIT-e aprašomi GPAIS parametrai - aprašymas;
• užpildomi parametrai GPAIS_OPENSS ir GPAIS_VART - aprašymas ;
• sukuriamas dokumentų registras, skirtas suformuotų GPAIS duomenų saugojimui - aprašymas;
• prekių kortelėse matavimo vienetų koregavimo lange užprogramuojamas skirtukas "Prekės GPAIS pakuotės" - aprašymas;
• užprogramuojami klavišai tuose moduliuose, iš kurių bus formuojami GPAIS duomenys: pardavimo, pirkimo, atsargų, gamybos operacijose;
• dokumentų registre užprogramuojami klavišai ryšiui su GPAIS sistema: duomenų siuntimui ir šalinimui.

• pardavimo operacijų, kurių tipas "Važtaraštis",
• pirkimo operacijų, kurių tipas "Važtaraštis",
• atsargų operacijų, kuriose prekės nurašomos (kiekiai minusiniai).
• gamybos operacijų, kurių tipas "Surinkimas" (komponentėse esančioms prekėms).

Pardavimo (pirkimo, atsargų, gamybos) operacijos :

• operacijų sąraše sukuriamas papildomas stulpelis - jame bus rodoma ar dokumentas suformuotas į istoriją;
• operacijų sąraše užprogramuojamas klavišas GPAIS istorijos formavimui;
• operacijų sąraše užprogramuojamas klavišas GPAIS registro formavimui.

Dokumentų registro analitinės operacijos:

• dokumentų registro analitinėse operacijose užprogramuojamas klavišas prekinių vienetų/gaminių siuntimui;
• dokumentų registro analitinėse operacijose užprogramuojamas klavišas žurnalo siuntimui ;
• dokumentų registro analitinėse operacijose užprogramuojamas klavišas žurnalo šalinimui iš GPAIS;
• dokumentų registro analitinėse operacijose užprogramuojamas klavišas statuso "Nusiųsta" pakeitimui.

OpenSSL suinstaliavimas ir registracijos duomenų iš GPAIS atsisiuntimas.

Aprašymas faile:

OPEN_SSL_ir_GPAIS.zip

Importo programos įrašymas.

Į RIV_GAMA arba RIV_GAMA\ALL katalogą įrašomas failas gpais.app.

GPAIS parametrų aprašymas Sistemos INIT-e.

Sistemos INIT-e aprašomi GPAIS parametrai. INIT-ą užprogramuoti gali vartotojas, turintis administratoriaus teises (MASTER).

Atstovaujamų subjektų srautų registracijos ID atsisiunčiami iš GPAIS sistemos. Kaip tai atliekama, aprašyta Atstovaujamų subjektų srautų sąrašas.

GPAIS asmeninio parašo gavimas iš GPAIS sistemos aprašytas čia.

m.loGPAIS=GPAIS()
m.loGPAIS.pakuotes_id="1" && Pakuotės registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv
m.loGPAIS.alyvos_id="2" && Alyvos registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv
m.loGPAIS.transporto_id="3" && Transporto registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv
m.loGPAIS.apmokestinamu_id="4" && Apmokestinamų gaminių registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv
m.loGPAIS.bateriju_id="5" && Baterijų registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv
m.loGPAIS.elektronikos_id="6" && Elektronikos registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv
m.loGPAIS.debug=.f. && Jei .f., tai duomenys keliami į GPAIS, jei .t., tai duomenys į GPAIS nekeliami, o failas suformuojamas į pasirinktą katalogą. Default .f. 
m.loGPAIS.test=.f. && Jei .t., tai siuntimas vykdomas į test aplinką, jei .f., tada failas siunčiamas į produkcinę aplinką. Default .f.

m.loGPAIS.openssl_katalogas="C:\Program Files\OpenSSL-Win64\bin" && OpenSSL.exe katalogas. Jei nenurodytas parametras GPAIS_OPENSS parametrų sąraše, tuomet naudojama init reikšmė 
m.loGPAIS.asm_parasas="C:\Users\mindaugas\Desktop\Rivile\GPAIS standartas V2\gpaisAsmeninisParasas\id_rsa" && id_rsa failo pilnas kelias su id_rsa. Jei nenurodytas parametras GPAIS_VART parametrų sąraše, tuomet naudojama init reikšmė 
m.loGPAIS.gpais_vartotojas="mindaugas.cer" && GPAIS vartotojo vardas. Jei nenurodytas parametras GPAIS_VART parametrų sąraše, tuomet naudojama init reikšmė 

m.loGPAIS.registro_kodas="GPAIS" && Dokumento registro kodas. Default "GPAIS"
m.loGPAIS.gpais_kiekio_apval=1 && && GPAIS kiekio apvalinimo požymis siunčiant į žurnalą. 1-aritmetiškai ROUND(1.5,0)=2, 2-į mažesnę pusę INT(1.5)=1, 3-į didesnę pusę CEILING(1.2)=2, 4 - neapvalinama, paliekama programoje paskaičiuota išraiška. Default 1-aritmetiškai.

m.loGPAIS.usad_kodas='03370260' && Parametras skirtas užstatinės taros administratoriaus kodui nurodyti. Pagal nutylejimą šio parametro reikšmė '303370260' (tokią nurodė GPAIS).

Sistemos INIT-as gali būti aprašytas konkrečiam vartotojui, vartotojų grupei arba visiems vartotojams.

Pirmą kartą paleidžiant programą su Sistemos INIT-e aprašytais GPAIS parametrais, susikuria:

• lentelės GP01_KLASIF, GP02_PAK, GP03_MAT_PAK ir GP04_ISTOR,
• parametrai GPAIS_OPENSS (GPAIS OpenSSL.exe katalogas) ir GPAIS_VART (GPAIS vartotojo id_rsa kelias ir vartotojo vardas),
• meniu punktas GPAIS:

Parametrų GPAIS_OPENSS ir GPAIS_VART užpildymas

GPAIS asmeninio parašo gavimas iš GPAIS sistemos aprašytas čia.

Dokumentų registro, skirto suformuotų GPAIS duomenų saugojimui, sukūrimas

Sukuriamas naujas įrašas. Užpildomi laukai "Kodas" ir "Dokumento Nr.".

Standartiškai siūlome kodo lauke įvesti reikšmę "GPAIS".

Įrašas išsaugomas.

Jo viduje užprogramuojamas klavišas registro laukų sukūrimui:

GPAIS("SUKURTI_LAUK",,thisform)

Paspaudus užprogramuotą klavišą susikuria registro laukai:

Registras išsaugomas ir perkeliamas.

Skirtuko "Prekės GPAIS pakuotės" užprogramavimas

Prekės kortelės viduje matavimo vieneto koregavimo lange užprogramuojamas INIT-as:

GPAIS("GP03",,thisform)

Prekės matavimo vieneto koregavimo lange atsiranda skirtukas "Prekės GPAIS pakuotės", kuriame suvedami prekės mato vieneto pakuotės duomenys.

Pardavimo (pirkimo, atsargų, gamybos) operacijos

Papildomo stulpelio sukūrimas operacijų sąraše.

Užprogramuojamas arba papildomas metodas "Po nuskaitymo" :

GPAIS('PRIDETI_LAUK','',thisform)

Pardavimo operacijų sąraše matysis stulpelis "GPAIS Istorija"

Jis skirtas GPAIS istorijos informacijai. Stulpelyje parodoma ar dokumentas suformuotas į GPAIS istoriją.

Operacijų sąraše užprogramuojamas klavišas GPAIS istorijos formavimui

GPAIS("FORMUOTI",,thisform,lcWhere,lcGavimas,lcVeikla,lcVeiklaWhere,lcTaraWhere,lcGavimasWhere)

Parametrai:

• lcWhere - papildoma where sąlygą, pagal kurią atrenkame eilutes istorijos formavimui.
  Pirkimo ir pardavimo operacijose sąlygoje galima naudoti I27_FIFO, I07_PARD, N08_KLIJ, N17_PROD lentelių laukus.
  Atsargų nurašymo operacijose sąlygoje galima naudoti I27_FIFO, I12_IND, N08_KLIJ, N17_PROD lentelių laukus.
  Gamybos operacijose sąlygoje galima naudoti I27_FIFO, I16_KALD, N08_KLIJ, N17_PROD lentelių laukus.

• lcGavimas - gavimo būdo klasifikatoriaus kodas iš klasifikatorių sąrašo.

• lcVeikla - veiklos būdo klasifikatoriaus kodas iš klasifikatorių sąrašo.

• lcVeiklaWhere - veiklos būdo parinkimas. Jei šis parametras neperduodamas, tada veiklos būdas priskiriamas pagal lcVeikla kodą.
  Į lcVeiklaWhere parametrą rašoma sql sąlyga (pvz., "case when n08_kodas_ls_2='UZSIENIS' then 'CL118:ET' else 'CL118:DP' end").
  Sąlygoje "case" galima naudoti tik N08_KLIJ lentelės laukus.
  Parametras neperduodamas atsargų ir gamybos operacijose.

• lcTaraWhere - taros klasifikatoriaus parinkimas.
  Galima įrašyti arba loginę reikšmę (.T. arba .F.), arba sql sąlygą (pvz.: "case when n33_salies_k<>'LT' then 0 else 1 end"), kuri grąžina reikšmes 1 arba 0.
  Jei irašyta .T. arba sąl sąlyga grąžina reikšmę 1 - tada suprantama kaip užstatinė pakuotė, ir į GPAIS istoriją bus perduodamas tipas "Tara" ir barkodas iš lauko "Užstato barkodas (LT)",
  jei įrašyta .F. arba sql sąlyga grąžina reikšmę 0 - tada suprantama kaip standartinė pakuotė, ir į GPAIS istoriją bus perduodamas tipas "Pakuotės" ir klasifikatorius iš lauko "Užstato klasif. (Kita)".
  Sąlygoje "case" galima naudoti N08_KLIJ ir N33_KBAN lentelių laukus.

• lcGavimasWhere - gavimo būdo parinkimas (ar prekė pagaminta, ar įvežta, ar gauta kitais būdais).
  Į lcGavimasWhere parametrą rašoma sql sąlyga (pvz., "case when n08_kodas_ks is null then 'CL140:2' else 'CL140:1' end").
  Pirkimo ir pardavimo operacijose sąlygoje galima naudoti I27_FIFO, I07_PARD, N08_KLIJ, N17_PROD lentelių laukus.
  Atsargų nurašymo operacijose sąlygoje galima naudoti I27_FIFO, I12_IND, N08_KLIJ, N17_PROD lentelių laukus.
  Gamybos operacijose sąlygoje galima naudoti I27_FIFO, I16_KALD, N08_KLIJ, N17_PROD lentelių laukus.

Pvz.:

GPAIS("FORMUOTI",,thisform,"isnull(n08_kodas_ls_1,'')='GPAIS'","CL140:1","CL118:DP")

Istorija bus formuojama tik toms prekėms, kurių tiekėjo kortelėje pirmas logistikos kodas yra GPAIS. Šiama pavyzdyje nurodytas veiklos būdas CL118:DP - "Didmeninė prekyba", gavimo būdas CL140:1 - "Importuota".

GPAIS("FORMUOTI",,thisform,"(n08_kodas_ks is null or n08_kodas_ls_1 = 'GPAIS' ) ","CL140:1","CL118:DP","case when n08_kodas_ls_2='UZSIENIS' then 'CL118:ET' else 'CL118:DP'  end","case when n33_salies_k<>'LT' then 0 else 1 end", "case when n08_kodas_ks is null then 'CL140:2' else 'CL140:1' end")

Šiuo atveju, jei pirkėjo logistikos kodas 2 yra 'UZSIENIS', tai veiklos būdas bus priskiriamas CL118:ET - "Išvežimas iš LR vidaus rinkos per trečiuosius asmenis", kitu atveju - CL118:DP - "Didmeninė prekyba".
Jeigu prekei priskirta pakuotė su tipu "Tara", o pirkėjo alternatyviuose adresuose nurodyta šalis LT , tai į istoriją bus perduodamas tipas "Tara" ir užstato barkodas, priešingu atveju bus perduodamas tipas "Pakuotė" su lauke "Užstato klasif. (Kita)" nurodytu klasifikatorium.
Jei klientas yra NULL, tai gavimo būdas yra CL140:2 - "Pagaminta ", kitu atveju CL140:1 - "Importuota (įvežta) ".

Operacijų sąraše užprogramuojamas klavišas GPAIS registro formavimui

GPAIS("FORMUOTI_REG",,thisform)

Dokumentų registro analitinės operacijos

Dokumentų registro analitinėse operacijose užprogramuojamas klavišas prekinių vienetų/gaminių siuntimui

Nuskaitomas dokumentų registras "GPAIS" ir, atsistojus ant jo, paspaudžiamas mygtukas "Analitinė operacija".

Užprogramuojamas klavišas prekinių vienetų/ gaminių siuntimui į GPAIS:

GPAIS('PV_SIUNTIMAS','',thisform)

Dokumentų registro analitinėse operacijose užprogramuojamas klavišas žurnalo siuntimui

Nuskaitomas dokumentų registras "GPAIS" ir, atsistojus ant jo, paspaudžiamas mygtukas "Analitinė operacija".

Užprogramuojamas klavišas žurnalo siuntimui į GPAIS:

GPAIS('ZU_SIUNTIMAS','',thisform)

Dokumentų registro analitinėse operacijose užprogramuojamas klavišas žurnalo šalinimui iš GPAIS

Nuskaitomas dokumentų registras "GPAIS" ir, atsistojus ant jo, paspaudžiamas mygtukas "Analitinė operacija".

Užprogramuojamas klavišas žurnalo šalinimui iš GPAIS:

GPAIS('ZU_SALINIMAS','',thisform)

Dokumentų registro analitinėse operacijose užprogramuojamas klavišas statuso "Nusiųsta" pakeitimui

Nuskaitomas dokumentų registras "GPAIS" ir, atsistojus ant jo, paspaudžiamas mygtukas "Analitinė operacija".

Užprogramuojamas klavišas statuso "Nusiųsta" pakeitimui iš 1 į 0 GPAIS žurnalo siuntimo klaidų faile išvardintiems prekiniams vienetams:

GPAIS('PV_STATUS_PAGAL_LOG','',thisform)