Workofo integracija

Apžvalga

Workofo – tai darbo grafikų planavimo ir darbo laiko apskaitos sistema. Integracija tarp Workofo ir Softera.Payroll leidžia automatiškai perkelti darbuotojų darbo grafiko (faktiškai dirbto laiko pagal veiklos kodus) duomenis iš Workofo į Softera.Payroll sistemą, todėl darbo grafiko nereikia vesti rankiniu būdu.

Perkelti duomenys naudojami:

• darbuotojo darbo grafiko darbalapyje – grafikas užpildomas automatiškai pagal Workofo duomenis;

• atlyginimo skaičiavime – SDLA normos ir PI žurnalo skaičiavimuose atsižvelgiama į iš Workofo gautą faktiškai dirbtą laiką pagal veiklos kodus (AK).

Integracija sumažina rankinio darbo apimtį, klaidų tikimybę ir užtikrina, kad atlyginimas būtų skaičiuojamas pagal realiai dirbtą laiką.

Kaip veikia duomenų atsisiuntimas

Duomenys iš Workofo atsiunčiami asinchroniniu (POLL) būdu:

1. Softera.Payroll siunčia POST užklausą Workofo sistemai, inicijuodama ataskaitos formavimą pasirinktam laikotarpiui;

2. sistema periodiškai siunčia GET užklausą į gautą Poll URL, tikrindama, ar ataskaita jau suformuota;

3. kai ataskaita paruošta, GET užklausa į Download URL atsiunčia ją JSON formatu;

4. gauti duomenys įrašomi į tarpines (staging) lenteles:

• SPR INT Empl. Prd. W.Schedule – grupavimas pagal darbuotoją ir laikotarpį (Workofo atveju – 1 mėnuo), rodo grupės būseną ir rezultatą;

• SPR INT Empl. Prd. W.Sched. Entry – detalūs grupės įrašai.

Rekomenduojama duomenis iš Workofo atsisiųsti kelis kartus per mėnesį, pvz.:

• prieš prasidedant mėnesiui (preliminarus grafikas);

• mėnesio eigoje (patikslinimai);

• pasibaigus mėnesiui (galutiniai faktiniai duomenys atlyginimo skaičiavimui);

• papildomai – darbuotojo atleidimo dieną.

Įjungti Workofo integraciją

1. Darbuotojų portalas ⇾ Darbuotojų portalo nustatymai ⇾ Workofo - įjungti nustatymą “Rodyti Workofo integraciją”.

Įjungus, žemiau atsiranda daugiau nustatymų, kuriuos reikia nustatyti:

2. Taip pat reikia nustatyti Endpoint parametrus:

3. Darbuotojų portalas ⇾ Integ. autentif. nustatymai - parinkite Workofo kortelę ir nustatykite:

4. Darbuotojų portalas ⇾ Integracijų procesai ⇾ Integracijos partnerio filtras - parinkite vertę Workofo, paspauskite ant eilutės, kur kodas WORKOFO, atidarys integracijos proceso kortelę. Kortelėje reikia nustatyti:

• Bendra ⇾ Įjungta - nustatyti, jog integracija įjungta;

• Siuntimo nustatymai⇾ API autentifikavimo nustatymai - nustatyti, kokiu autentifikavimo metodu, bus jungiamasi, pvz.: Workofo.

5. Darbuotojų portalas ⇾ Integracijų verčių ryšiai - nustatykite, koks Workofo veiklos ar neatvykimo kodas atitinka kokį Softera.Payroll aktyvumo kodą (AK). Lentelėje taip pat galima nurodyti “Praleisti“, kuriuos iš gautų Workofo kodų sistema turi ignoruoti. Jei Darbuotojų portalo nustatymuose ⇾ Workofo ⇾ Importuoti dimensijas - įjungtas nustatymas, tuomet importuojamas dimensijas, taip pat aprašome šioje lentelėje kokia Workofo dimensija atitinka Softera.Payroll dimensiją.

   Kai Workofo pusėje atsiranda naujas, dar nesusietas veiklos kodas, sistema automatiškai sukuria naują mapinimo eilutę Integracijų verčių ryšių lentelėje, tačiau reikalauja, kad vartotojas rankiniu būdu priskirtų atitinkamą BC aktyvumo kodą “BC vertė“ (ir pažymėtų, ar tai laikoma faktiškai dirbtu laiku). Kol nauja eilutė nepatvirtinta, grafiko pildymo veiksmas baigsis klaida.

