5.3 Release Notes

5.3 Release Notes

Datum

Följande datum gäller för införandet av releasen.

Miljö

Datum för införande

Miljö

Datum för införande

NTjP QA

Apr 8, 2025

Produktion

May 20, 2025

Förändringar av Tjänstekontrakt och REST-tjänster

Följande förändringar gäller funktionalitet via Tjänstekontrakt, REST-tjänster eller generell funktionalitet i Personuppgiftstjänsten. Alla förändringar gäller samtliga domänversioner, om ingenting annat anges. I de fall tjänstekontrakt finns i både en variant “Unrestricted” och en variant utan det suffixet så gäller förändringarna båda varianterna, om ingenting annat anges.

Uppdatering av utvandrade personposter

Bakgrund

När Personuppgiftstjänsten ursprungligen infördes så gjordes det aktiva valet att inte hålla utvandrade personposter uppdaterade från Skatteverket. Detta har dock visat sig ge negativa konsekvenser. Skatteverket kan nämligen uppdatera till exempel relationen “Vårdnadshavare för” även på utvandrade personer, vilket då inte Personuppgiftstjänsten har fått kännedom om.

Sommaren 2022 kompletterade Inera därför beställningen mot Skatteverket så att uppdateringar sedan dess fås även för utvandrade (och avlidna). Innan dess har vi dock inte fått uppdateringar för utvandrade, så Personuppgiftstjänsten har kunnat innehålla personposter med icke uppdaterad information.

Förändring

För att komma ikapp alla förändringar som Skatteverket gjort så görs i samband med produktionssättning av denna release en engångs-slagning på alla Utvandrade personer i Personuppgiftstjänsten. Tjänsten hålls sedan löpande uppdaterad genom Skatteverkets normala aviseringar, som numera inkluderar även utvandrade (och avlidna) personer.

GetPersonsByFile/SearchPersonsByFile kan returnera testpersoner

Bakgrund

REST-tjänsten GetPersonsByFile/SearchPersonsByFile har tidigare haft följande begränsning:

SearchPersonsByFile och GetPersonsByFile har ej stöd för sökning mot personposter med testIndicator=true, dvs personidentiteter som i testmiljö kallas testpersoner och i produktionsmiljö kallas valideringspersoner. En sökning mot sådan identitet kommer inte att returnera någon personRecord oavsett om personposten finns i databasen eller ej, dvs svaret ser alltid ut som att ingen träff fanns på denna identitet. För tester av någon av dessa funktioner behöver istället testpersoner med testIndicator=false användas.

Syftet med denna begränsningen var att det inte skulle kunna uppstå någon sammanblandning av valideringspersoner och riktiga personer vid bulkhämtning av personuppgifter i produktionsmiljön. Konsekvensen har samtidigt varit att testmöjligheter av denna REST-tjänst i testmiljön starkt har begränsats.

Förändring

REST-tjänsterna getPersonsByFile/searchPersonsByFile har utökats med en frivillig parameter som heter “includeTestIdentities”. Om parametern saknas eller är satt till false så returneras inga personRecord för testpersoner av tjänsten, vilket motsvarar det tidigare beteendet hos dessa REST-tjänster. Om parametern däremot är satt till true så returneras även testpersoner (testIndicator=false).

REST-tjänster: Rättning av dubbla Transfer-Encoding chunked

Samtliga REST-tjänster har i HTTP-header för sina svar kunnat innehålla dubbletter av raden Transfer-Encoding: chunked, vilket är ett formellt fel.

Se rad 11 samt 18 i följande exempel:

HTTP/1.1 200  Vary: Origin Vary: Access-Control-Request-Method Vary: Access-Control-Request-Headers X-XSS-Protection: 1; mode=block Content-Security-Policy: frame-ancestors 'none';block-all-mixed-content;sandbox allow-downloads allow-scripts allow-same-origin allow-forms allow-popups;connect-src 'self';default-src 'self';script-src 'self' 'unsafe-inline';style-src 'self' 'unsafe-inline';img-src 'self' data:;object-src 'none'; X-Frame-Options: DENY Referrer-Policy: strict-origin Strict-Transport-Security: max-age=31536000 ; includeSubDomains Feature-Policy: accelerometer 'none'; camera 'none'; geolocation 'none'; gyroscope 'none'; magnetometer 'none'; microphone 'none'; payment 'none'; usb 'none'; Transfer-Encoding: chunked Content-Disposition: attachment;filename=0704-TO42-15432461_20240704-1.zip Pragma: private Cache-Control: private, must-revalidate Expires: 0 X-Content-Type-Options: nosniff Content-Type: application/zip Transfer-Encoding: chunked Date: Thu, 04 Jul 2024 13:43:27 GMT

