Table of Contents |
---|
SOAP Faults (fra webservices baseret på DFDG.Foundation og udstillet af DFDG, Jobnet og Vitas)
Alle webservicekald, der i selve kaldet resulterer i en fejl, returneres som en SOAP Fault i henhold til WS-i BP 1.1, hvor det er muligt.
- I WS-I Basic Profile 1.1 (BP 1.1) skal serviceudbyderen returnere en SOAP Fault, der overholder BP 1.1, i alle de tilfælde hvor service aftageren forventer et SOAP Response.
- Det er serviceaftageren, der modtager og fortolker fejlbeskrivelsen og evt. videregiver en brugervenlig fejlbesked til slutbrugeren.
- SOAP Fault beskeder skal som udgangspunkt aldrig præsenteres direkte for slutbrugerne i den aftagende applikation.
En fejl returneres således, at SOAP Body’en kun indeholder en SOAP Fault. Serviceaftageren skal tolke en SOAP Fault som værende en fejl, når der i HTTP Response returneres en HTTP Status kode, der indikerer, at der er sket en fejl. De HTTP Status koder, der returneres i forbindelse med fejl, vil være i kategorierne:
- 4xx client error
- 5xx server error
Opbygning af en SOAP Fault:
- Faultcode
Faultcode elementet er tiltænkt at blive brugt i serviceimplementeringen som en algoritmisk mekanisme til at identificere en given fejl.
...
- Detail
Detail elementet bruges til applikationsspecifikke fejl informationer. I disse webservices indeholder Detail elementet et ErrorCode og et Message element.- ErrorCode elementet indeholder en numerisk fejlkode, der entydigt identificerer fejlen. Se Error
- Message elementet giver en tekstuel menneskelig læsbar forklaring af fejlen.
Faultcode oversigt
Her følger en oversigt over de tilgængelige Faultcode betegnelser:
Navn | Betydning |
---|---|
VersionMismatch | Den behandlende part har fundet et invalid namespace for SOAP Envelop elementet. |
MustUnderstand | Et "child" element i SOAP Header elementet der enten ikke blev forstået eller overholdt af den behandlende part indeholdt en SOAP mustUnderstand attribut med værdien "1" |
Client | "Client" indikerer, at meddelelsen var ukorrekt formateret eller ikke indholdsmæssigt lever op til servicekontrakten, således at servicen kunne fortolke forespørgslen korrekt. Dette er generelt en indikation af, at beskeden ikke skal gensendes, før den er modificeret. |
Server | "Server" indikerer, at meddelelsen ikke kunne behandles af årsager, der ikke direkte er knyttet til indeholdet i selve beskeden, men til selve servicen. Dette indikerer at beskeden evt. kan gensendes senere uden modifikation. |
REST / HTTP Errors (fra webservices baseret på STAR.Foundation og udstillet af JobSearch og Taxonomy siloerne)
Alle webservicekald, der i selve kaldet resulterer i en fejl, returneres med en HTTP Status kode, der indikerer, at der er sket en fejl samt med en HTTP Body indeholdende detaljeret information om fejlen (ErrorDetails).
- De HTTP Status koder, der returneres i forbindelse med fejl, vil være i kategorierne:
- 4xx client error
- 5xx server error
- Det er serviceaftageren, der modtager og fortolker den detaljeret information om fejlen og eventuelt videregiver en brugervenlig fejlbesked til slutbrugeren.
- Den detaljeret information om fejlen skal som udgangspunkt aldrig præsenteres direkte for slutbrugerne i den aftagende applikation, med mindre andet ikke er muligt.
En fejl returneres således, at HTTP Body'en kun indeholder detaljeret information om en fejl - også kaldet ErrorDetails. Serviceaftageren skal tolke denne detaljeret information som værende en fejl, uanset hvilket HTTP Status kode, der måtte være returneret.
Opbygning af ErrorDetails:
...
- https://service.bm.dk/pjaktasswcftservice/2/unemploymentbenefitsaccountservice.svc
- https://service.bm.dk/pjaktasswcftservice/20/personstatusservice.svc
- https://job.jobnet.dk/externalservices/1/cvservice.svc
- https://job.jobnet.dk/externalservices/1/personhistoryservice.svc
- https://services-vitas.bm.dk/1/personalassistanceservice.svc
- https://services-vitas.bm.dk/1/mentorservice.svc
Generelle fejl kastet alene af webservices hos DFDG
...
- https://service.bm.dk/pjaktasswcftservice/2/unemploymentbenefitsaccountservice.svc
- https://service.bm.dk/pjaktasswcftservice/20/personstatusservice.svc
Validerings- og sikkerhedsfejl kastet af STAR.Foundation og webservices baseret herpå
...
, dvs. JobSearch
...
, Taxonomy, Borgerkommunikation, Kontaktforloeb osv. (alle nye forretningsdomæner).
Fejlkode | Beskrivelse | HTTP Status kode |
---|---|---|
1010 | Unknown cpr | 401 - Unauthorized |
1011 | Internal error on server | 500 - Internal server error |
1012 | Logon failed | 401 - Unauthorized |
1013 | User has insufficient permissions to access this webservice | 401 - Unauthorized |
1014 | The submitted message is not valid | 400 - Bad request |
1100 | An error has occurred | 400 - Bad request 401 - Unauthorized 500 - Internal server error |
1101 | Client certificate missing from request | 401 - Unauthorized |
2001 | Invalid CodeList name | 500 - Internal server error |
2002 | Invalid CodeList value | 400 - Bad request |
2003 | Use of expired CodeList value not allowed | 400 - Bad request |
4385 | The client does not have an unemploymentfund registration | 401 - Unauthorized |
4575 | You are not authorized to execute the operation | 401 - Unauthorized |
...
SOAP Fault oversigt - fejlkoder
I det følgende angives alle de definerede SOAP Faults fra webservices. I servicekataloget er det for hver webservicemetode angivet de SOAP Faults, der kan returneres. Kun de mest relevante fejl er noteret. SQL Connection fejl og Message Queue fejl er for eksempel ikke noteret. Se følgende liste for komplet beskrivelse af fejlen:
- Se fejlkodeliste her: Error
...
Faultactor i listen er sat til en af følgende:
- http://amportal.bm.dk/
- http://amportal.bm.dk/pjaktass
- http://amportal.bm.dk/tass
- http://amportal.bm.dk/wsrm
- http://service.bm.dk/pjaktasswcf
...