Zināšanu bāze Integrācija

Integrācijām ar Horizon tiek izmantoti WEB lietotāji. Tas ir lietotāja paveids Horizon, ko izmanto pieslēgšanai WEB aplikācijām, t.sk. REST integrācijām. Veidojot WEB lietotāju, tam obligāti jānorāda Horizon lietotājs, jo pēc šī Horizon lietotāja tiek noteikta WEB lietotāja loma un tiesības, kas nosaka pieejamās funkcionālās sadaļas un tiesības apstrādāt vai skatīt datus.   Tātad vispirms nepieciešams izveidot lomu ar atbilstošām pieejas tiesībām. Vairāk par lomu veidošanu lasīt šeit. Sistēma - Administrēt - Lomas       Nākamais solis ir izveidot Horizon lietotāju. Sistēma - Administrēt - Lietotāji Šādam lietotājam norāda konta veidu Sistēmkonts.       Lappusē Tiesības norāda, kuras firmas datiem būs pieeja un ar kādu lomu.       Visbeidzot var veidot WEB lietotāju. Sistēma - Administrēt - WEB lietotāji Lappusa Pamatinformācija Arī šeit konta veids jānorāda Sistēmkonts, kā arī WEB lietotājs jāsasaista ar Horizon lietotāju. Lappusē Firmas un objekti norāda, kura šim pieslēgumam būs noklusētā firma. Lappusē Atļautās saskarnes atzīmē "piešķirtās" un norāda saskarni "Vispārējā integrācija", ja vien nav izveidota atsevišķa saskarne topošajai integrācijai. Vairāk par saskarnēm lasīt šeit.      

Lai izgūtu no Horizon datus par darbinieku prombūtnēm, var izmantot Horizon atskaiti Plānotās prombūtnes (Atskaites - Personāla uzskaite - Plānotās prombūtnes). Šajā atskaitē pieejami dati gan par notiekošām prombūtnēm, gan plānotām (pieteiktām). Ja nepieciešams, iespējams paskatīties arī uz pagātnē notikušām prombūtnēm.   REST vaicājuma piemērs:     ...rest/TpuAbsencesSL/query?columns= DOKT_ID,DOKT_KODS,DOKT_NOSAUK,ERS_TNUM,ERS_PK_PERS,ERS_FNAME,ERS_LNAME,PSADM_NOSAUK,PSAMA_NOSAUK,ABS_STATUS,ABS_DAT_FROM,ABS_DAT_TO,ABS_DOC_PK,AISL_PK_PERS,AISLP_FNAME,AISLP_LNAME,AIZV_DATLIDZ, AIZV_DATNO, AIZV_PIEZIMES&filter=ABS_STATUS ne 3&orderby=ABS_DAT_FROM desc&NO_DAT=2024-06-01&LIDZ_DAT=2024-06-15     DOKT_ID,DOKT_KODS,DOKT_NOSAUK - prombūtnes dokumenta pamatveids, dokmenta tipa kods, nosaukums; ERS_PK_PERS,ERS_FNAME,ERS_LNAME - prombūtnē esošā darbinieka personas kartītes PK (identifikators), vārds, uzvārds; PSADM_NOSAUK,PSAMA_NOSAUK - prombūtnē esošā darbinieka pamatslodzes struktūrvienība, amats; ABS_STATUS - prombūtnes statuss (Sagatave - 3; Ieplānota - 2; Apstiprināta - 1; Sākusies - 0) ABS_DAT_FROM,ABS_DAT_TO - prombūtnes sākuma un beigu datums; AISL_PK_PERS,AISLP_TNUM,AISLP_FNAME,AISLP_LNAME,AIZV_DATLIDZ, AIZV_DATNO, AIZV_PIEZIMES - ziņas par aizvietotāju - PK(identifikators), tabeles numurs, vārds, uzvārds, aizvietošanas periods no/līdz.   Filtra nosacījums "ABS_STATUS ne 3" - neatlasīt tās prombūtnes, kas ir statusā "Sagatave".

