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ą;
• sukuriamas dokumentų registras, skirtas suformuotų GPAIS duomenų saugojimui - aprašymas;
• SISTEMOS INIT-e aprašomi GPAIS parametrai - aprašymas;
• užpildomi parametrai GPAIS_OPENSS ir GPAIS_VART - 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 - aprašymas;
• dokumentų registre užprogramuojami klavišai ryšiui su GPAIS sistema: duomenų siuntimui ir šalinimui - aprašymas.

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.

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.

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("INIT","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.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).

m.loGPAIS.zurna_prefix=7 && SVARBU! Šis parametras naudojamas tik atsiradus problemai, kai nauji GPAIS žurnalų įrašų ID sutampa su senais! Reikšmė pagal nutylėjimą 0, tuomet naudojamas standartinis įmonės ID. Galimos kitos reikšmės nuo 1 iki 90. 

Parametras	Aprašymas	Pavyzdys
m.loGPAIS.pakuotes_id	Pakuotės registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv	m.loGPAIS.pakuotes_id="1"
m.loGPAIS.alyvos_id	Alyvos registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv	m.loGPAIS.alyvos_id="2"
m.loGPAIS.transporto_id	Transporto registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv	m.loGPAIS.transporto_id="3"
m.loGPAIS.apmokestinamu_id	Apmokestinamų gaminių registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv	m.loGPAIS.apmokestinamu_id="4"
m.loGPAIS.bateriju_id	Baterijų registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv	m.loGPAIS.bateriju_id="5"
m.loGPAIS.elektronikos_id	Elektronikos registracijos ID iš GPAIS sistemos eksportuoto failo subjektuRegistracijosSarasas.csv	m.loGPAIS.elektronikos_id="6"
m.loGPAIS.debug	Jei .F., tai duomenys keliami į GPAIS, jei .T., tai duomenys į GPAIS nekeliami, o failas suformuojamas į pasirinktą katalogą. Pagal nutylėjimą .F.	m.loGPAIS.debug=.f.
m.loGPAIS.test	Jei .T., tai siuntimas vykdomas į test aplinką, jei .F. - į produkcinę aplinką. Pagal nutylėjimą .F.	m.loGPAIS.test=.f.
m.loGPAIS.openssl_katalogas	OpenSSL.exe katalogas. Veikia, kai nenurodytas Rivile GAMA parametras GPAIS_OPENSS.	m.loGPAIS.openssl_katalogas="C:\Program Files\OpenSSL-Win64\bin"
m.loGPAIS.asm_parasas	id_rsa failo pilnas kelias su id_rsa. Veikia, kai nenurodytas Rivile GAMA parametras GPAIS_VART.	m.loGPAIS.asm_parasas="C:\Users\mindaugas\Desktop\Rivile\GPAIS
m.loGPAIS.gpais_vartotojas	GPAIS vartotojo vardas. Veikia, kai nenurodytas Rivile GAMA parametras GPAIS_VART.	m.loGPAIS.gpais_vartotojas="mindaugas.cer"
m.loGPAIS.gpais_kiekio_apval	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. Pagal nutylėjimą 1- aritmetiškai.	m.loGPAIS.gpais_kiekio_apval=1
m.loGPAIS.usad_kodas	Parametras skirtas užstatinės taros administratoriaus kodui nurodyti. Pagal nutylėjimą šio parametro reikšmė '303370260' (tokią nurodė GPAIS).	m.loGPAIS.usad_kodas='03370260'
m.loGPAIS.zurna_prefix	SVARBU! Šis parametras naudojamas tik atsiradus problemai, kai nauji GPAIS žurnalų įrašų ID sutampa su senais! Reikšmė pagal nutylėjimą 0, tada naudojamas standartinis įmonės ID. Galimos kitos reikšmės nuo 1 iki 90.	m.loGPAIS.zurna_prefix=7
m.loGPAIS.istor_prg	Parametras skirtas nurodyti tarpinei programai, kuri istorijos formavimo metu gali iškoreguoti istorijos duomenis (kiekvieną įrašą atskirai). Programoje yra pasiekiami du privatūs kintamieji ir lenta #GPAIS_TEMP. Informacijos nuskaitymas ir koregavimas vyksta #GPAIS_TEMP lentoje. Privatūs kintamieji: pcKodas_gp04 - unikalus GPAIS istorijos eilės kodas pnTipas - GPAIS istorijos eilės tipas. Tipai: 1 - Alyvos, 2 - Apmokestinami gaminiai, 3 - Baterijos ir akumuliatoriai, 4 - Elektronika, 5 - Pakuotės, 6 - Transportas, 7 - Veiklos būdas, 8 - Tara. Jei tarpinėje programoje atsiranda klaida, istorijos formavimas stabdomas.	m.loGPAIS.istor_prg="koreg_gpais_istor_pvz()"
m.loGPAIS.prek_prefix	Prefiksas pridedadmas prie prekės kodo. Reikšmė pagal nutylėjimą yra "", tada naudojamas standartinis GPAIS prekės skaitliukas. Jei GPAIS prekės kodas Rivile GAMA programoje yra 000000000001, prie šio kodo pridėjus prefiksą "G-", GPAIS prekės kodas bus G-000000000001.	m.loGPAIS.prek_prefix="G-"
m.loGPAIS.nesiusti	Parametre nurodomi kokie laukai bus nesiunčiami ir neužpildomi siunčiant žurnalą į GPAIS. Šiuo metu galimos tik dvi reikšmės: dok_nr (dokumento nr.) ir pastabos (pastaba).	m.loGPAIS.nesiusti="dok_nr;pastabos"
m.loGPAIS.istrinti	XML failų ištrynimas po nusiuntimo į GPAIS. Parametrui priskyrus .F. reikšmę, visi siunčiami XML failai po nusiuntimo į GPAIS paliekami TMP kataloge. .T. - reikšmė pagal nutylėjimą - po nusiuntimo į GPAIS failai ištrinami.	m.loGPAIS.istrinti=.T.
m.loGPAIS.grup_veikla	Veiklos būdas pagal pakuotės klasifikatorių (gamybai). Parametrui priskyrus .T. reikšmę, GPAIS registro formavimo metu informacija į registrą bus įkelta papildomai grupuojant pagal veiklos būdą. .F. - reikšmė pagal nutylėjimą - sistema veikia senuoju režimu.	m.loGPAIS.grup_veikla=.F.
m.loGPAIS.suminis	Suminis GPAIS žurnalo duomenų teikimas. Parametrui priskyrus .T. reikšmę, GPAIS žurnalo siuntimo metu duomenys mėnesio lygyje sugrupuojami ir susumuojami pagal registro op. numerį, prekės kodą, GPAIS prekės kodą, gavimo būdą, veiklos būdą, GPAIS tipą, pavadinimą ir hash'ą. .F.- reikšmė pagal nutylėjimą - sistema viską siunčia detaliai.	m.loGPAIS.suminis=.F.
m.loGPAIS.f04_atmetimo_salyga	Parametras skirtas papildomam F04 lentelėje esančių duomenų atfiltravimui, kai vykdomas GPAIS prekių siuntimas, žurnalo siuntimas ar žurnalo šalinimas. Pagal nutylėjimą šio parametro reikšmė yra tuščia.	m.loGPAIS.f04_atmetimo_salyga=''
m.loGPAIS.f05_atmetimo_salyga	Parametras skirtas papildomam F05 lentoje esančių duomenų atfiltravimui, kai vykdomas GPAIS prekių siuntimas, žurnalo siuntimas ar žurnalo šalinimas.	m.loGPAIS.f05_atmetimo_salyga='f05_col13 <> 3'
m.loGPAIS.leisti_ivesti_pap_gam	.T. – Leidžia prie prekės GPAIS pakuočių įvesti neribotą kiekį gaminių. .F.(numatytoji reikšmė) – Sistema veikia senuoju režimu: galima įvesti tik vieną gaminį. Išimtis taikoma elektronikai – įvedus elektronikos gaminį, prie jo galima priskirti kelias baterijas.	m.loGPAIS.leisti_ivesti_pap_gam=.F.
m.loGPAIS.istor_prg_pries	Parametrui reikia priskirti .prg failą, kuriame aprašyta lentelės #GPAIS_TEMP iškoregavimo logika. Lentelėje #GPAIS_TEMP laikoma pradinė FIFO informacija prieš istorijos formavimą. Stulpeliai, dalyvaujantys FIFO apjungime su pakuotėmis: kodas_ps_n, kodas_us_p_n, kodas_us_n.	m.loGPAIS.istor_prg_pries="koreg_gpais_istor_pries()" && suprogramuota programa pagal kliento logiką

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.

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

Duomenys į GPAIS gali būti formuojami iš:

• pardavimo operacijų, kurių tipas "Važtaraštis" arba "Grąžinimas",
• pirkimo operacijų, kurių tipas "Važtaraštis" arba "Grąžinimas",
• atsargų operacijų, kurių tipas "Nurašymas", o kiekiai minusiniai,
• gamybos operacijų, kurių tipas "Surinkimas" (komponentėse esančioms prekėms).

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.
  Atsargų ir gamybos operacijose veiklos kodas gali būti tik statinis ir perduodamas per parametrą "lcVeikla".

• 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ąlyga grąžina reikšmę 1 - tada suprantama kaip užstatinė tara, ir į GPAIS istoriją bus perduodamas tipas "Tara" ir barkodas iš lauko "Užstato barkodas (LT)". Jei jis neužpildytas, perduodama lauko "USAD barkodas" reikšmė iš prekės GPAIS pakuočių, o jei nei vienas jų neužpildytas - pačios prekės barkodas.
  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.
  Atsargų ir gamybos operacijose funkcijos parametras "lcTaraWhere" gali būti tik .T. arba .F.

• 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)