FGS Personal Förvaltningsgemensam specifikation (FGS) för leveranstypen Personal
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 1(38) INNEHÅLLSFÖRTECKNING 1. INLEDNING...3 1.1 LÄSANVISNING...3 1.2 MÅLGRUPP...3 1.3 LEVERABLER...3 1.4 REFERENSER...4 1.5 KONVENTIONER...4 2. ÖVERSIKT...5 2.1 TERMER...5 2.2 OMFATTNING OCH AVGRÄNSNINGAR...5 2.2.1 FGS Personal avser uttag och leverans av leveranstypen Personal...5 2.3 MAPPNING MELLAN VERKSAMHETSSYSTEM OCH LEVERANSSPECIFIKATION...6 3. XML-SPECIFIKATION...7 4. BESKRIVNING AV ELEMENT LEVERANSOBJEKT...9 4.1 BESKRIVNING AV ARKIVBILDARSTRUKTUR OCH ARKIVBILDARE...11 4.1.1 Beskrivning av Arkivbildare...11 4.2 VERKSAMHETSBASERAD ARKIVREDOVISNING...12 5. BESKRIVNING AV ARKIVOBJEKTLISTA OCH ARKIVOBJEKT...14 5.1 ARKIVOBJEKT: PERSON...14 5.2 ARKIVOBJEKT: ANSTALLNING...19 5.3 BESKRIVNING AV ÅTERKOMMANDE TYPE-ELEMENT...30 5.3.1 DatumType...30 5.3.2 Tillkommande XMLdata...30 5.3.3 Innehall...31 5.3.4 Beskrivning av Data...31 5.3.4.1 Elementen SchemaURI och Data...32 5.3.5 Beskrivning av Type Bilaga...33 5.3.6 Beskrivningar av element Referens...35 6. RAPPORT OCH SAMMANSTÄLLNING...36 7. BESKRIVNING AV TILLÅTNA FORMAT...37 8. PAKETERING AV LEVERANSER...38
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 2(38) ÄNDRINGSLOGG Version Datum Namn Beskrivning 0.1 2012-11-12 Christer Atterling FGS:iering av version 3.0 av Leveransspecifikation för Personal 0.11 2012-11-19 Christer Atterling Tillägg av tabeller med obligatoriska element och attribut. 0.12 2012-11-20 Christer Atterling Efter genomgång med R7 och SLL 0.2 2012-11-26 Karin Bredenberg Utkast för remiss inom projektet eard 1.0 2013-01-14 Karin Bredenberg Publicerad version
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 3(38) 1. INLEDNING För en utförlig beskrivning av bakgrund och utgångspunkter hänvisas till följande dokument: Delrapport DP3 FGS för leveranstypen personal Det för projektet överordnade dokumentet Översiktlig beskrivning av eard Syftet med detta dokument är att beskriva specifika krav för leveranstypen Personal vid leverans till e-arkiv. Bevarandekrav beskrivs i bevarande- och gallringsplanerna för respektive organisation. 1.1 LÄSANVISNING De anvisningar som finns gällande hur man pekar ut personal information i ett leveranspaket återfinns i FGS för paketstruktur för e-arkiv. De dataelement som definierats beskrivs i kapitel 4 BESKRIVNING AV ELEMENT LEVERANSOBJEKT och 5 BESKRIVNING AV ARKIVOBJEKTLISTA OCH ARKIVOBJEKT. I det tillhörande XML-schemat samt medföljande exempel definieras samtliga dataelement för utbytesformatet. Dessa tillhörande XML och XML-schema dokument går att nå via länkar från http://www.riksarkivet.se/e-arkiv 1.2 MÅLGRUPP Målgrupper för denna FGS är: Statliga myndigheter Kommuner och landsting Kommersiella aktörer som utvecklar och tillhandahåller produkter och tjänster för personalsystem 1.3 LEVERABLER Leverablerna för denna FGS är: Denna specifikation med bilagor XML schema
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 4(38) 1.4 REFERENSER Denna FGS är i första hand baserad på följade standarder och specifikationer: Specifikation och instruktion från Stockholms Läns Landsting (SLL) 1 Föreskrifter om ändring i Riksarkivets föreskrifter och allmänna råd (RA-FS 1991:1) om arkiv hos statliga myndigheter; beslutade den 9 december 2008, RA-FS 2008:4 2 1.5 KONVENTIONER Denna FGS följer språkbruket i Internet Engineering Task Force (IETF) Request for Comments (RFC) 2119.11. 3 1 SLL e-arkiv Leveransspecifikation Administrativa system v.2.0 2011-07-11 och SLL e-arkiv Leveransinstruktion för informationstyp Personaladministrativa system v.1.1 2012-01-09. Kontakta SLL via leveranser@la.sll.se för att erhålla kopior. 2 http://www.riksarkivet.se/ser en referens till deras utgångs materialve/rafs/filer/rafs%202008-4.pdf 3 http://www.ietf.org/rfc/rfc2119.txt
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 5(38) 2. ÖVERSIKT 2.1 TERMER I denna FSG används de termer och begrepp som definierats i den begreppslista som tagits fram inom eard-projektet. 4 2.2 OMFATTNING OCH AVGRÄNSNINGAR Denna FGS är en beskrivning av leveranstypen Personal. Denna FGS beskriver och specificerar innehåll samt struktur gällande leveranstypen Personal. Denna FGS tillsammans med FGS för paketstruktur för e-arkiv specificerar ett helt leveranspaket gällande leveranstypen Personal. Huvuddelen av specifikationen avser metadata som behövs för att kunna återsöka information och samla eller knyta ihop (aggregera) information från olika typer av personalsystem. Med personalsystem avses informationssystem där information primärt är strukturerad efter en person och dennes anställning eller anställningar. Informationen kan gälla pension, lön, frånvaro, rehabilitering med mera. Det ska vara möjligt att hitta information avseende en person och dennes anställningar oberoende av vilken produkt eller tjänst som används i verksamheten. FGS:en omfattar därför uppgifter om personal handlingar oavsett vilket personalsystem som hanterar dessa uppgifter. Denna FGS tar endast upp de uppgifter som registreras och specificerar inte de meddelanden eller dokument (fulltextfiler) som hanteras i personalsystemet. 2.2.1 FGS Personal avser uttag och leverans av leveranstypen Personal Denna FGS behandlar endast de tekniska aspekterna av att leverera personalinformation till e-arkiv. Denna FGS avser inte att definiera metoder för uttag ur ett personalsystem utan definierar metadata som levereras via ett uttag. Denna FGS definierar inte heller funktioner hos ett personalsystem, exempelvis funktioner för registrering av en person. Innan överföring av information från ett verksamhetssystem till ett e-arkiv kan ske så krävs ett förarbete i form av ett leveransprojekt och en leveransöverenskommelse. Denna FGS behandlar inte denna administrativa process eller hur informationen ska presenteras för återsökning i e-arkiv. 4 Begreppslistan går att nå via http://www.riksarkivet.se/e-arkiv
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 6(38) 2.3 Mappning mellan verksamhetssystem och leveransspecifikation I samband med en leverans från ett specifikt verksamhetssystem måste en mappning ske mellan det aktuella verksamhetssystemets dataelement och de dataelement som definierats i leveransspecifikationen för den aktuella leveranstypen. Denna mappning är ett nödvändigt steg vid leverans till ett e-arkiv. Mappningsproblematiken kommer att minska vartefter det vid nyutveckling och kravställning vid inköp och tjänster av personalsystem tas hänsyn till FGS:en. Dock kvarstår kravet att mappningen alltid behöver kontrolleras.
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 7(38) 3. XML-specifikation För att kunna validera, lagra och söka arkiverad information på ett enhetligt sätt har ett XML-schema definierats, vilket leveranser av digital information till e-arkiv skall ske enligt. Schemat är uppbyggt med hjälp av XML-schema konstruktionen att skapa återanvändningsbara typer i komplement till de typer som redan finns inom XML. En typ kan närmast beskrivas med att man samlar element och attribut och sparar dessa som en egen typ. När man skapar ett element anger man i elementet att det använder typen och elementet får då typens alla element och attribut. Ett antal av dessa typer beskrivs längre fram i detta dokument. En bild av de ingående objekten i leveranstypen. Arkivobjektet är det objekt som ska arkiveras, "Information Object" enligt OAIS 5 -standarden. Arkivobjektet har i denna specifikation för leveranstypen personal två nivåer: uppgifter om person på den övre nivån och uppgifter om anställning och inkomst på den undre nivån. Arkivobjektet har metadata (element/attribut) på båda nivåerna och kan ha innehåll (fil i arkivformat eller xml-data) på båda nivåerna. I beskrivningen av element och attribut används ett gemensamt tabellformat med följande rubriker: 5 För att information om OAIS se Delrapport DP3 FGS för paketstruktur för e-arkiv http://www.riksakrivet.se/e-arkiv
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 8(38) Förklaring till rubriker Element/attributnamn: E/A: Kard: Beskrivning: Användning: Exempel: Anger det namn som används i schemat för element eller attribut. (se WWW Consortium http://www.w3.org/) I denna kolumn anges om det beskrivna objektet är ett element eller attribut i schemat. Anger objektets kardinalitet, d v s antal möjliga förekomster. Ett och uppåt innebär obligatorium. Innehåller en beskrivning av objektets typ, datatyp, maxlängd och giltiga värden med mera Anger hur objektet skall användas. Ett exempel på värde för att tydliggöra. Även om de flesta XML parsers klarar teckenset med svenska tecken har dessa undvikits i element och attributnamn eftersom det framkommit viss osäkerhet om alla parsers hanterar dokument med teckenset innehållande svenska tecken. Ändringsloggar hanteras separat i för ändamålet avsedd teknisk lösning.
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 9(38) 4. BESKRIVNING AV ELEMENT LEVERANSOBJEKT För att det ska vara möjligt att leverera arkivobjektet krävs ett leveransobjekt som beskriver den leverans som arkivobjektet ingår i. Leveransobjekt beskriver leveransen och innehåller element och attribut enligt nedan. I Bilagor kan dokument som ingår i leveransobjektet placeras, exempelvis Mappningsdokument. Följande element/attribut är obligatoriska ArkivobjektlistaPersoner ArkivbildarStruktur E 0..1 Type Kan endast finnas en Arkivbildarstru ktur per leverans. Se 4.1 BESKRIVNING AV ARKIVBILDARST RUKTUR OCH Bilagor E 0..* Type Bilagor är på denna nivå till exempel systemredovisni g. Detta material är ej avsett för gallring. Se 5.3.5 Beskrivning av Type Bilaga ARKIVBILDARE systemredovisning, mappningsdokument etc ArkivobjektListaPersoner E 1 Type Arkivobjektlista n listar de arkivobjekt som ingår i leveransen. Arkivobjektlista kan endast innehålla Arkivobjekt. Se 5 BESKRIVNING AV ARKIVOBJEKTLIS TA OCH ARKIVOBJEKT
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 10(38) VerksamhetsbaseradArki vredovisning E 0..1 Typ Dataelement som krävs för att hänvisa till en verksamhetsbas erad arkivredovisnin g. TillkommandeXMLdata E 0..* Type Se 5.3.2 Tillkomman de XMLdata Eventuellt tillkommande metadata i valfritt XMLformat Se 4.2 VERKSAMHETS BASERAD ARKIVREDOVISN ING <ApplicationArea xmlns="http://www. openapplications... >
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 11(38) 4.1 BESKRIVNING AV ARKIVBILDARSTRUKTUR OCH ARKIVBILDARE Detta sätt att beskriva en arkivbildare kan användas när beskrivning ej sker med hjälp av FGS för arkivredovisning. Överenskommelse gällande användandet av elementet specificeras i leveransöverenskommelsen. Arkivbildarstrukturen beskriver arkivbildaren och innehåller endast Arkivbildare. En arkivbildare kan ingå i en annan arkivbildare och på så sätt bilda en arkivbildarstruktur. En arkivbildare kan ha flera nivåer. Ett exempel på arkivbildarnivåer är: (Nivå 1) Stockholms läns landsting (Nivå 2) Landstingsstyrelsens förvaltning (Nivå 3) SLL Personal Med arkivbildare menas myndighet eller enskild som genererar, hanterar och samlar handlingar och därigenom skapar ett enhetligt arkiv. Informationsägare 6 är en nivå av arkivbildare och affärsmässig avtalspart. 4.1.1 Beskrivning av Arkivbildare Följande element/attribut är obligatoriska Namn Följande element/attribut bör användas på den lägsta nivån: Namn VerksamhetstidFran Historik Verksamhetsbeskrivning Arkivbildare Namn E 1 xs:string, maxlängd 256 Arkivbildarens officiella namn. Värdet (namnet) måste förankras hos earkivet. SLL Personal 6 Person eller organisation som har det yttersta ansvaret för informationsinnehåll, i t. ex. ett system, och som bestämmer om vem som ska får ta del av informationen inom ramen för befintligt regelverk.
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 12(38) VerksamhetstidFran E 0..1 xs:string, maxlängd 32 När arkivbildarens verksamhet 1999 VerksamhetstidTill E 0..1 xs:string, maxlängd 32 Historik E 0..1 xs:string, maxlängd 1024 Verksamhetsbeskrivning E 0..1 xs:string, maxlängd, 1024 inleddes. När arkivbildarens verksamhet avslutades. Kortfattad historik om arkivbildaren. Beskrivning av arkivbildarens verksamhet och samband med information. Arkivbildare E 0..1 Type En Arkivbildare kan innehålla ytterligare Arkivbildare En historik om arkivbildaren En verksamhetsbeskrivn ing. Se beskrivning av Arkivbildare 4.2 VERKSAMHETSBASERAD ARKIVREDOVISNING De myndigheter som använder verksamhetsbaserad arkivredovisning bör använda nedanstående attribut och element i leveransobjektet för att beskriva placering i arkivredovisningen. Även på lägre nivåer återfinns vissa av dessa element som pekare till den verksamhetsbaserade arkivredovisningen. Elementen som förekommer på de lägre nivåerna är klassreferens, handlingstypsreferens samt förvaringsenhetsreferens. Följande element/attribut är obligatoriska ArkivReferens KlassificeringsstrukturNamn ArkivReferens E 1 xs:string Identitetskod SE/RA/125.3 för arkivet som leveransen tillhör KlassificeringsstrukturNa mn E 1 xs:string Namn på den klassificeringsst ruktur som använts Verksamhetsbaserad Arkivredovisning
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 13(38) KlassReferens E 0..* xs:string Referens till en 1.2.3.5 specifik strukturenhet HandlingstypsReferens E 0..* xs:string Referens till Anställningsavtal den handlingstyp i arkivredovisnin gen som arkivobjektet tillhör FörvaringsenhetsReferen s E 0..1 xs:string Referens till den förvaringsenhet som objektet tillhör 1/2/2/3457543
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 14(38) 5. BESKRIVNING AV ARKIVOBJEKTLISTA OCH ARKIVOBJEKT Arkivobjektlistan listar de arkivobjekt som ingår i leveransen. Arkivobjektlista kan endast innehålla Arkivobjekt och inga andra element. Innehåller ett arkivobjekt en arkivobjektlista som listar ytterligare arkivobjekt är dessa underordnade de föregående. Varje arkivobjekt innehåller den metadata som är definierade för respektive nivå. Nedanstående bild beskriver uppbyggnaden. 5.1 ARKIVOBJEKT: PERSON I tabellen nedan beskrivs hur person representeras. "Person" beskriver den anställde som kan ha en eller flera anställningar, vid en eller flera förvaltningar. Följande element/attribut är obligatoriska Unikt ID Sekretess PuL Skapare Datum Namn PersonId
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 15(38) Unikt ID E 1 xs:string, Unik sträng Refnr:00123 maxlängd 64 som identifierare för det arkiverade objektet. Genereras i samband med export efter överenskommel se med e- arkivförvaltning en. KlassReferens E 0..* xs:string Referens till en 1.2.3.5 specifik strukturenhet enligt den verksamhetsbas erade arkivredovisnin gen. HandlingstypsReferens E 0..* xs:string Referens till den handlingstyp i arkivredovisnin gen som arkivobjektet tillhör enligt den verksamhetsbas erade arkivredovisnin Anställningsavtal FörvaringsenhetsReferen s gen. E 0..1 xs:string Referens till den förvaringsenhet som objektet tillhör enligt den verksamhetsbas erade arkivredovisnin gen. 1/2/2/3457543
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 16(38) Bevaras E 1 Boolean: true eller false Om det Innehåller gallringsbart material = false, annars true. True Enligt bevarande- och gallringsplanen. Sekretess E 1 Boolean Måste objektet sekretessprövas före utlämning? Lagrum E 0..1 Xs:string maxlängd 16 True el False. Hänvisning till lagrummet för sekretessen. Anges som [lag][kap.]:[para graf] Om sekretess förekommer men lagrum saknas anges lagrum saknas. Om sekretess inte förekommer används inte Lagrum. PuL E 1 Boolean PuL är alltid = True på såväl Person som Anstallning Skapare E 1 xs:string, maxlängd 128 Den avdelning/enhet inom organisationen som ansvarar för att registrera och uppdatera informationen i systemet när systemet lämnas till arkivet False (default) OSL 2:2 True (default) SLL HR
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 17(38) SkapadDatum E 1 DatumType Se 5.3.1 DatumType From=Datum när objektet (personalakten) skapades. Finns ej detta kan utplocksdatum anges. Tom=lämnas 2011-08-23 Namn E 1 xs:string, maxlängd 512 tomt. För- och efternamn på personen. Ordningen överenskoms vid leveransen Personid E 1 Type Innehåller attributen root och extension. Root A 1 Attribut som innehåller den del som talar om vilken typ av personid detta är. Värdemängden är 1, 2, 3, 4, 5 eller 6. Betydelsen av är enligt följande: 1= Personnummer 2= Samordningsnu mmer 3= Regionalt Reservnummer 4= Nationellt Reservnummer Typ 1 5= Nationellt Reservnummer Typ 2 6= Lokalt Reservnummer (d v s lokalt för det aktuella systemet) Lars Larsson eller Larsson, Lars 1 (default)
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 18(38) Extension A 1 Innehåller själva identifikation svärdet, t.ex. personnumre t Värdet anges utan bindestreck, plustecken etc. Ett personnummer skall också alltid anges med inledande sekelsiffra utan efterföljande mellanslag. Attributet skall alltid innehålla 197405200579 Adress E 0..1 xs:string, maxlängd SkyddadIdentitet E 0..1 Boolean: True eller False Kon E 0..1 Xs:string, maxlängd Nationalitet E 0..1 Xs:string, maxlängd 12 tecken. Personens adress, se exempel Anteckning om skyddad identitet ska anges om personen haft skyddad id vid sista anställningens avslut. Default= False. Rekommendera de värden: M=man, K=kvinna. Nationstillhörig het som ISOkod. Använda ISO-koder läggs till i dokumentatione n. Stigvägen 15, 11768 Stockholm False M SE
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 19(38) Arbetstillstand E 0..* DatumType Innehåller elementen From och Tom. Tidsperiod, om arbetstillstånd finns. Datum måste vara olika för varje arbetstillstånd. Innehall E 0..* Type, se 5.3.3 Innehall TillkommandeXMLdata E 0..* Eventuellt tillkommand e metadata i valfritt XML-format. Se 5.3.2 Tillkomman de XMLdata ArkivobjektListaAnstalln ing Ett element för varje bilaga. Tillkommande XMLdata E 0..1 Type Listar de objekt av typen anställning som ingår för personen 2010-02-15 2011-02-15, 5.2 ARKIVOBJEKT: ANSTALLNING I tabellen nedan beskrivs hur anställning representeras. Anstallning beskriver uppgifter om en eller flera anställningar för en person. En ny befattning och/eller ny arbetsgivare och/eller ny anställningsform innebär att en ny anställning skapas, det vill säga ett nytt arkivobjekt. Om exempelvis lönen, lönetillägget eller tjänstgöringsgraden förändras skapas däremot inte någon ny anställning. Information som inte ryms inom definierade metadatafält kan läggas antingen som Innehåll eller som Rapport/sammanställning. Följande element/attribut är obligatoriska Unikt ID Bevaras Sekretess PuL
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 20(38) Datum Arbetsgivare Anstallningsform Primar BeslutadLon Unikt ID E 1 xs:string, Unik sträng 123456 maxlängd 64 som identifierare för det arkiverade objektet. Genereras i samband med export efter överenskommel se med e- arkivförvaltning en. KlassReferens E 0..* xs:string Referens till en specifik strukturenhet enligt den verksamhetsbas erade arkivredovisnin gen. 1.2.3.5 HandlingstypsReferens E 0..* xs:string Referens till den handlingstyp i arkivredovisnin gen som arkivobjektet tillhör enligt den verksamhetsbas erade arkivredovisnin gen. Anställningsavtal
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 21(38) FörvaringsenhetsReferen s E 0..1 xs:string Referens till den förvaringsenhet som objektet tillhör enligt den verksamhetsbas erade arkivredovisnin gen. 1/2/2/3457543 Bevaras E 1 Boolean: true eller false Om det Innehåller gallringsbart material = false, annars true. Enligt bevarande- och gallringsplanen. Sekretess E 1 Boolean Måste objektet sekretessprövas före utlämning?. Om personen har sekretess blir anställningen sekretessmärkt på samma sätt True True, False
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 22(38) Lagrum E 0..1 xs:string Hänvisning till OSL 2:2 maxlängd 16 lagrummet för sekretessen. Anges som [lag][kap.]:[para graf] Om sekretess förekommer men lagrum saknas anges lagrum saknas. Om sekretess inte förekommer används inte lagrum. PuL E 1 Boolean PuL är alltid = True på såväl Person som Anstallning True AnstPeriodDatum E 1 DatumType se 5.3.1 DatumType Anställningsper iod. Innehåller elementen From och Tom From=Det datum när anställningen påbörjades Tom=Det datum när anställningen avslutades. Kan lämnas tomt och tolkas då som att anställningen fortfarande pågick vid arkiveringen. 2012-01-01
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 23(38) Befattning E 0..* Type Elementet befattning innehåller tre underelement: BefattningTyp BefattningKate gorikod BefattningNam n BefattningTyp E 0..1 xs:string maxlängd 56 BefattningKategorKod E 0..1 xs:string, maxlängd 56 Beskriver typen på befattningen. Kod för Befattning Avtal chefkod dag_natt lakarspec 1020 BefattningNamn E 1 xs:string, maxlängd 512 Befattning (kategori) i klartext. Arbetsgivare E 1..* Type Elementet Arbetsgivare innehåller tre underelement: ArbetsgivareNa mn ArbetsgivareKo d ArbetsgivareTy p ArbetsgivareNamn E 1 xs:string, maxlängd 256 ArbetsgivareKod E 0..1 xs:string, maxlängd 56 Arbetsgivaren, den organisatoriska enhet vars budget belastas. Kod som identifierar arbetsgivaren, Exempelvis HSA. Läkare Neurokirurgiska kliniken, Huvud div, Karolinska Universitetssjukhuse t SE2321000016-2SH8
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 24(38) ArbetsgivareTyp E 0..1 xs:string, maxlängd 56 Beskriver Arbetsgivare i en hierarki. Olika antal nivåer finns. Anstallningsform E 1 Type Beskriver vilken form som anställningen följer. Elementet Anstallningsfor m innehåller tre underlement: Anstallningsfor mnamn Anstallningsfor mkod Anstallningsfor mformansgrup p AnstallningsformNamn E 1 Enumererad lista Enbart värden som finns uppräknade i exempelkolu mnen får användas. Beskriver anställningsfor m AnstallningsformKod E 0..1 Xs:numeric Kod för Anstallningsfor m AnstallningsformForm ansgrupp E 0..1 xs:string Visar vilka anställningsvill kor som gällde Förvaltning Klinik, Division, verksamhet, område, enhet Tillsvidare Visstid Vikarie pensionsgrundande Vikarie, ej pensionsgrundande >67år Prov Säsong Tim Arvode Heltid, deltid, timlön
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 25(38) Primar E 1 Boolean: true Default= true, True eller false dvs Primär. Har grundanställnin g men utlånad till annan verksamhet = false, dvs sekundär. Anstallningsfaktor E 0..1 xs:numeric Beskriver 750 grundanställnin gen i tusendelar. 750=75%-ig anställning. Sysselsattningsgrad E 0..* Type Sysselsättnings grad (hur personen egentligen arbetar) för anställningen. Elementet Sysselsattnings grad innehåller fyra underelement: Sysselsattnings grad Procent Sysselsattnings grad Datum Sysselsattnings grad ArbetstidDel Sysselsattnings gradarbetstidh SysselsattningsgradPro cent el. E 1 xs:numeric Underelement till sysselsattningsg rad. Anges i procent 0-100, där 100 är full sysselsättning. Default= 100 100
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 26(38) SysselsattningsgradDat um SysselsattningsgradArb etstiddel SysselsattningsgradArb etstidhel E 1 DatumType Se 5.3.1 DatumType Sysselsättnings grad. Innehåller elementen From och Tom From=Det datum sysselsättningsg raden gäller från. Tom= Det datum när den sysselsättningsg raden slutar att gälla. Kan lämnas tomt och tolkas då som att sysselsättningsg raden fortfarande gällde vid arkiveringen. E 0..1 xs:numeric Det antal timmar per vecka som personen defacto arbetar E 0..1 xs:numeric Det antal timmar per vecka som motsvarar heltid BeslutadLon E 1..* Type Elementet Beslutad_lon innehåller fyra underelement. BeslutadLonBel opp BeslutadLonDat um BeslutadLonTy p BeslutadLonLo nekod 2012-01-01 20 40
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 27(38) BeslutadLonBelopp E 0..1 xs:string, maxlängd Belopp i kronor/månad. Om inte belopp anges måste 28 000 BeslutadLonDatum E 1 xs:date, yyyy-mm-dd BeslutadLonTyp E 0..1 xs:string, maxlängd BeslutadLonLonekod E 0..1 xs:string, maxlängd Lönekod anges. Datumet då beloppet gäller ifrån. Månadslön, timlön, veckolön etc. Innehåller lönekod. Kan bestå av löneplan, lönegrad, löneklass, tilläggslöneklas s avskilt med semikolon Lonetillagg E 0..* Type Elementet Lonetillagg innehåller tre underelement: LonetillaggTyp LonetillaggBelo pp LonetillaggDatu m. LonetillaggTyp E 0..1 xs:string, maxlängd Visar vilken typ av tillägg och vad tillägget avser LonetillaggBelopp E 1 xs:string, maxlängd Belopp i kr. LonetillaggDatum E 0..1 DatumType From= Det datum då lönetillägget gäller ifrån Tom= Det datum då lönetillägget gäller till. 2012-04-02 Månadslön, KA; 11; AZ Chefstillägg, bilförmån 500 kr 2012-04-02-2012- 05-23
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 28(38) Uppehallslon E 0..* Type För tjänst med uppehållslön delar av året, te x lärarlön. Elementet Uppehallslon innehåller två underelement: UppehallslonFa ktor UppehallslonFa ktordatum. UppehallslonFaktor E 1 xs:numeric Underelement. Lönen fördelas lika på årets alla månader, alltså även under uppehållen. Uppehållslönefa ktor 0,92 innebär att du får 92 procent av månadslönen under tolv 0.92 UppehallslonFaktorDat um PensionsgrundandeLonM anad E 0..1 DatumType se 5.3.1 DatumType månader. From= det datum då uppehållslönefa ktorn gäller ifrån, måste anges. Tom= det datum uppehållslönefa ktorn gäller till. Kan lämnas tomt. E 0..* xs:string, Belopp i kr. Månadslön med avdrag för frånvaro samt tillägg för semesterlön. 27 500 kr
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 29(38) Pensionsbestämmelser E 0..1 xs:string, Vilket pensionsavtal man följer för beräkning av pension på den aktuella inkomsten. I klartext. Pensionsalder E 0..1 xs:numeric Vilken pensionsålder som gäller för en viss person, utifrån denna anställning. Avgangsvag E 0..1 xs:string Betecknar den avgångsväg som gällde för en viss anställning. Avgangsorsak E 0..1 xs:string Betecknar den avgångsorsak som gällde för en viss Innehall E 0..* Type se 5.3.3 RapporterSammanstallni ngar E 0..* Enumererad lista: anställning. Ett element för varje bilaga. Möjlighet att skapa sammanställnin gar och rapporter för information som kan knytas mot anställningen. Se kapitel 6. TillkommandeXMLdata E 0..* Type Eventuellt tillkommande metadata i valfritt XMLformat KollektivAvtaladPen sion pensionsavtal för arbetstagare hos kommunal arbetsgivare 65 Slutar/Okänd, Privat verksamhet Sjukersättning, Avliden före 65 Anstallningsbevis.pd f Frånvaro Pension Lönespecifikation Rehabilitering Timanställning (tid)
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 30(38) 5.3 BESKRIVNING AV ÅTERKOMMANDE TYPE-ELEMENT De element som i tabellerna beskrivs som Type och återkommer på flera ställen i de tidigare tabellerna beskrivs här. Övriga type-element beskrivs direkt i tabellerna på raden/raderna under sitt huvudelement, dessa rader inleds med ett indrag. 5.3.1 DatumType From E 1 xs:date, yyyy-mm-dd Detta är startpunkten för tidsperioden i intervallet 2006-02-20 Tom E 0..1 xs:date, yyyy-mm-dd Anger övre gränsen för tidsperioden i intervallet. Om endast en tidpunkt (ej tidsperiod) ska anges ska detta fält ha samma värde som From. 2006-02-20 5.3.2 Tillkommande XMLdata Ibland kan det förekomma att valfri XML data som följer ett annat definierat schema behöver infogas. Detta element medger den möjligheten. Element kan endast innehålla metadata som följer ett valfritt schema och dessa utökar den information och kompletterar de element som finns i FGS:en. Observera att användandet av elementet och vilka metadatascheman som kan användas bestäms i leveransöverenskommelsen mellan leverantör och mottagare. Ett exempel på utnyttjandet visas nedan där ett element från HR-XML 7 har infogats: <TillkommandeXMLdata> <ApplicationArea xmlns="http://www.openapplications.org/oagis/9" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.openapplications.org/oagis/9 NotifyDevelopmentPlan.xsd"> 7 http://hr-xml.site-ym.com/
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 31(38) <Sender>... </Sender>... </ApplicationArea> </TillkommandeXMLdata> 5.3.3 Innehall InnehallType beskriver arkivobjektets innehåll som Data, Bilagor och Referens. Elementet Innehall kan finnas på både Person och Anstallning, som data (inre xml-data), bilaga (till exempel pdf/a) eller referens (pekare till ID på ett annat objekt). Data används när innehållet läggs in direkt som XML. Bilaga används för binär fil eller textbaserad information när den är en bilaga till arkivobjektet. Handlingar som ingår i en personalakt och är knutna till en person läggs som bilaga till Person. Handlingar som kan knytas till en anställning läggs som bilaga till Anstallning. Referens används för att relatera aktuellt objekt med andra valfria objekt inom samma leverans. Som en vägledning till vad som placeras som Innehall kan RA-FS 2006:5 8 användas. I kapitel 6 finns beskrivning av Rapporter och sammanställningar, dessa skall inte läggas i innehåll. Det är den levererande verksamhetens ansvar att mappa rätt bilaga till rätt nivå. 5.3.4 Beskrivning av Data Följande element/attribut är obligatoriska Data Data E 1 xs:string Xml-koden som representerar innehållet. <as> FormatVersion E 0..1 xs:string, maxlängd 32 Se förklaring i 5.3.4.1 Format version 1.0 MediaTyp E 0..1 xs:token Se tabell nedan. text/xml CharacterSet E 0..1 xs:token Se tabell nedan. UTF-8 <a><n> attribut 1</n><v><![CDAT A[värde 1]]></v></a></as> 8 http://www.riksarkivet.se/sve/rafs/filer/ra-fs-2006-05.pdf
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 32(38) SchemaURI E 0..1 xs:string En pekare till xml-schemat i leveransen som används för att beskriva xmlstrukturen. sll_schemadata_1_0.xsd Esignatur E 0..1 Enumererad lista Se förklaring i 5.3.4.1 Certifikaten tas bort före arkivering. Detta är markören för att handlingen har varit elektroniskt signerad. Ja Nej Exempel på mediatyper (MIME): Mediatyper text/xml Exempel på teckenkoder (charset): Teckenkoder US-ASCII UTF-8 UTF-16 ISO-10646-UCS-2 ISO-8859-1 ISO-8859-2 5.3.4.1 Elementen SchemaURI och Data I elementet SchemaURI anges vilket eller vilka XML-scheman gällande för det XML-data som presenteras i elementet Data. I elementet Data infogas XML-dokumentet med element enligt nedanstående tabell. XML-element <as> <a> <n> <v> Beskrivning Rotelementet för alla attribut (as=attributes) Innehåller det enskilda attributet (a=attribute) Attributets namn (n=name) Attributets värde (v=value)
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 33(38) 5.3.5 Beskrivning av Type Bilaga Följande element/attribut är obligatoriska Namn Lank Bevaras Namn A 1 xs:string, maxlängd 64 Bilagans namn/benämnin g Chefskontrakt Beskrivning A 0..1 xs:string, maxlängd 1024 Lank A 1 xs:string, maxlängd 128 Beskriver bilagans innehåll. Filens namn inklusive sökväg och filändelse. Storlek A 0..1 xs:integer Anges i bytes 100 CharacterSet A 0..1 xs:string, maxlängd 32 Mimetyp A 0..1 xs:string, maxlängd 32 Checksumma A 0..1 xs:string, maxlängd 64 ChecksummaMetod A 0..1 xs:string, maxlängd 32 Anger vilken teckenuppsättni ng som använts. Ett sätt att beskriva filens typ. Tex text/plain för en textfil. En summa som räknats ut och som är unik för just denna fil. Används för att ange den algoritm som använts för att generera checksumman. Definition av chefsuppdrag \bilagor\chefskontra kt.pdf UTF-8 application/pdf 0A7122130CA408E 30E2BEAC4343879 30 MD-15
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 34(38) SchemaURI A 0..1 xs:string, maxlängd 1024 Esignatur A 0..1 Enumererad lista Bevaras E 1 Boolean: true eller false En pekare till xml-schemat i leveransen som används för att beskriva xmlstrukturen. Certifikaten tas bort före arkivering. Detta är markören för att handlingen har varit elektroniskt signerad. Om bilagan är gallringsbar=fal se, annars true. sll_schemadata_1_0.xsd Ja Nej True Exempel på mediatyper (MIME): Mediatyper application/pdf text/xml audio/mp3 audio/wav image/tiff video/mpeg-1 video/mpeg-2 video/mpeg-4 Exempel på teckenkoder (charset) Teckenkoder US-ASCII UTF-8 UTF-16 ISO-10646-UCS-2 ISO-10646-UCS-4 ISO-8859-1 ISO-8859-2
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 35(38) 5.3.6 Beskrivningar av element Referens ObjektId A 0..* xs:string, maxlängd 64 ObjektID för ett annat objekt, tex Arkivobjekt, som ingår i leveransen Refnr:00123
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 36(38) 6. RAPPORT OCH SAMMANSTÄLLNING Syftet med rapporter och sammanställningar är att underlätta sökbarheten för ett antal definierade personalspecifika sökrubriker, som kan ses som extra bilagor tillkommande till själva anställningen. Rapporterna och sammanställningarna är att betrakta som individbaserade. Om andra sökrubriker återkommer och kan specificeras, kan man över tid utöka nedanstående lista. Observera att användandet av rapporter och sammanställningar ska definieras och överenskommas med respektive arkivorganisation inför varje leverans. Bifogade rapporter och sammanställningar ska antingen levereras i formatet pdf/a eller som xml-filer. Bedömningen om vilket format som skall användas kan göras för varje leverans och innefattar såväl tekniska som funktionalitetsaspekter. Elementet <Rapporter_Sammanstallningar> kategoriseras efter förutbestämd lista. Följande är initialt identifierade: Pension Lönespecifikation Frånvaro RehabiliteringTimanställning (tidspost) Om bifogade filer levereras i form av xml så bör de filerna följa en given struktur, exempel på hur dessa rapporter kan skapas som XML-fil finns i bilaga till delrapporten tillhörande FGS för leveranstypen personal.
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 37(38) 7. BESKRIVNING AV TILLÅTNA FORMAT E-arkivet är till för att bevara data under längre tidsperioder och måste därför tillse att data är läsbart även efter många år. För att kunna uppnå detta är det av största vikt att de format som används i arkivet är beständiga över lång tid. Vid leveransen behöver en överenskommelse om vilka format som är godkända träffas. Mer information går att finna i FGS för paketstruktur för e-arkiv.
Christer Atterling & Karin Bredenberg IT 010-476 71 23 2013-01-14 1.0 38(38) 8. PAKETERING AV LEVERANSER Mer information om detta finns i dokumentet FGS för paketstruktur för earkiv.