...
| Datum | Version | Namn | Förändring |
|---|
| 2.0 | | Nya svarskoder från och med version 4.3 |
| 2.1 | | Uppdaterat rubrik. |
| 2.2 | | Tagit bort felaktigt fält i felmeddelanden. |
| 2.3 | | Omdefinierad som intern sida för PU-förvaltningen. En extern sida har också skapats, med mindre informationAnpassad för extern publicering. |
Innehåll
...
Se även Best practice i regel 11, RIVTA "Best-practice för felhantering".
Gemensamt för alla interaktioner
Felmeddelanden
Enligt ws Basic Profile v1.1 returneras alla Soap faults med en HTTP 500 error status.
När en användare inte är behörig att anropa tjänsten returneras ett soap:Fault med följande felmeddelande;
Obehörigt anrop för system <systemHsaID>.
Läsande interaktioner
Samtliga läsande interaktioner returnerar en beskrivande text som svar när ett fel uppstår.
Soap svar:
| Kodblock |
|---|
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Client</faultcode>
<faultstring>Beskrivande felmeddelande</faultstring>
</soap:Fault>
</soap:Body>
</soap:Envelope> |
Systemloggar
På servern loggas hela felmeddelandet samt funktionsnamn och en beskrivande text (INFO, felmeddelande).
Ineras tjänsteförvaltningar och leverantörer med tillgång till Ineras Kibanainstallation på elk.drift.inera.se/ (kräver VPN konto) kan själva söka och läsa efter alla testmijlöers loggar.
Indexet heter: ind-*pu*,-ind-ppu-*
...
Felmeddelanden per läsande kontrakt
Vid kända fel returneras ett soap:Fault med faultcode soap:Client samt faultstring med beskrivande felmeddelande enligt följande tabell.
| Kontrakt | Felorsak | Felmeddelande (faultstring |
|---|
)Systemloggar INFO (Kibana| ) |
|---|
| LookupResidentForFullProfile | Listan med personidentiteter innehåller för många element | Listan vid namn personidentiteter innehåller för många element, maxgränsen är maxgräns. |
Validation failed in getPersonsForProfileV1V2. [Listan vid namn personidentiteter innehåller för många element, maxgränsen är maxgräns.] | | Felaktigt format på en personidentitet | Ogiltigt format på personidentitet: 196604072f808 |
Identifier validation failed in getPersonsForProfileV1V2. Ogiltigt format på personidentitet: 196604072f808 | | LookupResidentsForProfile | Inga personidentiteter angivna | Listan med personidentiteter måste innehålla minst ett element. |
Validation failed in getPersonsForProfileV1V2. [Listan med personidentiteter måste innehålla minst ett element.] | | Felaktigt format på personid eller personid saknas |
Ogiltigt format på personidentitet: 123456Identifier validation failed in getPersonsForProfileV1V2. | Ogiltigt format på personidentitet: 123456 |
| Personidentitetstyp saknas |
Personidentitetstypen får inte vara tom.Identifier validation failed in getPersonsForProfileV1V2. | Personidentitetstypen får inte vara tom. |
| Felaktigt format på personidentitetstyp eller personidentitetstyp är tom | Ogiltigt format på personidentitetstypen. |
Identifier validation failed in getPersonsForProfileV1V2. Ogiltigt format på personidentitetstypen | | Tom/ogiltig profiltyp | En giltig profiltyp kunde inte hittas. |
Validation failed in getPersonsForProfileV1V2. [En giltig profiltyp kunde inte hittas.] | Validation failed in getFilesForOrderId. [| GetFilesForOrderId | Orderid saknas eller är tom |
Orderid får inte vara tom. | | Orderid får inte vara tom. |
] |
GetPersonContactInformation GetPersonContactInformationUnrestricted | Personidentitet saknas eller är tom |
Personidentitet får inte vara tom.Validation failed in metodnamn. [| Personidentitet får inte vara tom. |
] |
| Ogiltigt format på personidentitet | Ogiltigt format på personidentitet för angiven typ 1.2.752.129.2.1.3.3 |
Identifier validation failed in metodnamn. Ogiltigt format på personidentitet för angiven typ 1.2.752.129.2.1.3.3 | | Personidentitetstypen saknas eller är tom | Personidentitetstyp får inte vara tom. |
Validation failed in metodnamn. [Personidentitetstyp får inte vara tom.] | | Ogiltigt format på personidentitetstypen | Kan inte hitta angivet OID för 1.2.752.129.2f. |
Identifier validation failed in metodnamn. Kan inte hitta angivet OID för 1.2.752.129.2f. | | Personidentitet och personidentitetstyp matchar inte | Angiven OID 1.2.752.129.2.1.3.3 är inte giltig för identitet 196604072808 |
Identifier validation failed in metodnamn. Angiven OID 1.2.752.129.2.1.3.3 är inte giltig för identitet 196604072808 | | Inga resultat finns att visa | Sökningen resulterade inte i några träffar |
.Person not found metodnamn [Person not found]Validation failed in getPersonsForProfile(Unrestricted). [ |
GetPersonsForProfile GetPersonsForProfileUnrestricted | Inga personidentiteter angivna |
Listan med personidentiteter måste innehålla minst ett element. | | Listan med personidentiteter måste innehålla minst ett element. |
] |
| Personid saknas eller är tom |
Personidentitet får inte vara tom. | Validation failed in getPersonsForProfile(Unrestricted). [| Personidentitet får inte vara tom. |
] |
| Ogiltigt format på personidentitet | Ogiltigt format på personidentitet för angiven typ 1.2.752.129.2.1.3.1 |
Identifier validation failed in getPersonsForProfile(Unrestricted). Ogiltigt format på personidentitet för angiven typ 1.2.752.129.2.1.3.1 | | Personidentitetstyp saknas eller är tom | Personidentitetstyp får inte vara tom. |
Validation failed in getPersonsForProfile(Unrestricted). [Personidentitetstyp får inte vara tom.] | | Ogiltigt format på personidentitetstyp |
Kan inte hitta angivet OID för 1.2.752.129.2f.Identifier validation failed in getPersonsForProfile(Unrestricted). | Kan inte hitta angivet OID för 1.2.752.129.2f. |
| Personidentitet och personidentitetstyp matchar inte | Angiven OID 1.2.752.129.2.1.3.3 är inte giltig för identitet 196604072808 |
Identifier validation failed in getPersonsForProfile(Unrestricted). Angiven OID 1.2.752.129.2.1.3.3 är inte giltig för identitet 196604072808 | | Tom/ogiltig profiltyp | En giltig profiltyp kunde inte hittas. |
Validation failed in getPersonsForProfile(Unrestricted). [En giltig profiltyp kunde inte hittas.]Validation failed in metodnamn. [ |
SearchPersonsForProfile SearchPersonsForProfileUnrestricted SearchPersonsForProfileByOrder SearchPersonsForProfileByOrderUnrestricted | Frågan saknas eller är tom |
Frågan får inte vara tom. | | Frågan får inte vara tom. |
] |
| Ogiltigt format på frågan (ex. FROM uttrycket saknas) | Tolkning av förfrågan misslyckades. Kontrollera syntax och försök igen |
.Query parser failed in metodnamn Not a valid from statement, check syntax |
| Frågespråket saknas eller är tom | Frågespråket får inte vara tom. |
Validation failed in metodnamn. [ får inte vara tom.]Frågespråket | finns inte i systemet | SimpleQR känns inte igen. |
Validation failed in metodnamn. [SimpleQR känns inte igen.] | | Tom/ogiltig profiltyp | En giltig profiltyp kunde inte hittas. |
Validation failed in metodnamn. [En giltig profiltyp kunde inte hittas.]Vid okända fel returneras ett soap:Fault med faultcode soap:Server och faultstring "Internt systemfel" enligt följande exempel;
| Kodblock |
|---|
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Server</faultcode>
<faultstring>Internt systemfel</faultstring>
</soap:Fault>
</soap:Body>
</soap:Envelope> |
Skrivande interaktioner
När en skrivande interaktion går fel på grund av ett okänt fel så returneras ett soap:Fault enligt föregående exempel.
...
Samtliga meddelanden från kända fel returneras i returtypen result.resultText.
Generella fel för alla skrivande interaktioner
Skulle ett anrop mot något av de uppdaterande kontrakten som tar emot en identitet få en felaktig identitet där root inte stämmer överens med formatet på extension returneras följande meddelande:
Personidentiteten är angiven på ogiltigt format.
När versionen som anges vid en uppdatering inte är den senaste:
Valideringsfel, angiven version är inte den senaste.
När ett okänt fel uppstår:
Internt systemfel.(soap:Fault)
När ett värde inte följer specifikationen för given typ:
Värdet för parameter use är inte giltigt. (Där use är ett enum för exempelvis kontaktuppgifter)
Eller mer utförligt med beskrivning av specifikationen:
contactInformation.period -> Minst en av parametrarna start och end måste ha ett värde i formatet YYYY-MM-DD.
LinkPersonIdentity
| Info |
|---|
| title | Nationellt ramverk för hantering av reservidentiteter |
|---|
|
Som stöd vid implementering av interaktioner kring identitetskopplingar har ett nationellt ramverk tagits fram utifrån rutinerna för uttag och hantering av reservidentiteter i ett antal olika antal landsting och regioner. Detta återfinns under Personuppgiftstjänstens sidor för Dokument: https://www.inera.se/personuppgiftstjansten/dokument. Även de filmer som visar tjänstens administrationsgränssnitt i FAQn kan vara till hjälp i arbetet. |
...
Koppla ett lokalt id till ett nationellt id:
Valideringsfel, koppling måste följa hierarkin LRID → NRID → SNR → PNR.
UnlinkPersonIdentity
| Info |
|---|
| title | Nationellt ramverk för hantering av reservidentiteter |
|---|
|
Som stöd vid implementering av interaktioner kring identitetskopplingar har ett nationellt ramverk tagits fram utifrån rutinerna för uttag och hantering av reservidentiteter i ett antal olika antal landsting och regioner. Detta återfinns under Personuppgiftstjänstens sidor för Dokument: https://www.inera.se/personuppgiftstjansten/dokument. Även de filmer som visar tjänstens administrationsgränssnitt i FAQn kan vara till hjälp i arbetet. |
...
Koppla isär en identitet med personnummer/samordningsnummer:
Valideringsfel, isärkoppling mellan personnummer och samordningsnummer är ej tillåtet.
Meddelande vid försök att sätta optoutPaperNotification till sant när det inte finns en contactInformation som har digitalNotification satt till sant.
Det måste finnas en kontaktinformation som kan ta emot de digital aviseringarna.
...