...

Version 1.2, 2017-03-14

Anchor
_Toc477258559 _Toc477258559

Indholdsfortegnelse

Anchor
_GoBack _GoBack

...

Slutbrugerne er i denne sammenhæng f.eks. udviklere og arkitekter hos leverandører, som ønsker at integrere til BRS.
Det forudsættes at læseren kender til Den Gode Webservice (DGWS) og den nationale serviceplatform (NSP).

Anchor
_Toc477258563 _Toc477258563

Snitfladebeskrivelse

Behandlingsrelationsservicen giver mulighed for at bestille opfølgninger gennem brug af notifikationsservicen. Da det forventes at denne option vil blive brugt af de fleste anvendere, er begge snitflader dokumenteret nedenfor.
Bemærk at der refereres til teknisk dokumentation af snitfladeelementerne i afsnittene nedenfor med referencer sat i anførselstegn. Disse referencer peger på BRS-projektet på nspop, og det følgende præfiks er underforstået i referencerne:
{*}{+}https://svn.nspop.dk/public/components/brs/latest/code/+*

Anchor
_Toc477258564 _Toc477258564

Behandlingsrelationsservice

Anchor
_Toc477258565 _Toc477258565

Endpoint

Behandlingsrelationsservicen kan tilgås i de decentrale NSP-miljøer (dNSP) under adressen
*\[miljøurl\]/brs-nsp/service/brs*
\\
hvor den stiller operationen "treatmentRelation" til rådighed. Denne operation tager en soap besked som input, indeholdende en header og en body. Headeren indeholder en wsse header samt en medcom header som specificeret i Den Gode Webservice (DGWS) version 1.0.1. IDKortet i headeren skal være på niveau 3 og udstedt af SOSI-STS. WSDL findes ved at tilføje "?wsdl"-postfix til adressen.
Eksempel på endpoint i testmiljøerne (dNSP i TEST2-miljøet):
*http://test2-dnsp.ekstern-test.nspop.dk:8080/brs-nsp/service/brs*

Anchor
_Toc477258566 _Toc477258566

treatmentRelationRequestBody

Body er defineret som et element af typen treatmentRelationRequestBody, der er en complexType indeholdende en række felter, er specificeret i
"common/src/main/resources/xsd/"
Frem for at læse disse foreslås det at studere eksemplet på en korrekt forespørgsel i
"doc/brs/bilag/requests-and-responses/"
En korrekt forespørgsel skal indeholde informationer om følgende:

Anchor
_Toc477258567 _Toc477258567

treatmentRelationResponse

Operationen "treatmentRelation" returnerer et treatmentRelationResponse, der opfylder DGWS. Det vil sige, at det har en wsse og en medcom header. Selve svaret er defineret som et treatmentRelationResponseBody som defineret i
"common/src/main/resources/xsd/"
Svaret indeholder information om:

Et eksempel på et svar fra servicen kan findes i
"bilag/requests-and-responses/"
Den komplette wsdl for servicen kan findes i
"common/src/main/resources/wsdl"

...

Anchor
_Toc265831726 _Toc265831726

Anchor
_Toc477258570 _Toc477258570

Endpoint

Notifikationsservicen udstilles på NSP'erne under adressen 
*\[miljøurl\]gos/service/notification*
\\
hvor den sætter operationen "notificationQuery" til rådighed.
Eksempel på endpoint i testmiljøerne (dNSP i TEST2-miljøet):
*http://test2-dnsp.ekstern-test.nspop.dk:8080/gos/service/notification*
_Bemærk: NSP miljøernes loadbalancer router trafikken fra ovennævnte endpoint til brs-nsp/service/notification, idet dette er adressen i BRS2._

Anchor
_Toc265831727 _Toc265831727

Anchor
_Toc477258571 _Toc477258571

Betingelser for kald

...

Body er defineret som et element af typen notificationQueryRequestBody, der er en complexType indeholdende en række felter, der er specificeret i
"common/src/main/resources/xsd/notification/"
Frem for at læse denne foreslås det at studere eksemplet på en korrekt forespørgsel i
"doc/bilag/requests-and-responses/"
En korrekt forespørgsel skal indeholde informationer om følgende:

Anchor
_Toc477258573 _Toc477258573

notificationQueryResponse

Operationen "notificationQuery" returnerer et notificationQueryResponse der opfylder DGWS. Det vil bl.a. sige, at det har en wsse og en medcom header. Selve svaret er defineret som et notificationQueryResponseBody som defineret i
"common/src/main/resources/xsd/notification/"
Svaret indeholder de første 100 notifikationer med serienummer højere end eller lig det der er angivet i forespørgslen. Notifikationerne returneres i sorteret rækkefølge. Hver notifikation indeholder følgende informationer:

Et eksempel på et svar fra servicen kan findes i
"doc/bilag/requests-and-responses/"
Den komplette wsdl for servicen kan findes i
"common/src/main/resources/wsdl"
Notifikationers "payload" er af typen TreatmentRelationAlarm. Skema for dette findes her:
"common/src/main/resources/xsd/brs/treatmentRelationAlarm.xsd"
Dette indeholder følgende elementer:

Anchor
_Toc477258574 _Toc477258574

TreatmentRelationAlarm

Anchor
_Toc477258575 _Toc477258575

TreatmentRelationFollowup

TreatmentRelationFollowup-elementet er af typen beskrevet i
"common/src/main/resources/xsd/brs/treatmentRelationFollowup.xsd"
Denne indeholder felterne:

Anchor
_Toc477258576 _Toc477258576

TreatmentRelationRelayerData

Elementet TreatmentRelationRelayerData indeholder følgende data, der er nok til at identificere de kendte relationer mellem en behandler og en patient.

Anchor
_Toc477258577 _Toc477258577

Format for tidsstempler

Bemærk at formatet på alle tidsstempler (f.eks. TimeLimit og RelationLookupTimeInterval) er som følger: YYYY-MM-DD'T'HH:MM:SS'+'forskydning fra GMT', f.eks. "2013-01-31T22:59:40+02:00"

Anchor
_Toc265831730 _Toc265831730

Anchor
_Toc477258578 _Toc477258578

Fejlkoder

Nedenfor ses en liste af typiske fejl der kan forekomme når en service kaldes. Fejl der returneres indeholder en fejlkode samt en fejltekst med yderligere detaljer. Teksten er ikke medtaget i tabellen nedenfor da den kan variere afhængig af hvad der gav anledning til fejlen.

Anchor
_Toc477258579 _Toc477258579

Eksempler på at kalde services

...

Kilden til dette dokument kan findes på nspop:
{+}https://svn.nspop.dk/svn/trifork/brs/trunk/doc/brs/+