Datu sinhronizācijas mehānisms ir paredzēts darbam ar Horizon klasifikatoriem, lai saņemtu informāciju par tajos veiktajām izmaiņām. Sinhronizācija darbojas pēc šādas shēmas: ar GET pieprasījumu uz kādu no apakšresursiem, piemēram, changed nolasa datus; izpilda POST pieprasījumu uz to pašu apakšresursu, fiksējot saņemtās vērtības. Klasifikatori Horizon pusē ir, piemēram, klientu saraksts (TDdmKlPamatDat), nomenklatūru saraksts (TNdmNomSar), realizācijas rēķinu saraksts (TNdmRekSar) utt. Tiklīdz tiek veiktas izmaiņas kādam klasifikatora ierakstam, piemēram, nomenklatūrai mainās nosaukums, klienta kartītē tiek ierakstīts e-pasts, rēķinam tiek piesaistīts maksājums, šim ierakstam datubāzē tiek palielināta counter vērtība, attiecīgi sync pēc šīm vērtībām saprot, kuri ieraksti ir mainīti. Uzreiz jāpiemin, ka ne visas veiktās darbības klasifikatora ierakstam maina counter vērtību, kā piemēram, nomenklatūru atlikumu izmaiņas - tās nav izmaiņas nomenklatūras kartītē, bet gan tās atlikumos, kas tiek saglabāti citā tabulā. Nomenklatūru atlikumu atskaite (TNdmNatlSL) nav klasifikators, tā ir atskaite, tajā dati tiek izsaukti no vairākām tabulām, veikti aprēķini un rezultāts attēlots lietotājam. Te sync resursi nav izmantojami, tas neatlasa datus pēc izmaiņām atlikumos, bet gan pēc izmaiņām tieši nomenklatūras kartītē.   Detalizētāks apraksts par sinhronizāciju atrodams dokumentācijā.

Visma Horizon pieejamas standartizētas integrācijas ar dažādām trešo pušu sistēmām.   Risinājuma abonēšana pieejama šādā komplektācijā:   Kods (idenitifikators) Nosaukums VHOP07_ABO Visma integrācija API ar trešajām sistēmām. Abonements uz 1 gadu. VHOP08_ABO VISMA Horizon platformas saskarne (API) Aktīvās direktorijas integrācijai. Abonements uz 1 gadu.   Lietotāja rokasgrāmata    Lietotāju apmācība un rokasgrāmata tiek izveidota projekta laikā.   Instalācijas instrukcija   Instalāciju veic ieviešanas projekta laikā Visma speciālisti.   Programmatūras tehniskais apraksts    ŠEIT ir pieejams risinājuma funkcionālais un tehniskais apraksts.   Ražotājs   Visma Enterprise SIA

Šajā rakstā pieejams dokuments par to, kas jāzina, lai veiktu sistēmu integrāciju, izmantojot REST.

