RegionNavet för befolkningsuppgifter - fördjupad information
Innehå llsfö rteckning 1. RegionNavet för befolkningsuppgifter s 3 2. Databas med dagsaktuella befolkningsuppgifter s 3 3. Grafiskt gränssnitt (webbapplikation) s 4 4. epersondata Web services s 4 4.1 Web service Personpost, resultat i termkodsformat s 4 4.2 Web service Personpost, resultat i XML format s 5 4.3 Web service Namnsökning länet s 5 4.4 Web service Namnsökning Sverige s 5 5. Statistik s 5 6. Grunduttag av befolkningsdata för kommun s 6 7. Ändringsavisering av folkbokförda i kommunen s 7 8. Ändringsavisering mot indatafil s 7 9. Säkerhet, behörighet, åtkomst s 7 9.1 Behörighet för administratörer och användare av webbapplikationen s 8 2
1 RegiönNåvet fö r befölkningsuppgifter RegionNavet innehåller följande funktioner och integrationsmöjligheter: Dagsaktuell databas med befolkningsuppgifter för folkbokförda i resp. län. Grafiskt gränssnitt (Webbaserat) där användare i kommunerna kan söka befolkningsuppgifter på kommun, länsnivå och Sverigenivå. Tjänsten epersondata som innebär möjlighet till integration med e-tjänster och applikationer. Exempelvis kan kundens egen applikation direkt hämta en personpost eller söka fram personer ur RegionNavet eller Skatteverkets Navet. Tekniken web service används. Statistikfunktion för kommunen avseende födda, avlidna, inflyttade, utflyttade. Grunduttag av befolkningsdata för kommun. Ändringsavisering, vid förändringar av befolkningsdata för kommun. Ändringsavisering mot indatafil (vid förändringar av befolkningsdata för ett begärt urval). Stödfunktioner för loggning, lösenordshantering, behörighetshantering för RegionNavet. 2 Dåtåbås med dågsåktuellå befölkningsuppgifter RegionNavet innehåller en databas för befolkningsuppgifter med de uppgifter som Skatteverket levererar. RegionNavets databas är en kopia av Skatteverkets databas för folkbokförda inom respektive län. RegionNavets databas uppdateras varje natt med förändringar från Skatteverkets Navet förutom på helgerna. För varje personpost i databasen lagras kommunkod och länskod, därmed kan varje personpost i RegionNavet hänföras till ett specifikt län och kommun. Folkbokföringsuppgifter som hämtas från Skatteverket: Folkbokföringsuppgifter som hämtas från Skatteverket och uppdaterar RegionNavet. Ändringsavisering av RegionNavet är beställd för daglig uppdatering från Skatteverket. Tillfälligt personnummer/samordningsnummer levereras inte från Skatteverket. Posttyp AB 3.1, inklusive ärendetypskoder tas med i beställningen. Dessa ärendetypskoder från Skatteverket används av statistikprogrammet i RegionNavet. Skatteverket levererar ibland poster där relation inte har ett korrekt födelsenummer i den post son levereras. Inläsningsprogrammet till RegionNavet kastar dessa poster, RegionNavet uppdateras bara om relationer har ett korrekt personnummer. Grunduttag och ändringsaviseringsfiler hämtas för både Västerbotten och Norrbotten via Umeå kommuns certifikat. Resultatet levereras uppdelat på två filer, en för Västerbotten och en för Norrbotten. 3
3 Gråfiskt grå nssnitt (Webbåpplikåtiön) Alla registrerade användare i kommunerna har tillgång till sökfunktionerna: o Personnummersök länen (AC + BD) o Personnummersök Sverige o Namnsök länen (AC+ BD) o Namnsök Sverige Utseendet på sökgränssnitt och presentation av sökresultat framgår av tillgänglig skarp driftmiljö. För sekretessmarkerade personer så skickar Skatteverket med sekretessuppgifter, web-applikationen tar bort adressuppgifterna om personen är sekretessmarkerad. Dessa adressuppgifter visas för de användare som har behörighet att se sekretessuppgifter. Endast PuL-admin kan ge behörighet till användare att se sekretessmarkerade personer. Uppkoppling mot RegionNavet och webbgränssnittet görs från användarens webbläsare. 4 epersöndåtå Web services Tjänsten epersondata innebär möjlighet att direkt hämta en personpost eller söka fram personer ur RegionNavet eller Skatteverkets Navet via kundens egen applikation. Vilka uppgifter respektive kund får ta emot via epersondata regleras av vilka uppgifter kunden själv får lagra i sina register. Observera att tjänsten epersondata har i RegionNavet standardiserats och levererar alltid alla uppgifter som kan levereras. Det är upp till kundens egna applikationer (verksamhetssystem) att plocka bort de uppgifter som kunden inte får lagra i sina register eller som applikationen inte behöver. Tjänsten epersondata är baserad på tekniken Web Services och kommunikationen sker via Internet. I tjänsten epersondata ingår fyra Web Services, - Personpost länet och Sverige, resultatet i termkodsformat - Personpost länet och Sverige, resultatet i XML format - Namnsökning länen, resultatet i termkodsformat - Namnsökning Sverige, resultatet i termkodsformat 4.1 Web service Persönpöst, resultåt i termködsförmåt WSPersonpost Söker fram en person utifrån personnummer. Sökningen utförs först i RegionNavet och om inte personen hittas där utförs en sökning i Skatteverkets Navet. Resultatet returneras som en sträng i termkodsformat. Alla kunder får leverans av uppgifter enligt en gemensam standardiserad mall. 4
4.2 Web service Persönpöst, resultåtet i XML förmåt WSPersonpostXML Söker fram en person utifrån personnummer. Sökningen utförs först i RegionNavet och om inte personen hittas där utförs en sökning i Skatteverkets Navet. Resultatet returneras som en sträng i XML-format. Alla kunder får leverans av uppgifter enligt en gemensam standardiserad mall. 4.3 Web service Nåmnsö kning lå net WSNamnsok Söker fram en lista av personer utifrån angivna sökkriterier. Sökningen utförs i RegionNavet. Resultatet returneras som en sträng innehållandes en lista med personer i termkodsformat. Max antal träffar som returneras är 100. Vid förfrågan kan olika söksträngar anges, till exempel namn, födelsetid eller postnr som kombineras i sökningen. 4.4 Web service Nåmnsö kning Sverige WSNamnsokSverige Söker fram en lista av personer utifrån angivna sökkriterier. Sökningen utförs i Skatteverkets Navet. Resultatet returneras som en sträng i termkodsformat, innehållandes en lista med personer. Max antal träffar som returneras är 100. Vid förfrågan kan olika söksträngar anges, till exempel namn, födelsetid eller postnr som kombineras i sökningen. Om en mer utförlig personpost önskas om funnen person anropas Web Service Personpost. 5 Ståtistik Vid varje uppdatering, varje natt från Skatteverkets NAVET, kan man ta ut följande värden och vissa denna information i webfliken statistik. Födda, dvs de som kommit in till systemet, (Ärendetyp 6H). Avlidna, dvs de som kommit in till systemet (Ärendetyp 66H). Totalt antal invånare för aktuell dag. Dvs folkbokförda i kommunen, inte avlidna. Uppgifterna hämtas från RegionNavets databas. Utflyttade hur många poster som försvunnit (uppräkning av antal poster som flyttat men inte är avlidna) Ärendetyp 41H, flyttning, i historiken och ärendetyp 43H, utvandring. I grundposten finns endast den nuvarande folkbokföringen. I historikposten jämförs de två senaste posterna för att se om en utflyttning skett från kommunen eller om flyttning skett inom kommunen. Inflyttade hur många poster som tillkommit (uppräkning av antal nya poster ej avlidna) Ärendetyp 41H, flyttning, i historiken och ärendetyp 40H, invandring. Varje dygn sparas siffran på antalet födda, avlidna, totalt antal invånare, utflyttade samt inflyttade per kommun och med datumstämpel i en statistiktabell. I statistiktabellen sparas inte uppgifter om vilka som är födda, avlidna, utan endast antalet. I RegionNavet ingår dessutom en statistikrapport för det senaste dygnet, dessa uppgifter presenteras och visas på bildskärm för respektive kommun, se bild nedan. Alla registrerade användare i RegionNavet får tillgång till statistikrapporten för sin kommun. 5
Exempel på statistikrapport för Robertsfors kommun. Statiskrapporten visas på bildskärmen. Befolkningsstatistik för Robertsfors kommun Datum: 2012-10-18 Rapporterade förändringar senaste dygnet, för måndagar förändringar sedan fredag. Födda: 2 Avlidna: 0 Utflyttade: 1 Inflyttade: 0 Totala antal invånare: 7523 6 Grunduttåg åv befölkningsdåtå fö r kömmun Grunduttag innebär att respektive kommunen kan hämta aktuella befolkningsdata för alla folkbokförda i sin kommun från RegionNavet. Den troligaste användningen av denna funktion är kommun som beställer ett grunduttag till sitt kommuninvånarregister (t.ex. KIR). Tidigare har denna beställning gjorts hos Skatteverket (NAVET). Ett kontrakt upprättas mellan kommunen och RegionNavet gällande grunduttag. De uppgifter/attribut som levereras till kommunerna är enhetliga, en kommun kan alltså inte välja vilka uppgifter den vill ha. Uppgifter/attribut levereras enligt beställningsblankett. I RegionNavet skapas en mapp per kommun där grunduttagsfilen sparas. När en kommun vill ha ett grunduttag registrerar vi det i RegionNavet med ett datum då kommunen vill ha filen. Det datumet skapar sedan en grunddatafil i XML-format eller i termkods-format. Filen innehåller samtliga personer som har den står skriven i kommunen. Den har samma utseende som Skatteverkets fil för grunddata. Det är upp till respektive kommun att hämta filen från RegionNavet och eventuellt sprida detta till olika system/register i kommunen. Användarnamn och lösenord för åtkomst till kommunens mapp erhålls från Umeå Kommun IT. 6
7 Ä ndringsåvisering åv fölkbökfö rdå i kömmunen Ändringsavisering innebär att respektive kommun som begärt ett grunduttag från RegionNavet kan hämta förändringar som skett för alla folkbokförda i sin kommun. Ett kontrakt upprättas mellan kommunen och RegionNavet gällande ändringsavisering. De uppgifter/attribut som levereras till kommunerna är enhetliga, en kommun kan alltså inte välja vilka uppgifter den vill ha. I RegionNavet skapas en mapp per kommun där ändringsaviseringsfilerna sparas. När en kommun vill ha ändringsavisering registrerar vi det i RegionNavet och dagen efter att grunduttagsfilen har levererats (det krävs att kommunen gör ett grunduttag) börjar ändringsaviseringsfilerna levereras. Dessa kan levereras i XML-format eller i termkods-format. Filerna innehåller samtliga personer som har den står skriven i kommunen där det skett någon form av förändring. Den har samma utseende som Skatteverkets fil för ändringsavisering. Det är upp till respektive kommun att hämta filerna från RegionNavet och eventuellt sprida detta till olika system/register i kommunen. Användarnamn och lösenord för åtkomst till kommunens mapp erhålls från Umeå Kommun IT. 8 Ä ndringsåvisering möt indåtåfil Med ändringsavisering mot indatafil avses löpande avisering av uppgifter i folkbokföringen som ändrats för personer som angetts i indatafilen. Kunder vars register har en population som inte motsvaras av ett visst geografiskt område kan inte aviseras på "det vanliga" sättet. De måste i stället skicka in sin population på en infil (frågefil) till RegionNavet, indatafilen kan innehålla både personer folkbokförda i kommunen, länet eller övriga Sverige. Funktionen används t.ex. av verksamhetssystem som skapar en indatafil på de individer som finns registrerade i verksamhetssystemet. 9 Så kerhet, behö righet, å tkömst Användare i kommunerna får via webbapplikationen (grafiska gränssnittet) tillgång till personnummersök, namnsök och statistik. Respektive kommun måste kunna ange från vilka IP-nummer eller IP-nummerserier anrop görs. Anrop från valfri IP-adress på internet är spärrat. Vid anropet sker en kontroll att IP-numret har behörighet att anropa servern där applikationen ligger, dvs filtrering på IP-nummer. För att logga in i applikationen används användarnamn och lösenord. Det är viktigt att dessa uppgifter inte sprids vidare till andra än användaren och att behörigheten tas bort när anställd slutar sin anställning. Anropen krypteras i och till webbapplikationen med HTTPS. Byte av lösenord utförs av en kommunadministratör, kan inte göras av respektive användare. 7
9.1 Behö righeter fö r ådministråtö rer öch ånvå ndåre åv webbåpplikåtiönen (gråfiskå grå nssnittet) I RegionNavet finns fyra olika behörighetsroller enligt nedan. Superadmin en per regionnav - Åtkomst till alla vyer. - Kan skapa/redigera användare, tilldela roller och kommuntillhörighet. - Kan inte sätta/ändra behörighet till sekretessuppgifter. Kommunadmin en per kommun - Åtkomst till alla vyer förutom redigera infotext. - Kan se alla användare som tillhör samma kommun. - Skapa/redigera användare, kommuntillhörighet låst till samma som kommunadmin tillhör. - Kan byta lösenord för användare. - Sätta roller (utom superadmin rollen). - Kan inte sätta/ändra behörighet till sekretessuppgifter. -Kan kolla loggar. PuLadmin en per kommun - Åtkomst till alla vyer förutom redigera infotext. - Kan se alla användare som tillhör samma kommun. - Kan redigera användares behörighet till sekretessuppgifter, men inget annat. Användare läggs upp av respektive kommunadmin - Åtkomst till Vyerna start. - Åtkomst till grafiska gränssnittet (vyn) för personnummersök och namnsök. - Åtkomst till statistik för egen kommun. 8