Kravspecifikation. UB80 Hantering av dubbla personnummer Beteckning: UB80_kravspec

Kravspecifikation UB80 Hantering av dubbla personnummer 2017-01-11 Beteckning: UB80_kravspec Ändringshistorik Datum Av Kommentar Godkännare 2007-12-07 Maria Valtersson Första version som publiceras på webben efter leverans 2009-09-12 Per Lindgren Proj 9106. Tidsbegränsad adress ska om den finns och är giltig listas för IPN-poster. 5.1 Post från NYA 6.5 Interimsbokstav

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 2 (22) 6.6 Filformat från nya 6.7 Resultatfil 2009-11-01 Martin Edlund Proj 9106 2009-11-09 Martin Edlund Proj 9106 2009-11-15 Martin Edlund Proj 9106 2009-11-20 Martin Edlund Proj 9106 2009-12-23 PerLindgren Leverans Redigerat om i viss mån och satt vettiga rubriker på det som kallas kontroller. Omredigering så att delfunktionerna hålls ihop textmässigt. En förändring i innehåll, förtydligande av meddelandetext under rubrik 4.2.3.2. Ändrat så att varje resultatrad börjar på Posttyp IPN resp Posttyp BYT (se rubrik 4.2.4) Ändrat meddelande från batchen under punkterna 4.2.3.1 och 4.2.3.2 2014-12-03 Magnus Böhlin Förändringar i resultatfilen från UB80B-Utbytta och nya personnummer från VHS 2016-06-29 Per Lindgren Ny posttyp IPX. I denna finns ipnr från Nya och de ska kollas mot NAMN + en listning av nationella ipnr som saknas i IPX-filen från Nya Sidorna 14-18 https://jira.its.umu.se/browse/ladok-20664 2017-01-11 Britt Berglund Uppdaterat förteckningen över system- och användarpreferenser.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 3 (22) Innehållsförteckning 1 UTSÖKNING AV DUBBLA PERSONNUMMER... 4 1.1 INLEDNING... 4 2 BEHÖRIGHET... 4 2.1 ANVÄNDARPREFERENS... 4 3 UB80A00G STARTFORMULÄR... 5 4 JÄMFÖRELSE AV NYA OCH BYTTA PERSONNUMMER I NYA MED PERSONNUMMER I LADOK... 6 4.1 BATCHBESTÄLLNING... 6 4.2 UTSÖKNING I LADOK (BATCH-DELEN)... 6 4.2.1 Hämta fil i NyA med nya och bytta personnummer... 6 4.2.2 Hantering av IPN-poster... 6 4.2.3 Hantering av BYT-poster... 7 4.2.4 Hantering av resultatfil... 8 5 KONTROLL AV DUBBLETTER I LADOK... 11 5.1 BATCHBESTÄLLNING... 11 5.2 VILLKOR I BATCHBESTÄLLNING... 11 5.2.1 Arbetssätt för utsökning av dubbletter i LADOK... 11 5.2.2 Formulärets utseende och innehåll... 11 5.2.3 Uppdatera... 11 5.3 UTSÖKNING AV DUBBLA PNR I LADOK (BATCH-DELEN)... 13 5.4 HANTERING AV RESULTATFIL... 15 5.4.1 Namn... 15 5.4.2 Innehåll och format... 15 6 LISTA TRÄFF MED POSTTYPEN IPX OCH DÄR ENAMN/TNAMN SKILJER... 16 7 LISTA NATIONELLA IPNR I LADOK SOM INTE FINNS I NYA-FILEN SOM POSTTYPEN TNR 19 8 ÅTERKOPPLING TILL BATCHBESTÄLLAREN... 20 8.1 EFTERBEHANDLING OCH EPOSTMEDDELANDE... 20 8.2 FELLISTA... 21 9 GENERELLA KONTROLLER... 21 9.1 VALIDERING AV PERSONNUMMER... 21 9.2 LÄSNING I TABELLEN NAMN... 21 9.3 VALIDERING AV ETABLERINGSDATUM... 21 9.4 VALIDERING AV FÖDELSEDATUM... 21 9.5 JÄMFÖRELSEKONTROLL AV ETABLERINGSDATUM... 22 9.6 VALIDERING AV SEKEL... 22 9.7 KONTROLL AV SEKELSIFFRA... 22

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 4 (22) 1 Utsökning av dubbla personnummer 1.1 Inledning För att samspelet med NyA skall fungera bra, är det nödvändigt att ge ett bra stöd för att hitta personer som förekommer på mer än ett personnummer, dels i Ladok och dels i Ladok respektive NyA. Man behöver både kunna hitta sådana personer i Ladok och jämföra personer i Ladok med personer i NyA via inläsning av fil. Något automatiskt byte av personnummer utifrån sökresultat är inte möjligt att göra, då varje personnummerbyte måste föregås av en mänsklig bedömning för att man skall uppnå tillräcklig säkerhet. Batchen matchas av AF-80 på NyA-sidan. 2 Behörighet Funktionen har ett startformulär med två delfunktioner. Det går att sätta olika behörighet på de olika delfunktionerna om det behövs. Behörighetsinformationen finns i tabellerna NOVFUNK och NOVBEHKL. 2.1 Användar- och systempreferenser Som standard saknas preferensen SUPER=J i tabellen ANVPREF2 användaren kan då bara se, köra och ändra sina egna beställningar. Vill man ge användaren behörighet att även ta bort andra användares beställningar ska följande preferens läggas in i ANVPREF2 Funk Nr Vad vill man styra Nyckelord Värde: Resultat Default Typ UB80 Lägg till/ta bort SUPER J N A ändra andras beställningar UB80_B Tillgång till villkorsformulär VILLKOR J= knappen Villkor är tillgänglig J S N= Knappen Villkor är inte tillg Preferensen måste sättas till N

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 5 (22) UB80_C Tillgång till villkorsformulär VILLKOR J= knappen Villkor är tillgänglig J S N= Knappen Villkor är inte tillg Preferensen måste sättas till J 3 UB80A00G Startformulär Här ska man kunna välja två olika delfunktioner: - Utbytta och nya personnummer från VHS - Dubbletter i LADOK Hjälptext: Välj delfunktion.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 6 (22) 4 Jämförelse av nya och bytta personnummer i NyA med personnummer i Ladok Börja med att läsa tabellen BATKOPPL där ladokid = UB80 för att få fram namn på motsvarande batch i NyA-systemet (ANNANID). Om det ligger flera poster i tabellen så ska vi ta den senaste av dessa filer. 4.1 Batchbeställning Resultatet av beställningen listar i en resultatfil uppgifter avseende om troliga dubbletter som finns i VHS-filen och i NAMN-tabellen. Beställning läggs upp i det generella batchbeställningsformuläret (GB01A00G). Det ska vara möjligt att ange en stående beställning. När uppdatering av beställningen har skett är knappar för att ange Inställningar (BATINST) och Villkor (BATVILL) tillgängliga och tabellen BATCHJOB uppdaterad med alla ingående uppgifter. Inställningsformuläret GB01A02G används för att lagra e-postadress för användaren i tabellen BATINST. Anges ingen e-postadress ska adress lagrad i tabellen ANVIP användas istället. Finns det ingen adress där heller kan e-postmeddelande inte skickas ut om batchens status. 4.2 Utsökning i Ladok (batch-delen) 4.2.1 Hämta fil i NyA med nya och bytta personnummer Batchen utgår från en resultatfil som är framtagen av batch AF80 i NyA. Uppgifter för var den hämtas och med vilken användare är specificerat i ladok.batch.properties under rubrik NyA. 4.2.1.1 Namn och format på fil i NyA Detta finns specificerat i clearcase i dokumentet af80 överföringsformat vilket ligger i VOB NYA_DOC under krav/af/. 4.2.2 Hantering av IPN-poster Hämta upp filen från NyA och börja med att läsa de poster som har IPN i position 1-3 på varje rad. Hämta på dessa poster upp pnr från position 4-15. Personer som har F i position 7 ska inte finnas med i filen från VHS. Kommer sådana poster med så sorterar vi bort dessa innan några kontroller påbörjas då vi inte är intresserade av dessa pnr. De kommer att försvinna då det är rättat på NyA-sidan Genomför Validering av personnummer. Om det blir något fel så skrivs pnr till fellista för senare genomgång. I de fall det rör sig om ett interimspersonnummer kontrolleras tecknet på 7:e position och valideras mot tabell INTBOKST. Typen för tecknet ska vara N eller L annars hanteras int personnumret vidare i UB80. Meddelande läggs ut på log för debug. Genomför Validering av sekel. Om det blir något fel så skrivs pnr till fellista för senare kontroll. Genomför Läsning i tabellen NAMN. Om träff lägger vi ut info enligt fildefinitionen senare i dokumentet. I fältet för Meddelande från batchen lägger vi Träff, samma ipnr i Ladok och NyA.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 7 (22) Får vi ingen träff så gör vi en ytterligare kontroll på de första 6 siffrorna i pnr samt 3 första pos i förnamn och 3 första pos i efternamn och söker igen. De träffar vi får då listas enligt fildefinitionen senare i dokumentet. I fältet för <Meddelande från batchen> lägger vi Möjlig träff i Ladok. Har ursprungspersonen mindre än 3 tecken i för eller efternamn så slår man med de antal bostäver som finns i den personens för- och/eller efternamn Exempel: Har man 680112P200;BO;EK;TESTVÄGEN FBF 20 232 20 TESTSTAD 20;;K Borde det bli träff på: 6801121200;BO;EK;TESTVÄGEN FBF 19 232 19 TESTSTAD 19;;K 6801123214;BO-ANDERS;EK-SON;TESTVÄGEN FBF 11 232 11 TESTSTAD 11;epost@11.se;M 680112T622;BO-ANDERS;EK-SON;TESTVÄGEN FBF 12 232 12 TESTSTAD 12;;K Utgår man däremot ifrån: 680112T622;BO-ANDERS;EK-SON;TESTVÄGEN FBF 12 232 12 TESTSTAD 12;;K Så borde man endast få träff på: 6801123214;BO-ANDERS;EK-SON;TESTVÄGEN FBF 11 232 11 TESTSTAD 11;epost@11.se;M Eftersom man söker med 3 tecken i för och efternamn så kan inte en person med endast 2 tecken vara en möjlig träff. 4.2.3 Hantering av BYT-poster När man gått igenom alla poster med IPN går man igenom och kontrollerar de i filen från VHS och börja med det som har BYT i position 1-3 på varje rad. Får man träff på både pnr i pos 4-15, gammalt pnr, och pos 16-27, nytt pnr, så skapas poster i resultatfilen för bägge typerna av pnr. I posten så presenteras både uppgifterna från NyA-filen och uppgifterna från Ladok. Får vi då ingen träff på ovanstående går vi vidare till nästa personnummerbyte i NyA-filen. 4.2.3.1 Leta person i Ladok med pnr som NyA har bytt ifrån Hämta upp pnr från position 4-15 (gammalt pnr från NyA). Genomför Validering av personnummer. Om det blir något fel så skrivs pnr till fellista för senare genomgång. I de fall det rör sig om ett interimspersonnummer kontrolleras tecknet på 7:e position och valideras mot tabell INTBOKST. Typen för tecknet ska vara N eller L annars hanteras int personnumret vidare i UB80. Meddelande läggs ut på log för debug. Genomför Validering av sekel. Om det blir något fel så skrivs pnr till fellista för senare kontroll. Genomför Läsning i tabellen NAMN. Om träff lägger vi ut info enligt fildefinitionen senare i dokumentet. I fältet för Meddelande från batchen lägger vi **UTRED** Träff i Ladok på gammalt pnr från NyA. Får vi ingen träff så gör vi en ytterligare kontroll på de första 6 siffrorna i pnr samt 3 första pos i förnamn och 3 första pos i efternamn och söker igen. De träffar vi får då listas enligt fildefinitionen senare i dokumentet. I fältet för Meddelande från batchen lägger vi **UTRED** Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt pnr).

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 8 (22) Om namnet från NyA och namnet i Ladok skiljer sig läggs även följande text till: Namn stämmer inte överens med Ladoks. 4.2.3.2 Leta person i Ladok med pnr som NyA har bytt till Kontrollera även det pnr man bytt till genom att hämta upp pnr från position 16-27 (nytt pnr från NyA). Genomför Validering av personnummer. Om det blir något fel så skrivs pnr till fellista för senare genomgång. Genomför Validering av sekel. Om det blir något fel så skrivs pnr till fellista för senare kontroll. Genomför Läsning i tabellen NAMN. Om träff lägger vi ut info enligt fildefinitionen senare i dokumentet. I fältet för Meddelande från batchen lägger vi ut två olika texter beroende på om motsvarande pnr-byte skett i Ladok. Det undersöker vi genom att försöka läsa upp bytet från tabell GAMMALNY. Gammalt pnr i Ladok läses upp med NPNR = < nytt pnr i VHS-filen >. Om vi får träff skriver vi **UTRED** Träff i Ladok på nytt pnr från NyA. I Ladok har byte gjorts från <gammalt pnr i Ladok > till <nytt pnr i VHS-filen >. i meddelande-fältet. Om ingen träff skriver vi Träff i Ladok på nytt pnr från NyA. Får vi ingen träff så gör vi en ytterligare kontroll på de första 6 siffrorna i pnr samt 3 första pos i förnamn och 3 första pos i efternamn och söker igen. De träffar vi får då listas enligt fildefinitionen senare i dokumentet. I fältet för Meddelande från batchen lägger vi **UTRED** Möjlig träff i Ladok på födelsedag/namn från NyA(nytt pnr). Om namnet från NyA och namnet i Ladok skiljer sig läggs även följande text till: Namn stämmer inte överens med Ladoks. 4.2.4 Hantering av resultatfil Filen sparas på servern på den sökväg som anges i ladok.batch.properties. Nyckeln för sökvägen heter batchfiles. 4.2.4.1 Namn <HSK>_<BATCH_ID>_<YYYYMMDD_TTMMSS> 4.2.4.2 Innehåll och format Filen formateras för att kunna läsas direkt med med mellanrum mellan kolumner och blankrad mellan varje post. Filen sorteras så att alla direktträffar visas först i filen därefter ju svagare kopplingen mellan personerna blir desto senare i filen presenteras posterna. Sökresultatet för IPN-poster läggs före den av BYT-posterna. Förnamn och efternamn från NyA-filen som inte ryms i sin kolumn läggs efter Meddelandekolumnen längst till höger på raden. De möjliga-träffar som hör till samma post från NyA-filen hålls ihop och har ingen blankrad mellan sig.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 9 (22) Ex möjliga träffar(visar bara meddelandefältet). I slutet på första posten ligger dessutom ett exempel på namn som inte rymdes i ordinarie kolumn: Pnr 1 - *UTRED* Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt pnr). DROGGUS, UNNUS FÖRFATTARE Pnr 1 - *UTRED* Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt pnr). DROGGUS, UNNUS FÖRFATTARE Pnr 1 - *UTRED* Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt pnr). DROGGUS, UNNUS FÖRFATTARE Pnr 1 - *UTRED* Möjlig träff i Ladok på födelsedag/namn från NyA(nytt pnr). DROGGUS, UNNUS FÖRFATTARE Pnr 2 - *UTRED* Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt och nytt pnr). Pnr 2 - *UTRED* Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt och nytt pnr). Pnr 2 - *UTRED* Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt och nytt pnr). Pnr 3 - *UTRED* Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt och nytt pnr). 4.2.4.3 IPN-poster Namn och personnummer från både NyA och Ladok skrivs ut i varje resultatpost. Möjliga meddelanden: Träff, samma ipnr i Ladok och NyA **UTRED** Träff, samma ipnr i Ladok och NyA. Namn stämmer inte överens med Ladoks **UTRED** Möjlig träff i Ladok på födelsedag/namn från NyA 4.2.4.3.1 Rubrik Ipnr från Kön i NyA Pnr i Ladok Enamn i NyA Tnamn i NyA NyA Enamn i Ladok Tnamn i Ladok Meddelande 4.2.4.3.2 Detaljrader < Ipnr från NyA >< Pnr i Ladok >< Enamn i NyA >< Tnamn i NyA>< Kön i NyA><Enamn i Ladok><Tnamn i Ladok><Meddelande> Exempel på detaljrad: 7102020067 7102020067 LEMPARTY KRYSZTOF M ANNERÉN MALIN ULRIKA M *UTRED* Träff, samma ipnr i Ladok och NyA. Namn stämmer inte överens med Ladoks. Oavsett vilket Meddelande som presenteras så ligger det alltid samma data i posten. 4.2.4.4 BYT-post Namn och personnummer från både NyA och Ladok skrivs ut i varje resultatpost. Möjliga meddelanden: Träff i Ladok på nytt pnr från NyA. Träff i Ladok på nytt pnr från NyA. I Ladok har byte gjorts från x till y **UTRED** Träff i Ladok på nytt pnr från NyA. I Ladok har byte gjorts från x till y. Namn stämmer inte överens med Ladoks **UTRED** Träff i Ladok på nytt pnr från NyA. Namn stämmer inte överens med Ladoks **UTRED** Träff i Ladok på gammalt pnr från NyA. **UTRED** Träff i Ladok på gammalt pnr från NyA. Namn stämmer inte överens med Ladoks **UTRED** Möjlig träff i Ladok på födelsedag/namn från NyA(nytt pnr) **UTRED** Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt pnr)

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 10 (22) **UTRED** Möjlig träff i Ladok på födelsedag/namn från NyA(gammalt och nytt pnr) 4.2.4.4.1 Rubrik Gammalt Nytt Kön i Pnr i NyA Pnr i NyA Pnr i Ladok Enamn i NyA Tnamn i NyA NyA Enamn i Ladok Tnamn i Ladok Meddelande 4.2.4.4.2 Detaljrader <Gammalt Pnr i NyA ><Nytt Pnr i NyA >< Pnr i Ladok><Enamn i NyA > <Tnamn i NyA><Kön i NyA><Enamn i Ladok><Tnamn i Ladok><Meddelande> Exempel på detaljrad: 7101013956 7101013238 7101013238 KARLSTRÖM BORRARE M NAQESHABANDI OMED *UTRED* Träff i Ladok på nytt pnr från NyA. Namn stämmer inte överens med Ladoks. Oavsett vilket Meddelande som presenteras så ligger det alltid samma data i posten.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 11 (22) 5 Kontroll av dubbletter i LADOK 5.1 Batchbeställning Beställningen listar uppgifter avseende om troliga dubbletter som finns i LADOK i NAMNtabellen. Beställning av kontrollen läggs upp i det generella batchbeställningsformuläret (GB01A00G). Det ska vara möjligt att ange en stående beställning. När uppdatering har skett är knappar för att ange Inställningar (BATINST) och Villkor (BATVILL) tillgängliga och tabellen BATCHJOB uppdaterad med alla ingående uppgifter. Inställningsformuläret GB01A02G används för att lagra e-postadress för användaren i tabellen BATINST. Anges ingen e-postadress ska adress lagrad i tabellen ANVIP användas istället. Finns det ingen adress där heller kan e-postmeddelande inte skickas ut om batchens status. 5.2 Villkor i batchbeställning 5.2.1 Arbetssätt för utsökning av dubbletter i LADOK Högst upp i formuläret visas uppgifter angivna i beställningen. Markera vilken typ av utsökning man vill göra. Väljer man Alla så skall de andra alternativen dimmas så att åtkomst inte blir möjlig. Man ska däremot kunna välja Alla med samma födelsedatum, Etableringsdatum, Aktiva och Pnr-intervall samtidigt. Klicka slutligen på knappen Uppdatera. Villkor för batchbeställning av Utsökning av dubbletter i LADOK har sparats och formuläret kan stängas. 5.2.2 Formulärets utseende och innehåll UB80 [Villkor Utsökning av dubbletter] Högst upp i formuläret visas information om beställningen (enl. standard i batchbeställningar) I övrigt ska formuläret visa alternativ med följande innehåll: 1. Alla uppgifter (checkbox) 2. Alla med samma födelsedatum 3. Födelsedatum fr.o.m(checkbox), fält för from och tom födelsedatum, (editbox 6 tecken) 4. Aktiva from temin (checkbox), fält för termin (editbox 3 tkn) 5. Etableringsdatum fr o m (checkbox), fält för etableringsdatum (editbox) OBS! Väljer man checkboxen Alla uppgifter skall alla andra alternativ dimmas. De övriga alternativen kan dock kunna kombineras efter eget önskemål. 5.2.3 Uppdatera Vid uppdatera sparas alla inställningar ner i BATVILL, varje inställning ska hamna på en egen rad med stigande villkorsnummer. Beroende på vilken checkbox som är markerad ska villkoren se annorlunda ut. Är checkboxen Alla uppgifter markerad ska villkoret ha formen ALLA= J

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 12 (22) Är checkboxen Alla med samma födelsedatum markerad ska villkoret ha formen ALLASAMMA= J Är checkboxen Pnr-intervall markerad ska villkoret ha formen INTERVALL=J och PNRFROM=650101 och PNRTOM=771231 Är checkboxen Aktiva from temin markerad ska villkoret ha formen AKTIVA= J och TERMIN=19981 Är checkboxen Etableringsdatum fr o m markerad ska villkoret ha formen ETAB= J och DATUM=2006-12-14 ANVKOD FUNKTION BETECKN VILLNR VILLKOR JSL UB80_C BATCHJOB.BETECKN 1 INTERVALL=J JSL UB80_C BATCHJOB.BETECKN 2 PNRFROM=650101 JSL UB80_C BATCHJOB.BETECKN 3 PNRTOM=771231 JSL UB80_C BATCHJOB.BETECKN 4 AKTIVA= J JSL UB80_C BATCHJOB.BETECKN 5 TERMIN=19981 JSL UB80_C BATCHJOB.BETECKN 6 ETAB= J JSL UB80_C BATCHJOB.BETECKN 7 DATUM=2006-12-14 JSL UB80_C BATCHJOB.BETECKN 8 ALLA=J JSL UB80_C BATCHJOB.BETECKN 9 ALLASAMMA=J BATCHJOB uppdateras med BATCHJOB.VILLKOR=J. Genomför Validering av personnummer. Om det blir något fel så skrivs pnr till fellista för senare genomgång. Genomför Validering av etableringsdatum. Genomför Validering av födelsedatum. Genomför Jämförelsekontroll av etableringsdatum. Felmeddelanden: När man har kryssat för termin men inte matat in värde i terminsfältet ges meddelande: Termin saknas När man har kryssat för Födelsedatum-intervall men inte matat in värde i pnr-fälten Födelsedata inte korrekt ifylld När man har kryssat för etableringsdatum men inte matat in värde i datumfältet Etableringsdatum saknas När from födelsedatum är större än tom födelsedatum: Fr o m-födelsedatum får inte vara senare än t o m-födelsedatum.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 13 (22) När etableringsdatum är i framtiden: Etableringsdatum kan inte ligga i framtiden. Hjälptexter: Alla: Söker ut alla interimspersonnummer som har eventuella dubletter. Födelsedataintervall: Söker ut interimspersonnummer som har eventuella dubletter. Etableringsdatum fr o m Söker ut interimspersonnummer som har eventuella dubletter. Aktiva from termin: Söker ut interimspersonnummer som har eventuella dubletter. Alla med samma födelsedatum: Söker fram alla personnummer med samma födelsedatum. From: Födelsedatum from, 6 tecken Tom: Födelsedatum tom, 6 tecken Etableringsdatum: Datum för etablering Termin: Termin 3 tecken. Format TÅÅ,där T=H(höst) och T =V(vår) Uppdatera: Lagrar uppgifter i databasen. 5.3 Utsökning av dubbla pnr i Ladok (batch-delen) För att hämta godkända bokstäver i position 7 i pnr används tabellen INTBOKST. På ladoksidan kan det bara finnas en bokstav i kol INTTKN Läs med INTBOKST.TYP=L Från Nya kan det komma flera godkända bokstäver i kol INTTKN Läs med INTBOKST.TYP=N Hämta upp alla poster tabellen NAMN som har ett vanligt personnummer eller ett interimspersonnummer med en godkänd bokstav på position 7 enligt ovan.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 14 (22) Begränsningar som är gjorda i villkorsformuläret innebär en begänsning av den ovanstående populationen. Den begränsade populationen jämförs sedan med alla pnr som finns i NAMN. Genomför Läsning i tabellen NAMN. Om träff lägger vi ut info enligt fildefinitionen senare i dokumentet. I fältet för meddelande från batchen lägger vi Träff, samma ipnr i Ladok och NyA. Har man valt alla: Läs i tabellen NAMN och jämför upplästa poster med födelsedatum i personnummer (6 första siffrorna) samt 3 första positionerna i förnamn och 3 första positionerna i efternamn. De träffar vi får då listas med pnr, förnamn och efternamn adress, epost samt kön enligt fildefinitionen senare i dokumentet. Epostadress tas från tabellen TELEKOM där KOMTYP = EMAIL. Adress hämtas från tabellen ADRESS. I första hand tas adress med ADRTYP = 4 (folkbokföringsadressen). Har ursprungspersonen mindre än 3 tecken i för eller efternamn så söker vi med de antal bostäver som finns i den personens för- och/eller efternamn Exempel: Har man 680112P200;BO;EK;TESTVÄGEN FBF 20 232 20 TESTSTAD 20;;K Borde det bli träff på: 6801121200;BO;EK;TESTVÄGEN FBF 19 232 19 TESTSTAD 19;;K 6801123214;BO-ANDERS;EK-SON;TESTVÄGEN FBF 11 232 11 TESTSTAD 11;epost@11.se;M 680112T622;BO-ANDERS;EK-SON;TESTVÄGEN FBF 12 232 12 TESTSTAD 12;;K Utgår man däremot ifrån: 680112T622;BO-ANDERS;EK-SON;TESTVÄGEN FBF 12 232 12 TESTSTAD 12;;K Så borde man endast få träff på: 6801123214;BO-ANDERS;EK-SON;TESTVÄGEN FBF 11 232 11 TESTSTAD 11;epost@11.se;M Eftersom man söker med 3 tecken i för och efternamn så kan inte en person med endast 2 tecken vara en möjlig träff. Se sql-sqript nr 44 http://esmaralda.ladok.umu.se:12199/ladok/sql_library/sql_library.jsp?namn=&sort=idnr&sql_sat s=&beskrivning=&kategori=&submit=s%f6k%a0 Har man valt Alla med samma födelsedatum Gör en kontroll på vilka personer som har samma födelsedag. Lista alla personer som har samma födelsedag i tabellen NAMN i resultatfilen. De träffar vi får då listas med Pnr,förnamn och efternamn adress, epost samt kön enligt fildefinitionen senare i dokumentet. där KOMTYP = EMAIL. Adress hämtas från tabellen ADRESS. I första hand tas adress med ADRTYP = 4 (folkbokföringsadressen). Har man valt Aktiva fr o m temin XX: Gör kontroll mot tabellerna GODKPROV,UNDKPROV,FFGKURS,OMKURS,FORTKURS,FFGLIN,OMREGLIN,UBIND RG för att se om personerna är aktiva. Man slår med TERMIN>= termin. Mot GODKPROV och UNDKPROV hämtar man upp personer som PROVDAT>= Datum som hämtas från tabellen TERMIN i fältet UNDFROM.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 15 (22) Man skall även ta med aktiva forskarstuderande. Kontrollera mot AKTIVIT om PROCENT>0% och TERMIN>= <Angiven termin>. Fås ingen träff där skall även kontroll göras mot DOKKURS2 där DATUM >= FROMTERM.TERMIN. Se också sql-sqript nr 41 http://esmaralda.ladok.umu.se:12199/ladok/sql_library/sql_library.jsp?namn=&sort=idnr&sql_sat s=&beskrivning=&kategori=&submit=s%f6k%a0 för ytterligare stöd. Har man valt Pnr-intervall så tas endast de personer med som ligger inom intervallet så tar man bara med personer som finns inom intervallet. Har man valt etableringsdatum så tas personer bara med som har ETABLDAT >=angivet datum. Kombinationer av allt utom Alla uppgifter är möjliga. Genomför Kontroll av sekelsiffra. OBS! Kontrollen gäller dock inte alternativet Alla med samma födelsedatum. 5.4 Hantering av resultatfil 5.4.1 Namn <HSK>_<BATCH_ID>_<YYYYMMDD_TTMMSS> 5.4.2 Innehåll och format Alla personer man får träff på läggs in i filen enl följande: <Pnr>;<förnamn>;<efternamn>;<adress>;<epost>;<kön>. Exempel: 800101-P345;FÖRnamn;EFTernamn;Skolgatan 10 xxxxxxx; FOR.EFT@nisse.se;M 800101-0101;FÖRnamn;EFTernamn; Skolgatan 10 xxxxxxx; FOR.EFT@nisse.se;M 800101-1225;FÖRmednamn;EFTermednamn; Regngatan 10 xxxxxxx;rof.klot@kalle.se;m Filen sparas på servern på den sökväg som anges i ladok.batch.properties vilket på ladokenheten är /export/home01/uniface83/app_server/bs83burr/batchfiles/

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 16 (22) 6 Lista träff med posttypen IPX och där enamn/tnamn skiljer NyA kommer att skicka alla de interimspnr de har tillgång till. Kontroll görs mot tabellen NAMN och efternamn och tilltalsnamn. Läs filen från Nya där posttypen = IPX o Läs NAMN med personnummer i filen. Ta höjd för skräppnr som inte får stoppa behandlingen! o Om bom o Om träff Gå vidare till nästa post i filen Jämför efternamn/förnamn i filen mot NAMN.ENAMN/TNAMN Om exakt lika för bägge namnen Annars Gå vidare till nästa post i filen Den här personen ska ut på listan. Se behandling nedan: För de som gått vidare för behandling görs Validering av personnummer och Validering av sekel. Utskrift i meddelandekolumnen om något fel: Felaktigt personnummer från NyA Felaktig sekelsiffra (<sekelsiffra från NyA-filen>) från NyA Sättet vi ska behandla namnen på är som för IPN-posten. Fälten för alla namnuppgifter ska vara lika långa som för IPN. Om något av namnen är för långt ska efternamn/förnamn skrivas ut sist i meddelande. Rubriken för listan är: Interimspersonnummer(Ipnr) från NyA-systemet som finns i Ladok. Eftersom namnuppgifterna inte stämmer ska identitet och namn kontrolleras. Ordningen och kolumnrubriker i listan är: Ipnr från NyA Aktuellt Pnr i NyA Enamn i NyA

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 17 (22) Tnamn i NyA Kön i NyA Enamn i Ladok Tnamn i Ladok Meddelande Om status = Byte, lägg ut i ordning o Personnummer o Aktuellt personnummer o Efternamn o Förnamn o Kön o NAMN.ENAMN o NAMN.TNAMN o Byte av Pnr i NyA. o Om efternamn/förnamn saknas lägg även ut: Namnuppgifter saknas i meddelande o Eventuellt Felaktigt personnummer från NyA o Eventuellt Felaktig sekelsiffra (<sekelsiffra från NyA-filen>) från NyA o Eventuellt långt efternamn/förnamn från NyA Om status = Skydd, lägg ut i ordning o Personnummer o Kön o NAMN.ENAMN o NAMN.TNAMN o Skyddad i NyA o Eventuellt Felaktigt personnummer från NyA o Eventuellt Felaktig sekelsiffra (<sekelsiffra från NyA-filen>) från NyA o OBS! Inget eventuellt långt enamn/förnamn läggs ut i meddelande Om status = Borttagen, lägg ut i ordning o Personnummer o Efternamn o Förnamn

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 18 (22) o Kön o NAMN.ENAMN o NAMN.TNAMN o Borttagen i NyA. o Om efternamn/förnamn saknas lägg även ut: Namnuppgifter saknas i meddelande o Eventuellt Felaktigt personnummer från NyA o Eventuellt Felaktig sekelsiffra (<sekelsiffra från NyA-filen>) från NyA o Eventuellt långt efternamn/förnamn från NyA Om status = Alias, lägg ut i ordning o Personnummer o Efternamn o Förnamn o Kön o NAMN.ENAMN o NAMN.TNAMN o Aliaspnr, det finns ett annat pnr i NyA som är skyddat. o Om efternamn/förnamn saknas lägg även ut: Namnuppgifter saknas i meddelande o Eventuellt Felaktigt personnummer från NyA o Eventuellt Felaktig sekelsiffra (<sekelsiffra från NyA-filen>) från NyA o Eventuellt långt efternamn/förnamn från NyA Om status = blank, lägg ut i ordning o Personnummer o Aktuellt personnummer o Efternamn o Förnamn o Kön o NAMN.ENAMN o NAMN.TNAMN o Om efternamn/förnamn saknas lägg även ut: Namnuppgifter saknas i meddelande o Eventuellt Felaktigt personnummer från NyA o Eventuellt Felaktig sekelsiffra (<sekelsiffra från NyA-filen>) från NyA o Eventuellt långt efternamn/förnamn från NyA

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 19 (22) 7 Lista nationella ipnr i Ladok som inte finns i NyA-filen som posttypen TNR Läs NAMN där pos 7 i PNR <> numeriskt vilket betyder att det är ett ipnr o Kontrollera i INTBOKST om det är ett nationellt ipnr som vi vill ha INTBOKST.INTTKN = Aktuellt tkn i pos 7 Om bom Läs nästa NAMN Om träff och INTBOKST <> N Läs nästa NAMN Annars så har vi ett nationellt ipnr som vi fortsätter att behandla Kontrollera det nationella ipnr som vi sållat fram genom att söka efter detta i TNR-filen o Kolla mot TNR.personnummer o Kolla mot TNR.aktuellt ipnr o Om träff i någon av dessa Läs nästa NAMN o Annars så har vi ett ipnr som ska ut på listan. Se behandling nedan Rubriken för listan är: Nationella interimspersonnummer(ipnr) i Ladok som inte finns i NyA-systemet. Dessa är felaktigt skapade i NyA (under en period kunde det skapas Ipnr utan att det sparades i NyA) generera ett nytt Ipnr i NyA och byt det felaktiga i Ladok. OBS: det måste vara ett spårlöst byte! Ordningen och kolumnrubriker i listan är: Ipnr i Ladok Enamn i Ladok Tnamn i Ladok

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 20 (22) 8 Återkoppling till batchbeställaren Batchbeställaren får återkoppling dels genom e-postmeddelande, dels genom fellista. 8.1 Efterbehandling och epostmeddelande Om något inte fungerar i samband med körningen av batchen skall programmet avslutas och Mail ska skickas med status AVBRUTEN och beställning sätts till A i BATCHJOB Utseende på mailet ska vara som nedan E-postmeddelande skickas till den eller de adresser som angivits i BATINST. Om ingen e-post adress angivits i BATINST ska e-post adressen hämtas från ANVIP.EPOSTADR för användaren som lagt upp batchbeställningen. Skulle e-post adress saknas i ovanstående tabell kan inget mail skickas. Generellt gäller följande: FROM: mail adress, hämtas från properties filen. SENT: Dag, månad år samt tid hämtas från serverklockan TO: Mottagaren hämtas från BATVILL i förstahand och i andra hand ANVIP SUBJECT: Inleds med [BATCH] för enklare sortering och därefter: o Funktionsbeteckning med funktionsnamnet. Beteckning finns i BATCHJOB men bara de första fyra ska användas. Namnet hämtas från NOVFUNK där slagningen sker med hela BATCHJOB.FUNKTION o Batchbeteckningen hämtas från BATCHJOB.BETECKN o Status ska informera hur körningen gått t ex KLAR eller avbrutits I mailet ska det också framgå när batchen startade och avslutades Exempel mailutseende: From: [Mailadress] [mailto:[mailadress]] Sent: den [Dag] [månad][åååå] TT:MM To: [Mottagare] Subject: [BATCH][Funktion (del)funktionsnamn], [batch beteckning],[status] ---------------------------------------------------------------- Detta är ett automatgenererat meddelande som du inte kan svara på. Körningen blev [Status] Körningen påbörjades TT:MM och avslutades TT:MM Följande var med i beställningen: [Villkor?] [om allt gått bra] [tabell] [Antal poster totalt] st

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 21 (22) Efter avslutad körning (dvs allt har fungerat) skall: tabellen BATCHJOB uppdateras: o KORDMARK = J o STARTID = [tiden som batchen verkligen startade (TTMMSS)] o SLUTTID = [tiden som batchen verkligen avslutades (TTMMSS)] e-postmeddelande skickas till den eller de adresser som angivits i BATINST. o Om ingen e-post adress angivits i BATINST ska e-post adressen hämtas från ANVIP.EPOSTADR för användaren som lagt upp batchbeställningen. Skulle e-post adress saknas i ovanstående tabell kan inget mail skickas. 8.2 Fellista Fellista skrivs ut. Den hämtas enligt det standardiserat sätt: knapp/menyalternativ Hämta fil. Exempel fellista utseende: UMEA UNIVERSITET, LE UB80 Dubbla personnummer 2007-03-13 FEL- OCH VARNINGSLISTA Personnummer Typ av fel ----------------------------------------------------- 711312-8457 Felaktigt personnummer 711232-8457 Felaktigt personnummer 9 Generella kontroller 9.1 Validering av personnummer Kontrollera att pnr följer standardformat för pnr. 9.2 Läsning i tabellen NAMN Läs tabellen NAMN med aktuell persons pnr. Personen får inte vara avliden. 9.3 Validering av etableringsdatum Kontrollera att datum följer standardformat för datum. 9.4 Validering av födelsedatum Kontrollera att födelsedatum är numeriskt och att månadssiffran är mellan 1-12 samt att dagsiffran är 1-31.

Jörgen Sondell 2016-06-29 UB80_kravspec.doc 22 (22) 9.5 Jämförelsekontroll av etableringsdatum Kontrollera att etableringsdatum är mindre eller lika med dagens datum 9.6 Validering av sekel Kontrollera att sekel är 19 eller 20 annars skriv till fellista med meddelande: Felaktig sekelsiffra (<sekelsiffra från VHS-filen>) från VHS. 9.7 Kontroll av sekelsiffra Kontroll ska göras på sekelsiffra på de personer som är möjliga träffar innan de listas i filen. Missstämmer sekelsiffran så anses det inte vara någon träff. Öppna frågor: Besvarade frågor: Fråga 1 Är det bara pnr med högskolespecifikt tecken (INTTKN.EGENHSK) som vi ska leta dubletter på eller även alla andra och bör vi kanske isåfall dela upp dem i olika sökningar? Svar: Ja Fråga2 Om vi valt alternativet Aktiva ska vi även ta med forskare och de som finns i annan utbildning? Svar: Vi ska även ta med forskare men inte de i Annan utbildning. Fråga 3 Under 6.7- Räcker de uppgifter jag skrivit in där som information i filen Svar :Ja