Ja dati par jauniem darbiniekiem primāri tiek ievadīti, piemēram, personāla atlases sistēmā, dokumentu pārvaldības sistēmā vai kādā citā uzņēmumā izmantotā datu bāzē, tad, lai nepārvadītu darbinieka datus manuāli, iespējams izveidot jaunu darbinieka kartīti Horizon, izmantojot Rest.   Šeit apskatīta darbinieka kartītes izveide Horizon sarakstā Pamatdati -> Personāla uzskaite -> Personu kartītes.   Pievienojot jaunu personas kartīti, obligāti jānorāda, ar kuru dokumenta tipu tā tiks veidota. Horizon var būt izveidoti vairāki personas kartīšu dokumentu tipi, piemēram, rezidentiem (ar personas koda pārbaudi) un nerezidentiem. Personu kartīšu dokumentu tipu sarakstu var iegūt:       GET ../rest/TdmDarbBaseBL/template       POST vaicājuma piemērs personas kartītes izveidei ar minimālo obligāti aizpildāmo informācijas apjomu:       POST .../rest/TdmDarbBaseBL/template/{pk} <resource> <entity> <PK_DOKT> <href>/rest/TdmDocType/{pk}</href> </PK_DOKT> <PAMV_ID>6010</PAMV_ID> <TNUM>0000</TNUM> <FNAME>Vārds</FNAME> <LNAME>Uzvārds</LNAME> <PERS_KODS>000000-00000</PERS_KODS> <DZIM_DAT>YYYY-MM-DD</DZIM_DAT> <DZIMUMS>1</DZIMUMS> <STATUSS>0</STATUSS> <PK_VALSTS> <href>/rest/TdmBLDValsts/1</href> </PK_VALSTS> <admPerBaseBL> <row> <SPEKA_NO>YYYY-MM-DD</SPEKA_NO> <DOCOPYADR>0</DOCOPYADR> </row> </admPerBaseBL> <pudmBildeBL> <row> <BILDE> <data></data> </BILDE> </row> </pudmBildeBL> </entity> </resource>       {pk} -  Vajadzīgā personas kartītes dokumenta tipa primārā atslēga; DZIMUMS - Sieviete='1', Vīrietis='2'; STATUSS - Sagatave='0', Apstiprināts='1'; TdmBLDValsts/{pk} rezidences valsts no valstu saraksta Horizon (Pamatdati -> Uzņēmums -> Valsts); TNUM - tabeles (kartītes) numurs - var nebūt, ja Horizon ir izveidots automātisks numerators; BILDE - personas fotoattēla dati base64 kodējumā.  