Samtliga REST-tjänster har nu uppdaterats för att undvika detta beteende.

SearchPersonsForProfile: Åtgärdat långsamma frågor på födelsedatum

Sökningar som i sin SimpleQL-fråga omfattat attributet för födelsedatum, dateOfBirth, har kunnat gå långsamt. Detta har nu optimerats i databasen.

LRID-förändring Sörmland

Region Sörmlands LRID “Region Sörmland Katastrof” har fått ett uppdaterat format och reguljärt uttryck för validering (Regex).

Huvudman

Lång-namn

Kort-namn

OID

Sörmland

Region Sörmland Katastrof

RSK

1.2.752.266.1.1.2

Format:

PPPPPPPPBNNN

PPPPPPPP = Prefix 18900101 och 18500101
B = Bokstav A till Z
NNN = Löpnummer (000-999)

Exempel:
18900101A673 – katastrofnummer
18900101D119 – katastrofnummer
18900101Z119 – katastrofnummer

Regex:
^(18500101|18900101)[A-Z]([0-9][0-9][0-9])$

SimpleQL: Tillåter sökningar på strängar som inleds med plustecken

Tidigare gick det inte att med SimpleQL göra sökningar på strängar med inledande plustecken (+), vilket särskilt påverkade möjligheten att söka på telefonnummer som börjar med plustecken för landskod. Det är nu åtgärdat och sådan sökning fungerar både med operand “=” och “LIKE”.

Förändringar i PU Webb användargränssnitt

Följande förändringar har gjorts i Ineras kommande grafiska gränssnitt för Personuppgiftstjänsten, PU Webb, som nu testas och utvärderas av Regionerna. Det äldre gränssnittet, benämnt PU GUI, berörs inte av dessa förändringar.

PU Webb: Borttagning av attribut Riksnycklar

Attributet Riksnycklar är borttaget både i vyer som visar attribut på personposter och ur PDF-rapporter. Riksnycklar finns inte längre hos Skatteverket, och detta är ett första steg i en fullständig avveckling av attributet ur Personuppgiftstjänsten.

PU Webb: Formatstyrning av LMA-nr

Förstärkt validering av hanteringen LMA-nummer i PU Webb, så att dessa konsekvent lagras och visas med bindestreck, dvs på formatet NN-NNNNNN.

Observera att tjänstekontrakten fortfarande inte validerar formatet, dvs andra anslutna system till Personuppgiftstjänsten har teknisk möjlighet att lagra LMA-nummer på felaktigt format.

En konsekvens av valideringen är att om en användare via PU Webb redigerar uppgifter på en reservidentitet som tidigare eller via annat anslutet system har ett LMA-nummer med felaktigt format, så kommer PU Webb inte tillåta att ändringar i personposten sparas innan även LMA-numret korrigerats. PU Webb visar att LMA-numret har fel format genom att det i Ändra-menyn visas en röd markering på alternativet Identitetsstyrkning, samt ger en röd kontur runt den aktuella identiteten.

image-20250416-090945.png
Bild: Markering av ett felaktigt formaterat LMA-nummer

PU Webb: Avancerad sök kan söka på telefonnummer/e-post

Avancerad sök i PU Webb ger nu även möjlighet att söka på telefonnummer eller e-post. Det nya sökfältet “Kontaktinformation” används för att söka på båda dessa.

image-20250416-084129.png
Bild: Det nya fältets placering i Avancerad sök

PU Webb: Återinläsning av sida (F5) nu möjlig

PU Webb stödjer nu att användaren gör återinläsning av webbsidan (så kallad F5/refresh). Om detta görs när användaren är i redigeringsläge åker man ut ur redigeringsläget utan att något blir sparat.

PU Webb: Förbättrad sökbarhet för adressfält