Jei veiklos kodas yra nefaktiškai dirbtas laikas BC aktyvumo kodo kortelė (pvz.: Darbas naktį (DN) integracijų verčių ryšių lentelėje turi būti aprašyta du kartus, jog vieną kartą laikas importuojamas į DD (Darbas dieną) BC aktyvumo kodą ir dar kartą tas pats laikas importuojamas į DN (Darbas naktį) kodą, pvz. žemiau:

6. Darbo laikas ⇾ Nustatymai ⇾ Grafiko formulė - sukurkite Workofo integracijai naudojamą grafiko formulę ir parinkite nustatymą Grafiką pildyti pagal = Integracijos duomenys. Darbuotojams, kurių laikas bus integruojamas iš Workofo turi būti priskirta Workofo grafiko formulė.

Darbuotojų grafiko pildymas pagal Workofo duomenis

1. Nueikite į Darbuotojų grafikų darbalapį

2. Nustatykite filtrų srityje Datos filtras ir jei norite Darbuotojo Nr., vardo, pavardės filtras

3. Paspauskite mygtuką Workofo API užklausa - sistema išsiųs užklausą į Workofo ataskaitos užsakymui su nurodytais filtrais

4. Paspauskite Pildyti - sistema užpildys grafiką pagal Workofo duomenis.

Workofo API užklausos saugomos Workofo API žurnale. Žurnalas pasiekiamas suvedus pavadinimą paieškoje arba paspaudus Integracijų procesai ⇾ Workofo proceso eilutėje ⇾ Tarpinės lentelės antraštė stulpelyje ant pavadinimo Workofo API žurnalas SPR. Kiekvienas įrašas turi būseną:

Paleisti darbų eilę automatiniam duomenų parsiuntimui ir pildymui

Darbų eilės įrašai - įjunkite darbų eilę 71462399 SPR Workofo Poll Job, kuri inicijuos duomenų parsiuntimą.

Dažniausiai pasitaikančios klaidos

• Klaida 404, integracija su Workofo neveikia – dažniausiai reiškia sutrikusį ryšį su Workofo API arba pasikeitusius prisijungimo duomenis/aplinkos parametrus. Kreipkitės į Softera pagalbos komandą, nurodydami klaidos laiką ir darbuotojo/laikotarpio duomenis.

• „Neturite teisės kurti arba vykdyti suplanuotas užduotis“ – integracijos vartotojui trūksta teisių rinkinio, susijusio su darbų eilės (Job Queue) valdymu. Sprendimas – priskirti reikiamą teisių rinkinį vartotojui, kuris vykdo Workofo duomenų atsisiuntimą.

• Klaida pildant grafiką dėl naujo aktyvumo kodo – Workofo pusėje atsirado naujas neatvykimo kodas, kuris dar nesusietas su BC aktyvumo kodu. Atidarykite aktyvumo kodų mapinimo lentelę, priskirkite trūkstamą BC vertę ir pakartokite veiksmą.

• Vartotojas neturi teisių paleisti foninės užduoties, kuri leidžia automatiškai persisiųsti duomenis. Po kurio laiko galite rankiniu būdu persisiųsti duomenis per Workofo API žurnalas SPR puslapį. - vartotojui trūksta teisių rinkinio, susijusio su darbų eilės (Job Queue) valdymu. Sprendimas - Workofo API žurnalas SPR puslapyje rankiniu būdu vartotojui paspausti funkcijos mygtuką Vykdyti įrašus, duomenys parsisiųs iš Workofo.