Svarskoder WS PU 4.1-4.2
Se gärna Best practice i regel 11, RIVTA "Best-practice för felhantering".
Läsande interaktioner
Samtliga läsande interaktioner returnerar endast en uuid som svar när ett fel uppstår, i enlighet med ovan nämnd regel 11.
Soap svar:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <soap:Fault> <faultcode>soap:Server</faultcode> <faultstring>d0d6c05c-128f-4616-8351-9d0959254614</faultstring> </soap:Fault> </soap:Body> </soap:Envelope>
Serverloggar
På servern loggas information som kan kopplas till den uuid användaren fick.
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-*
Generella fel för alla läsande interaktioner
Obehörig användare:
PU service exception: not authorized to getFilesForOrderId. (UUID:768a8188-8356-4caf-b03a-350adb7b10a6). Access is denied
Parameter som är obligatorisk saknas:
PU service exception: validation failed in methodName. (UUID:uuid). [Object with name paramName cannot be empty.]
Id som anges är felaktigt:
PU service exception: identifier validation failed in methodName. (UUID:uuid). Ogiltigt format på personidentitet 191212121212 för angiven typ 1.2.752.129.2.1.3.3
Parameter som har ogiltigt värde:
PU service exception: validation failed in methodName. (UUID:uuid). [value unknown.] (exempelvis request med <urn1:queryLanguage>InvalidQueryLanguage</urn1:queryLanguage> istället för SimpleQL)
GetPersonContactInformation
Sökning på ett id som inte finns:
PU service exception: person not found GetPersonContactInformation. (UUID:uuid). [Person not found]
SearchPersonsForProfile/ByOrder/Unrestricted
WARN: Failed to decode query: FROM PersonRecord WHERE personalidentity.esxtension IN ('192205029149','199907028832'); with message: No valid attribute(s) is specified in where clause
PU service exception: query parser failed in searchPersonsForProfileByOrder. (UUID:uuid). No valid attribute(s) is specified in where clause
WARN: Failed to decode query: FRaOM PersonRecord WHERE personalidentity.extension IN ('192205029149','199907028832'); with message: Not a valid from statement, check syntax
PU service exception: query parser failed in searchPersonsForProfileByOrder. (UUID:uuid). Not a valid from statement, check syntax
Skrivande interaktioner
När en skrivande interaktion går fel så returneras alltid en kod ERROR med en sträng som beskriver vad som gick fel, exempelvis:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:response xmlns:ns5="urn:riv:itintegration:registry:1" xmlns:ns4="urn:riv:strategicresourcemanagement:persons:person:3.2" xmlns:ns3="urn:riv:strategicresourcemanagement:persons:person:3.1" xmlns:ns2="urn:riv:strategicresourcemanagement:persons:person:ResponseType:3" xmlns="urn:riv:strategicresourcemanagement:persons:person:3"> <ns2:result> <resultCode>ERROR</resultCode> <resultText>Beskrivande text om vad som gick fel.</resultText> </ns2:result> </ns2:Response> </soap:Body> </soap:Envelope>
Samtliga meddelanden 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.
När en användare inte är behörig att anropa tjänsten:
Obehörig användare.
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 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
Meddelande vid försök till att koppla en person som redan är kopplad till en huvudidentitet:
Valideringsfel, [extension 99002040AAA9 : root 1.2.752.74.9.1] är kopplad till en annan identitet. Använd dess huvudidentitet för att administrera kopplingar.
Länka en identitet till sig själv:
Valideringsfel, identiterna får inte vara identiska.
Skapa en länk där personnummer/samordningsnummer anges som fromIdentity:
Valideringsfel, bara Skatteverket kan utföra en koppling som resulterar i att ett PNR/SNR står som sekundär identitet.
Länka två lokala reservnummer:
Valideringsfel, koppling mellan lokala reservnummer är inte tillåtet.
Länka ett lokalt id till ett nationellt id:
Valideringsfel, koppling måste följa hierarkin LRID → NRID → SNR → PNR.
UnlinkPersonIdentity
Meddelande vid försök att avlänka en identitet från samma identitet:
Valideringsfel, identiterna får inte vara identiska.
Avlänka två identiteter som inte är länkade:
Valideringsfel, identiteten [extension 22760208AAA4 : root 1.2.752.74.9.1] är inte kopplad till angiven huvudidentitet [extension 190302158282 : root 1.2.752.129.2.1.3.1].
Avlänka en identitet som inte har några länkade identiteter:
Valideringsfel, identiteten [extension 196812732391 : root 1.2.752.129.2.1.3.3] har inga kopplingar.
Avlänka en identitet med personnummer/samordningsnummer:
Valideringsfel, isärkoppling mellan personnummer och samordningsnummer är ej tillåtet.
UpdatePersonContactInformation
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.
När digitalNotification för contactPerson.contactInformation sätts till sant:
Digital notifiering kan inte aktiveras för en kontaktperson.
När personen är sekretessmarkerad eller har skyddad folkbokföring:
Valideringsfel, får inte lägga till kontaktinformation för en sekretessmarkerad identitet.