PU Webb har nu förbättrad hantering av sökning på adresser, som tidigare kunde ta lång tid eller ge time out. Problemet hade att göra med att långa addresser kan delas upp i två adressfält (adressrad1 samt adressrad2) hos Skatteverket.

Sökning kan göras utan hänsyn till stor eller liten bokstav, och det är möjligt att använda asterisk (*) som wildcard-tecken i slutet på ett sökord.

En kvarvarande begränsning är att sökningar inte kan göras på text mitt i en adress, vilket särskilt påverkar adresser som hos Skatteverket är uppdelade på två rader. I PU Webb kommer dessa att vara sökbara på så sätt att adressrad2 följs av adressrad1.

Exempel: En adress med adressrad1 “SÖDRA FJÄLLGÅRDSVÄGEN” och adressrad2 “VEMDALSSKALET 168” blir sökbar som “VEMDALSSKALET 168*”. Det går alltså inte att hitta adressen genom sökning på “SÖDRA FJÄLLGÅRDSVÄGEN*”, utan sökningen måste matcha början på adressen i adressrad2. Sökning på fullständiga adressen “VEMDALSSKALET 168 SÖDRA FJÄLLGÅRDSVÄGEN” skulle också ge en träff.

PU Webb: Nya ledtexter

Följande två nya ledtexter har införts i PU Webb.

image-20250416-103223.png
Bild: Ny informationstext (här inringad i gult) om funktionen Avregistrering.
image-20250416-103628.png
Bild: Ny informationstext (här inrigad i gult) om funktionen “Lägg till relation”

PU Webb: Utökade behörighetsgrupper

Två nya behörighetsgrupper i PU Webb tillkommer:

PU;RedigeraIDhandling ger behörighet att ändra eller ta bort en inlagd identitetsstyrkning av en reservidentitet. Tidigare gavs den behörigheten genom PU;ReservID men har nu brutits ut.

PU;AvregistreraReservID ger behörighet att avregistrera reservidentiteter. Tidigare gavs den behörigheten genom PU;ReservID men har nu brutits ut.

Användarnas behöver ges ett Administrativt medarbetaruppdrag som i sin tur har korrekt satt kod för behörighetsområdesegenskap.

Se uppdaterad tabell för behörighetsgrupper nedan.

Administrativt medarbetaruppdrag
Kod för behörighetsområdesegenskap

Vårdmedarbetaruppdrag
Individuell egenskap för it-tjänster
(Nya behörigheter skall ej tilldelas på detta sätt)

Funktion i Personuppgiftsjänsten Webb
Som respektive egenskap/kod ger åtkomst till

Administrativt medarbetaruppdrag
Kod för behörighetsområdesegenskap

Vårdmedarbetaruppdrag
Individuell egenskap för it-tjänster
(Nya behörigheter skall ej tilldelas på detta sätt)

Funktion i Personuppgiftsjänsten Webb
Som respektive egenskap/kod ger åtkomst till

PU;Sök

PU;Sökning

Sök och visa identitet

 

 

Ändra kontaktuppgifter

 

 

Exportera PDF

 

 

 

PU;ReservID

 PU;UppdateraId

Sök och visa identitet

 

 

Ändra kontaktuppgifter

 

 

Exportera PDF

 

 

Skapa NRID

 

 

Ändra NRID

 

 

Lägga till LRID

 

 

Ändra LRID

 

 

 

PU;KopplaID

 PU;KopplaId

Sök och visa identitet

 

 

Ändra kontaktuppgifter

 

 

Exportera PDF

 

 

Skapa NRID

 

 

Ändra NRID

 

 

Lägga till LRID

 

 

Ändra LRID

 

 

Koppla/länka identitet

 

 

Avregistrera reservidentitet (övergår till att styras via administrativt medarbetaruppdrag med PU;AvregistreraReservID i produktionsmiljö den 20 maj)

 

 

Ändra/ta bort identitetsstyrkning (övergår till att styras via administrativt medarbetaruppdrag med PU;RedigeraIDhandling i produktionsmiljö den 20 maj)

 

 

Lägga till identitetsstyrkning

 

 

 

PU;Testpersoner

 PU;Testpersoner

Sök och visa identitet

 

 

