Version 1.0 August 2013
Version 1.0 August 2013 Overblik over NSP Service: NSP Test Service (NTS) |
Kort introduktion til service | |||||||
---|---|---|---|---|---|---|---|
NSP Test Service (NTS) bruges til at verificere korrektheden af et DGWS 1.0.1 SOAP-request.
NTS validerer det DGWS-specifikke information i SOAP-headeren for det SOAP-request, som sendes til den. Indholdet i SOAPbody er udenfor valideringen. Der udføres kontrol på følgende:
Ved henvendelser fra anvendere, hvor der, for anvendere, opleves problemer med at kalde en service på NSP kan NTS bringes i anvendelse, som et værktøj til at hjælpe anvenderen videre. Dette gøres i praksis ved, at anvenderes request sendes til NTS istedet for til den oprindelige service. NTS afleverer et svar der uddyber, hvad der måtte være forkert i requestet. Svaret kan enten bruges direkte af supportfunktionen i dialogen med anvender eller som yderligere information videre i supportkæden. I sidstnævnte tilfælde skal NTS svaret indsættes i supportsagen.
| |||||||
Komponent og versioner | |||||||
NTS er tilgængelig på URL’en: http://<host>/nts/service, hvor <host> erstattes med konkrete miljø, f.eks.:test2.ekstern-test.nspop.dk:8080. Tilsvarende er WSDL for servicen tilgængelig på http://<host>/nts/service?wsdl NTS kan kaldes som enhver anden WebService på den nævnte eller tilsvarende URL. Det kan i praksis foregå med det værktøj anvender finder belejligt, eksempelvis curl, SOAP-UI eller egen kode. DGWS SOAP-requestet skal indeholde, hvad anvender ellers ville sende til enhver anden service på NSP. I svaret fra NTS vil resultatet af valideringen af DGWS SOAP-requestet fremgåi SOAP-body på response.
| |||||||
Kontaktoplysninger, servicebeskrivelse og testforhold | |||||||
Et eksempel på kald til NTS med brug af curl, hvor SOAP-body i DGWS SOAP-requestet er tom:
hvilket giver følgende resultat:
Værd at bemærke er følgende header-element:
Det kan her ses, at <Environment>-elementet angiver, hvilken miljø-type NTS befinder sig på. Mulighederne er TEST eller PRODUCTION. Endvidere kan det bemærkes at NTS benytter sig af SEAL version 2.1.6, som det ses i tagget <SEAL-Version>, og er selv version 1.0.0, som det ses i tagget <NTS-Version>. Resultatet af valideringen ses i responsets SOAP-body, som værdi for et eller flere <medcom:FaultCode>-tags.
Fejl er opdelt i kategorier, som vedrører bestemte tekniske områder i DGWS SOAP-requestet, eksempelvis:
Et eksempel på et resultat, hvor der optræder flere samtidige fejlbeskeder:
Her ses, at der er problemer med ID-kortets gyldighed:
og signaturen på ID-kortet kan ikke valideres:
og der er problemer med formateringen af XML’en i ID-kortet:
Der findes en mængde andre fejlbeskeder, som ligger udenfor dette dokument at give eksempel på. |