Dažādām ar personāla vadību saistītām integrācijām ir nepieciešams no Horizon sistēmas izgūt datus par darbiniekiem. Piemēram, ārpus Horizon tiek uzturēta darbinieku kontaktu grāmata, tiek ģenerētas obligāto veselības pārbaužu kartes vai drukātas darba apliecības. Lai to izdarītu, nepieciešami darbinieku dati, tādi kā pamatinformācija, kontaktinformācija, amats utml.   Vispirms jāsaprot, cik daudz, kādi tieši un cik detalizēti dati būs nepieciešami.    Horizon sistēmā darbinieka dati tiek uzkrāti vairākos sarakstos ar atšķirīgu detalizāciju un datu apjomu. Atkarībā no tā, kādus datus nepieciešams izgūt, var izmantot šādus sarakstus:   1. Personu kartītes Pamatdati -> Personāla uzskaite -> Personu kartītes Sarakstā atrodami darbinieka pamatdati, piemēram, tabeles (kartītes) numurs, vārds, uzvārds, personas kods, dzimums, kontaktinformācija, adrese, kā arī ar darbinieku saistīti dati, piemēram, identifikācijas, izglītības dokumenti u.c. No šī saraksta iespējams izgūt arī informāciju par darbinieka vienām galvenajām tiesiskajām attiecībām un šo tiesisko attiecību pamata amata datiem.   PIEMĒRI:         1. Šobrīd aktīvo darbinieku kontaktinformācija ar pamata amatu un struktūrvienību: GET .../rest/TdmDArbSar/query?CRITERIA=AKTIVIE&columns=ERS_PK_PERS,ERS_TNUM,ERS_FNAME,ERS_LNAME,ERS_PERS_KODS,ERS_DZIMUMS,ERS_EPASTS,ERS_TELEFONS,PSADM_NOSAUK,PSAMA_NOSAUK CRITERIA=AKTIVIE - atlasīt tikai darbiniekus ar spēkā esošām tiesiskajām attiecībām. ERS_PK_PERS - personas kartītes sistēmas ID (primārā atslēga); ERS_TNUM - personas kartīties (tabeles) numurs; ERS_FNAME,ERS_LNAME - vārds, uzvārds; ERS_PERS_KODS - personas kods; ERS_DZIMUMS - dzimums (sieviete="1", vīrietis="2") ERS_EPASTS - darba e-pasts; ERS_TELEFONS - darba telefons; PSADM_NOSAUK - administratīvā struktūrvienība (pamatslodzes); PSAMA_NOSAUK - amata nosaukums (pamatslodzes).         2. Šādu vaicājumu var papildināt ar vēl citiem laukiem un filtriem, piemēram, atlasīt tikai tos darbiniekus, kuriem tiesiskajās attiecībās Ienākuma veids ir darba alga (rezidenti un nerezidenti): GET .../rest/TdmDArbSar/query=AKTIVIE&columns=ERS_PK_PERS,ERS_TNUM,ERS_FNAME,ERS_LNAME,ERS_EPASTS,ERS_TELEFONS,PSADM_NOSAUK,PSAMA_NOSAUK,LAT_PK_LIGA,LAT_NUMURS,LAT_SAK_DAT,LAT_BEIG_DAT,IEN_KODS&filter=inlist(IEN_KODS, '1001', '15', '1066') inlist(IEN_KODS, '1001', '15', '1066') - ienākumu veids ir VIENS NO norādītajām vērtībām.   LAT_PK_LIGA - tiesisko attiecību sistēmas ID (primārā atslēga); LAT_NUMURS - tiesisko attiecību numurs; LAT_SAK_DAT,LAT_BEIG_DAT - tiesisko attiecību no/līdz datumi; IEN_KODS - ienākumu veida kods.       3. Kā izgūt darbinieka fotoattēlu?  Ja pie darbinieka kartītes pievienota fotogrāfija, to iespējams izgūt, piemēram, base64 kodējumā. Jāveido pieprasījums personas kartītei (entītes ierakstam), iekļaujot šādu parametru: GET ...rest/TdmDarbBaseBL/{pk}?bindata=embed {pk} - personas kartītes sistēmas ID (primārā atslēga) Pieprasījuma atbildē tiks atgriezts bināro lauku saturs base64 kodējumā.   2. Darbinieku tiesisko attiecību dati Pamatdati -> Personāla uzskaite -> Tiesiskās attiecības Sarakstā apkopota informācija par visām darbinieka tiesiskajām attiecībām - darba, uzņēmuma, autoratlīdzības u.c. līgumiem. Sarakstā iespējams izgūt, piemēram, līgumu numurus, veidus, sākuma, beigu datumus, ziņas par pārbaudes laiku, ja tāds noteikts utml. Šo sarakstu var izmantot, ja ar vienu darbinieku vienlaikus ir noslēgts vairāk par vienu darba/uzņēmuma līgumu. Sarakstā nebūs redzami darbinieki, kuriem nav spēkā nevienas tiesiskās attiecības. Šajā sarakstā var izgūt arī darbinieka pamatdatus, kontaktinformāciju u.c. datus no personas kartītes, kā arī ziņas par katra darba līguma pamatslodzi (amata nosaukums, profesija, administratīvā struktūrvienība, atalgojums utml.).   PIEMĒRS: GET ...rest/TdmLigAttSar/query?CRITERIA=AKTIVIE&columns=ERS_TNUM,ERS_FNAME,ERS_LNAME,ERS_PERS_KODS,LAT_PK_LIGA,LAT_NUMURS,LAT_SAK_DAT,LAT_BEIG_DAT,LAT_PARB_BEIG,IEN_KODS,PSADM_NOSAUK,PSAMA_NOSAUK   CRITERIA=AKTIVIE - atlasīt tikai spēkā esošas tiesiskās attiecības.   ERS_TNUM - personas kartīties (tabeles) numurs; ERS_FNAME,ERS_LNAME - vārds, uzvārds; ERS_PERS_KODS - personas kods; LAT_PK_LIGA - tiesisko attiecību sistēmas ID (primārā atslēga); LAT_NUMURS - tiesisko attiecību numurs; LAT_SAK_DAT,LAT_BEIG_DAT - tiesisko attiecību sākuma, beigu datums; IEN_KODS - ienākumu veida kods; PSADM_NOSAUK - administratīvā struktūrvienība (pamatslodzes); PSAMA_NOSAUK - amata nosaukums (pamatslodzes).   3. Darbinieku amatu dati (slodzes) Pamatdati -> Personāla uzskaite -> Personu amatu dati Sarakstā apkopota informācija par darbinieka visu tiesisko attiecību visiem amatu datiem - pamatslodzēm un papildslodzēm, ja tādas ir - amatu nosaukumi, profesijas, administratīvās struktūrvienības, atalgojums utt. Šo sarakstu izmanto, ja nepieciešama detalizēta informācija par visām darbinieka slodzēm, piemēram, ja darbinieks strādā vienlaikus vairākos amatos, struktūrvienībās. Sarakstā iespējams izgūt arī datus no darbinieka personas kartītes (pamatdatus, kontaktinformāciju u.c.), kā arī datus par katras slodzes tiesiskajām attiecībām (līguma numuru, sākuma, beigu datumus u.c.). Sarakstā nebūs redzami darbinieki, kuriem nav spēkā esošu amata datu.    PIEMĒRS: GET ...rest/TadmSlSar/query?CRITERIA=CRIT_LAT_AKTIVIE&columns=ERS_TNUM,ERS_FNAME,ERS_LNAME,LAT_NUMURS,PK_SLODZE,DOK_NR,SAK_DAT,BEIG_DAT,PK_APMAKSA,SUMMA,STR_NOSAUK,VAM_NOSAUK,SL_TIPS   CRITERIA=CRIT_LAT_AKTIVIE - darbiniekam ir vismaz vienas spēkā esošas tiesiskās attiecības.   ERS_TNUM - personas kartīties (tabeles) numurs; ERS_FNAME,ERS_LNAME - vārds, uzvārds; LAT_NUMURS - tiesisko attiecību numurs; PK_SLODZE - personas amata datu sistēmas ID (primārā atslēga); DOK_NR - personas amata datu numurs; SAK_DAT,BEIG_DAT - personas amata dati "no"/"līdz"; PK_APMAKSA - apmaksas veids:            Alga proporcionāli dienām = 1            Stundas tarifa likme = 2            Gabaldarbs = 3            Dienas apmaksa = 4            Alga proporcionāli stundām = 5 SUMMA - likme (atalgojuma likme); STR_NOSAUK - struktūrvienības nosaukums; VAM_NOSAUK - amata nosaukums; SL_TIPS - slodzes tips (pamatslodze = 1; papildslodze = 2)   4. Atskaites Darbinieki periodā un Personu amatu dati periodā Atskaites -> Personāla uzskaite -> Statistika -> Darbinieki periodā Atskaites -> Personāla uzskaite -> Statistika -> Personu amatu dati periodā   No šīm atskaitēm izgūstama tā pati informācija, kas no personu kartīšu un amatu datu sarakstiem. Atšķirība ir tajā, ka atskaitei jānorāda periods, par kuru vēlamies redzēt datus, tādēļ no atskaitēm būs iespējams izgūt vēsturiskos datus, piemēram, par darbinieku skaitu, amatiem pirms gada utml.    PIEMĒRI: GET ...rest/TdmDArbSar2/query?NO_DAT=2022-11-01&LIDZ_DAT=2022-11-30&columns=ERS_TNUM,ERS_FNAME,ERS_LNAME,ERS_PERS_KODS,ERS_DZIMUMS,IEN_KODS,LAT_NUMURS,LAT_SAK_DAT,LAT_BEIG_DAT,PSADM_NOSAUK,PSAMA_NOSAUK GET ...rest/TadmSlSar2/query?NO_DAT=2022-11-01&LIDZ_DAT=2022-11-30&columns=ARD_TNUM,ERS_FNAME,ERS_LNAME,ERS_PERS_KODS,ERS_DZIMUMS,LAT_NUMURS,LAT_SAK_DAT,LAT_BEIG_DAT,SLODZE,DOK_NR,SAK_DAT,BEIG_DAT,SUMMA,STR_NOSAUK,VAM_NOSAUK