Resurshantering Imprt av frånvar externa system Lgica HRM TRV 70-1.0 Öppen 08/01/2014 1 (11)
1 Innehållsförteckning 1 Innehållsförteckning 2 2 Dkument infrmatin 3 2.1 Revisinshistria 3 2.2 Intressenter 3 2.3 Underlag 3 2.4 Bakgrund 3 3 4 3.1 Krav från kund 4 3.1.1 Prcesser 4 3.1.2 Frånvarhantering 5 3.1.3 Krav på indata från Previa 6 3.2 Avgränsningar 11 3.3 Utestående frågr / prblem 11 Imprt frånvar externa system 1.0 Öppen 08/01/2014 2 (11)
2 Dkument infrmatin 2.1 Revisinshistria Versin Datum Sign Beskrivning 1.0 2012-12-12 Mpi Skapad 1.1 2013-01-22 JAS Inspekterad 1.2 2013-02-19 MPi Uppdaterat efter kundmöte (styrbart m frv autmatiskt ska fastställas, möjlighet att skicka in uppdaterade preliminära friskdatum i XML-fil) 2.2 Intressenter Beställare/Kravställare: KSD Kravställare: Herma 2.3 Underlag 2.4 Bakgrund Beskrivning av generell imprt av frånvar från externa system via XML Imprt frånvar externa system 1.0 Öppen 08/01/2014 3 (11)
3 Ny batch sm tar imprt-fil ch hanterar imprt av frånvar ch fastställande. 3.1 Krav från kund Central administratin av frånvar nu avseende manuell inmatning av data från tex Previa ch den centrala administratinen ska behållas även m imprt sker autmatiskt från externt system. Frånvar ska fastställas vid imprt Resultat från imprt (vilka frånvar sm imprterades, fastställdes ch har felsignaler) ska skapas vid batchkörning. 3.1.1 Prcesser Nya prcesser kmmer att användas ch är ett krav. Med hjälp av aktuell frånvartyp sm behandlas (tillsammans med rätt villkrstyp i nästa punkt), indatan (persnuppgifter) från XML ch persnens anställningsrad på frånvarns fm-datum ska rätt prcess väljas utifrån rganisatin, kategri, datum, rll. Prcesser markeras med villkr för att rätt prcess ska användas. Detta görs sm nya villkrstyper. ExternImprtFrånvarXxx (Xxx kmmer att vara SjukPartiell, Sjuk, VABPartiell eller VAB samt FriskAnmälan). Så fem lika villkrstyper sm sätts på de prcesser sm ska hantera lika fall från imprten. Nya prcesser måste sätts upp sm täcker de lika typerna av händelser (eller att man markerar existerande prcesser med de nya villkrstyperna). Minst en för sjukfrånvar ch en för vab samt för partiell sjuk ch partiell vab ch en för friskanmälan. De prcesserna markeras enligt föregående punkt ifall de är sjuk, friskanmälan sv från externt system. Inställningar i prcessregelverket för t.ex. standardlöneart blir det sm sätts på frånvarpsten vid imprt. Initierare av ärende sm skapas sätts sm parameter till batchkörning (persnref) ch alla ärende sm inte autmatiskt kan hanteras (pga felsignaler) hamnar på den persnens ärende. Imprt frånvar externa system 1.0 Öppen 08/01/2014 4 (11)
Ärende kan generellt sökas ut centralt för att fånga upp alla sm kmmer från externa system (söks på de nya villkrstyperna i ärendesökningsvyn). 3.1.2 Frånvarhantering Vid imprt kntrlleras att frånvarärende (fastställd eller pågående) med unik nyckel från externt system inte redan finns. Iså fall ges varning i resultatfiler ch pst hppas över. Frånvar beräknas ch fastställs vid imprt Del av dag blir två ärenden. Dels den delen sm initialt avser del av dag ch dels de heldagar sm följer på efterföljande kalenderdatum. Om starttidpunkt i frånvar i XML-fil är samma sm fmtidpunkt på första passet (det första passet med tillhördatum på frånvarns fmdatum) anses frånvarn vara heldagsfrånvar. Signaler från beräkning/fastställ hanteras via resultatfiler från batchen. Preliminärt friskdatum kmmer från extern system ch blir underlag för bevakningsdatum på frånvarpst. Friskanmälan uppdaterar frånvar ch sätter Tm samt beräknar ch fastställer m Bevakningsdatum blankas ut när friskanmälan behandlas. Partiell frånvar läggs upp sm pågående ärende till persn enligt ansvar/funktin utifrån persn sm ska ha partiell frånvar. Pster i XML sm är av typen uppdatering av preliminära friskdatum sätter m bevakningsdatum på frånvar. När frånvar sparas i Herma knyts den till en unik identifiering från externt system så att t.ex. friskanmälan i senare imprt kan appliceras mt rätt frånvar. 3.1.3 Batchprgram Inparametrar är inifil, användare, lösenrd, persnref sm ärende sm ej kunde behandlas hamnar på, styrning m frånvar ska fastställas autmatiskt (eller bara hamna sm pågående ärende hs handläggare), sökvägar till resultatfiler, sökväg ch namn på xml-fil sm ska imprteras. Imprt frånvar externa system 1.0 Öppen 08/01/2014 5 (11)
De resultatfiler sm skapas (ch sm är tvingande att ange sökväg/filnamn för) är: Fil vilka frånvar sm imprterats (fm, tm, löneart, prcess sm använts) ch lyckats genmföra beräkning/fastställ (eventuella signaler vid beräkning/fastställ listas även per frånvar). Om man angett prcesser manuellt via inparametrar visas de först i resultatfilen (vilka prcesser sm använts för viss frånvartyp). Fil vilka frånvar sm misslyckats att imprteras. De fall sm imprt kan misslyckas för är att prcess ej hittas, beräkning misslyckas, frånvar redan imprterad, fastställande misslyckas eller att rätt persn (IDNR) ej hittats. Fil vilka friskanmälningar sm imprterats Fil vilka friskanmälningar sm misslyckats vid imprt Fil vilka uppdaterade preliminära slutdatum sm lyckats i behandling Fil vilka uppdaterade preliminära slutdatum sm misslyckats i behandling Resultatfiler listas i persnnummerrdning ch under varje persn de frånvarpster/friskanmälan i datumrdning (på fmdatum på frånvar) sm behandlats ch för varje frånvar eventuella signaler/meddelande. Valfria inparametrar sm gör att man för lika ärendetyper (sjuk, vab, friskanmälan sv) kan ange referens till prcess manuellt (man slår då ut den autmatiska uppletningen på persn ch villkrstyp vilken prcess sm ska användas). Operatin i driftsrutinen läggs upp så att batchen kan köras t.ex. varje natt. 3.1.4 Krav på indata från externt system Headerdata i metainfrmatinen sm krävs är: FileCreatinDate Vilketdatum XML-filen skapades FileCreatinTime Vilken tidpunkt XML-filen skapades FileSupplier Imprt frånvar externa system 1.0 Öppen 08/01/2014 6 (11)
Den leverantör sm skapade filen Data sm krävs för att skapa en frånvarhändelse i Herma är: AbsenceType Vilken typ av frånvarhändelse avses 0, 1 0 = Sjukfrånvar 1 = Vård av barn AbsenceKey Unik identifiering på frånvarhändelse. Sträng max 30 tecken. Används för att knyta tex friskanmälan till viss frånvarhändelse. Kan bestå av siffrr eller bkstäver, bara den är unik per frånvarhändelse ch samma nyckel används vid senare friskanmälning mt en frånvarhändelse. PersnKey Persnnummer i frmen YYMMDD-XXXX ChildKey Om AbsenceType är vård av barn anges barnets persnnummer i frmen YYMMDD- XXXX. Annars blank StartDate Startdatum för frånvarhändelse i frmen YYYY-MM-DD StartTime Starttidpunkt för frånvarhändelse i frmen HH:MM. EndDate Slutdatum för frånvarhändelse i frmen YYYY-MM-DD (blankt m känt) PreliminaryEndDate Preliminärt infrisknandedatum i frmen YYYY-MM-DD (blir underlag till bevakningsdatum m satt). Om EndDate sätts är denna blank. PartialAbsence Partiell (inte del av dag utan reducering av syssgrad) frånvar avses. 0 eller 1 0 = Inte partiell 1 = partiell PartialAbsenceExtent Omfattning på partiell frånvar. Anges sm relativt värde. Tex m 50.0% partiell ch anställd till 75.0% så anges 50.0% ch inte 37.5%. Sätts till blank m inte partiell. Data sm krävs för en friskanmälan Imprt frånvar externa system 1.0 Öppen 08/01/2014 7 (11)
AbsenceKey Unik identifiering på frånvarhändelse. Sträng max 30 tecken. Används för att knyta t.ex. friskanmälan i senare imprter till viss frånvarhändelse. PersnKey Persnnummer i frmen YYMMDD-XXXX EndDate Slutdatum för frånvarhändelse i frmen YYYY-MM-DD. Data sm krävs för uppdatering av preliminärt tmdatum på frånvar AbsenceKey Unik identifiering på frånvarhändelse. Sträng max 30 tecken. Används för att knyta t.ex. friskanmälan i senare imprter till viss frånvarhändelse. UpdatedPreliminaryEndDate Uppdaterat slutdatum för frånvarhändelse i frmen YYYY-MM-DD. Imprt frånvar externa system 1.0 Öppen 08/01/2014 8 (11)
Filutseende exempel: <MetaInfrmatin> <FileCreatinDate>2012-11-01</FileCreatinDate> <FileCreatinTime>12:45</FileCreatinTime> <FileSupplier>Previa</FileSupplier> </MetaInfrmatin> <AbsenceList> <Absence> <AbsenceType>0</AbsenceType> <AbsenceKey>584673856</AbsenceKey> <PersnKey>121212-1212</PersnKey> <ChildKey></ChildKey> <StartDate>2012-11-01</StartDate> <StartTime>08:00</StartTime> <EndDate></EndDate> <PreliminaryEndDate>2012-11-10</PreliminaryEndDate> <PartialAbsence>0</PartialAbsence> <PartialAbsenceExtent></PartialAbsenceExtent> </Absence> <Absence> <AbsenceType>1</AbsenceType> <AbsenceKey>584673857</AbsenceKey> <PersnKey>121212-1213</PersnKey> <ChildKey>010101-0101</ChildKey> <StartDate>2012-11-05</StartDate> <StartTime>08:00</StartTime> <EndDate></EndDate> <PreliminaryEndDate>2012-11-10</PreliminaryEndDate> <PartialAbsence>0</PartialAbsence> <PartialAbsenceExtent></PartialAbsenceExtent> </Absence> <Absence> <AbsenceType>0</AbsenceType> <AbsenceKey>584673858</AbsenceKey> <PersnKey>121212-1213</PersnKey> <ChildKey></ChildKey> <StartDate>2012-11-05</StartDate> <StartTime>08:00</StartTime> <EndDate></EndDate> <PreliminaryEndDate>2012-11-10</PreliminaryEndDate> <PartialAbsence>1</PartialAbsence> Imprt frånvar externa system 1.0 Öppen 08/01/2014 9 (11)
<PartialAbsenceExtent>50.0</PartialAbsenceExtent> </Absence> </AbsenceList> <AbsenceEndedList> <AbsenceEnded> <AbsenceKey>584673834</AbsenceKey> <PersnKey>121212-1217</PersnKey> <EndDate>2012-12-20</EndDate> </AbsenceEnded> </AbsenceEndedList> <UpdatedPreliminaryEndDateList> <UpdatedPrelinimaryEndDate> <AbsenceKey>584673845</AbsenceKey> <UpdatedPreliminaryEndDate>2013-05-20</EndDate> </UpdatedPrelinimaryEndDate > </UpdatedPreliminaryEndDateList > Imprt frånvar externa system 1.0 Öppen 08/01/2014 10 (11)
3.1.5 Persnidentifiering Först undersöks m det finns en extrauppgift kpplat till aktuellt persnnummer ch aktuell frånvarns fm-datum. Persnnummer från Previa ch extrauppgift 1300 ( Huvudidentitet för PAR 19 ) i KP.EXTRAUPPGIFTER ger IDNR till persnen. Finns ingen extrauppgift hämtas unika IDNR ut från anställningspster (sm ej är brttagna) för aktuellt persnnummer ch frånvarns fm-datum. Detta kan ge nll till många IDNR (i princip). Om ett IDNR hittas används det annars signaleras antingen att inget IDNR hittas eller att flera IDNR hittas för persnnummer ch datum. 3.2 Databasändringar Ny tabell EXTERN.FRV_IMP_KOPPLING där det externa systemets id på en frånvarhändelse matchas mt det id Herma använder för en frånvarhändelse. Klumner sm ska finnas (identifierade då lösning skrev, kan förändras): FRANVARO_REF Unik referens till frånvarpst. ABSENCE_KEY Den unika nyckel sm externt system använder för att identifiera frånvar. IMPORT_TIDP_HEROMA Den tidpunkt sm frånvar imprterades till Herma. IMPORT_TIDP_FILE Den tidpunkt sm imprtfilen skapades (tas från XMLfilen). IMPORT_SUPPLIER Den leverantör sm frånvarn härstammade från (tas från XML-filen. 3.3 Avgränsningar Lösningen är just nu skriven sm en batchkörning där frånvar imprteras via XML-fil. Standardlöneart på prcess sm ska användas för partiell frånvar skall vara inställd att vara relativ mfattning sm den mfattning sm registreras. Brttag av frånvar sker via nrmal ärendehantering i Herma. 3.4 Utestående frågr / prblem Imprt frånvar externa system 1.0 Öppen 08/01/2014 11 (11)