Ändra kontaktuppgifter

 

 

Exportera PDF

 

 

Exportera testperson

 

 

Ändra testperson

 

 

 

PU;AvregistreraReservID

OBS - Denna funktionalitet finns ännu endast i testmiljön, planeras i produktion den 20 maj 2025

 

Sök och visa identitet

 

 

Ändra kontaktuppgifter

 

 

Exportera PDF

 

 

Skapa NRID

 

 

Ändra NRID

 

 

Lägga till LRID

 

 

Ändra LRID

 

 

Avregistrera reservidentitet

 

 

 

PU;RedigeraIDhandling

OBS - Denna funktionalitet finns ännu endast i testmiljön, planeras i produktion den 20 maj 2025

 

Sök och visa identitet

 

 

Ändra kontaktuppgifter

 

 

Exportera PDF

 

 

Skapa NRID

 

 

Ändra NRID

 

 

Lägga till LRID

 

 

Ändra LRID

 

 

Koppla/länka identitet

 

 

Ändra/ta bort identitetsstyrkning

PU Webb: Hantering av checkbox "Inkl. testpersoner"

Bakgrund

Vid Avancerad sök i PU Webb har det längst ned hittills funnits en checkbox “Inkl. testpersoner” som styr om sökningen ska ge träff på personer med testIndicator=true eller ej.

image-20250128-160059.png
Bild: Aktuell kryssruta visas längst ned

Värdet av att kunna välja detta manuellt är dock tveksamt, och samtidigt finns en risk att användare inte förstår vad kryssrutan innebär eller att de inte lägger märke till den och då inte får de sökresultat de förväntar sig.

Förändring

Kryssrutan “Inkl. testpersoner” tas bort ur Avancerad sök, och PU Webb kommer istället att göra följande beroende på om det är testmiljö eller produktionsmiljö:

  • Testmiljö

    • Inkluderar alltid testpersoner (testIndicator=true).

  • Produktionsmiljö

    • Inkluderar aldrig testpersoner (testIndicator=true). Men notera att det fortfarande kommer att gå att göra standard-sökning på ett specifikt id och då hitta dessa valideringspersoner i Prod. De kommer dock inte att riskera dyka upp i avancerade sökningar som en användare gjort utifrån kriterier.

PU Webb: Utökad beskrivning av aktivering av testperson

Texten som beskriver funktionerna under menyn Admin → Uppdatera testpersoner har uppdaterats för att vara tydligare.

image-20250416-132108.png
Bild: Vy över sidan med de uppdaterade hjälptexterna

PU Webb: Striktare validering av telefonnummer

PU Webb tillåter nu inte att telefonnummer inleds med 00, utan internationellt prefix skall alltid anges med plustecken (+). För Svenska telefonnummer är det även godkänt att ange dessa med endast en inledande nolla, tex 070, vilket PU Webb sedan kommer att lagra som +46 i PU-tjänsten för att följa ramverket för kontaktuppgifter.

När användaren i PU Webb redigerar eller lägger upp ett nytt telefonnummer visas även en ledtext enligt bild nedan om formatkontrollen inte uppfylls.

image-20250416-201900.png
Bild: Ledtext när ett telefonnummer läggs in och formatkontrollen inte godkänner numret.

Observera att PU-tjänstens tjänstekontrakt ännu inte gör motsvarande formatkontroll, så det är tills vidare möjligt att andra anslutna system lagrar telefonnummer med felaktigt format.

PU Webb: Enhetsnamn på administrativa medarbetaruppdrag

Vid inloggning i PU Webb är listan med valbara Administrativa uppdrag nu ändrad så att den förutom enhetens HSA:id även visar enhetens namn, vilket gör det lättare att välja rätt uppdrag. Väljaren dyker som tidigare bara upp om medarbetaren har fler än ett Administrativt uppdrag.

image-20250416-083849.png
Bild: Val av Administrativt medarbetaruppdrag visar nu även enhetens namn

PU Webb: Rättat namn på knapp för inloggning med "Vårdmedarbetaruppdrag"

Knappen för inloggning via Vårdmedarbetaruppdrag har rättat namn.

image-20250416-151637.png
Bild: Rättade namnet på Vårdmedarbetaruppdrag