Page History
Navitabs | ||||||
---|---|---|---|---|---|---|
| ||||||
Indhold
Table of Contents |
---|
Indledning
Dette dokument indeholder beskrivelse af, hvordan løsningen anvendes.
Læsevejledning
Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til webservices herunder xml. Dokumentation som falder udenfor dette dokuments område kan findes på:
...
Man skal gennemlæse vejledningsdokumentet.
Dokumenthistorik
Version | Dato | Ansvarlig | Beskrivelse |
1.5 | 26-04-2019 | Openminds | Tilføjelse af MinLog1 lookup |
1.4 | 07-09-2018 | Openminds | Yderligere specifikation af borgerservice |
1.3 | 12-11-2017 | Openminds | Ny service |
1.2 | 04-10-2017 | Openminds | Skemaændringer i forbindelse med PersonIdentifiers |
1.1 | 26-06-2017 | Openminds | Tilføjelse af skemabeskrivelse og flere xml eksempler |
1.0 | 15-06-2017 | Openminds |
Definitioner og forkortelser
Definition | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
Registration
Denne service anvendes til registrering af log hændelser.
Adresser
Servicen er kan findes på:
https://<host>:<port>/minlog2-registration/RegisterService
og wsdl'en på:
https://<host>:<port>/minlog2-registration/RegisterService?wsdl
Autentifikation og autorisation
RegisterService autentifikation sikres med IDCard i SOAP header, som det er standard på NSP. Beskrivelsen af dette ligger uden for dette dokuments område.
RegisterService kræver autentifikationsniveau niveau 3 (VOCES eller FOCES).
BeskedsID
Kaldere af servicen er forpligtet til at forsyne hvert kald med et unikt beskedsID (messageID) i medcom headeren. Dette er standard NSP og beskrivelsen ligger uden for nærværende dokuments område.
Skemabeskrivelse
Skemaet til Registration kan findes gennem servicen:
...
Efterfølgende beskrives indholdet i body delen af soap beskeden.
Request
Følgende elementer anvendes i registreringen:
Navn | Beskrivelse | Definition | Kardinalitet |
RegistrationRequest | Rod-element for forespørgslen. Indeholder 1 eller flere LogDataEntry-elementer | 1 | |
LogDataEntry | Indeholder data til registrering af en handling. | 1-* | |
Source | Element der indeholder information omkring det kaldende system, kilde systemet. | 0-1 | |
Source/Source[/...] | Source-elementet kan igen indeholde et source-element. Dette anvendes såfremt kildesystemet igen er kaldt af et andet system. | 0-* Vær opmærksom på en tiltænkt begrænsning på 3. | |
Source/ SystemName | Navn, evt. forkortet, for det anvendte kilde-system | Streng med max længde på 25 tegn | 0-1 |
Source/ CorrelationId | Et teknisk id, medsendt fra kildessytemetet. Værdien anvendes til at identificere den sammenhæng som handlingen er gennemført i, eksempelvis et id for behandlingen eller indlæggelsen (EPJ) eller kontakten (LPS). | Streng med max længde på 46 tegn. | 0-1 |
Destination | Element der indeholder information omkring og fra det kaldte system, destinations-systemet, dvs. det system der foretager logningen. | 1 | |
Destination/ SystemName | Navn, evt. forkortet, for det anvendte system, f.eks. "FMK". | Streng med max længde på 25 tegn | 1 |
Destination/Activity | Tekst der beskriver den handling, som brugeren har udført eller forsøgt udført på kildesystemet. | Streng, max længde på 75 tegn | 1 |
Destination/ Reason | Optionel tekst der beskriver årsagen til den handling, som brugeren har udført eller forsøgt udført på kildesystemet. | Streng, max længde på 50 tegn | 0-1 |
Destination/ Criticality | Niveau for kritikalitet, aktuelt kun "Privatmarkeret" | Streng, defineret som en union af en enumeration af niveau for kritikalitet, og en Streng med max længde 50 tegn | 0-1 |
Destination/Addition | Angivelse af type af opslag som tilføjelse til kritikalitet, aktuelt "Samtykke" eller "Værdispring" | Streng med max længde 50 tegn | 0-1 |
Destination/ DateTime | DateTime-elementet indeholder en tidsangivelse for opslag på eller forsøg på handling på borgerens data. | DateTime | 0-1 |
Destination/ FromDateTime | Som alternativ til DateTime herover kan der være foretaget en gruppering af f.eks. FMK inden data er afleveret til MinLog 2. I så fald kan FromDateTime og ToDateTime angive det interval hvor hændelserne er sket. | DateTime | 0-1 |
Destination/ ToDateTime | Se FromDateTime herover. | DateTime | 0-1 |
Destination/ OrganisationId | ID for brugerens organisation. | Streng på max 200 tegn | 0-1 |
Destination/ OrganisationId attribut source | Kilde til ID for brugerens organisation, defineret som en attribut på OrganisationId-elementet. | SOR, SKS, Yder, CVR-P, CVR, Kommunekode og en Streng med max længde 200 | 1 |
Destination/ OrganisationName | Navn på brugens organisation , | Streng med max længde 200 | 0-1 |
Destination/ PersonIdentifier | CPR-nummer eller evt. erstatnings-CPR-nummer på borgeren. | Streng af længde 50 | 1 |
Destination/ PersonIdentifier attribut source | Kilde til ID for borgerens CPR-nummer eller erstatnings-CPR-nummer. | CPR, E-CPR, ... og en Streng med max længde 200 | 1 |
Destination/ PersonName | Borgerens navn. Optionelt men krævet af anvendersystemet hvor source ikke er CPR. | Streng med max længde 147 tegn | 0 |
Destination/ CorrelationId | Et teknisk id, medsendt fra kildessytemetet. Værdien anvendes til at identificere den sammenhæng som handlingen er gennemført i, eksempelvis et id for behandlingen eller indlæggelsen (EPJ) eller kontakten (LPS). | Streng med max længde på 46 tegn | 0-1 |
Destination/ SequenceNumber | Et teknisk sekvens-nummer, angivet af afsender, der anvendes i forbindelse med fejlhåndtering. F.eks. et fortløbende nummer eller et uuid. | Streng med max længde på 36 tegn | 0-1 |
Destination/ UserPersonIdentifier | CPR-nummer eller evt. erstatnings-CPR-nummer på brugeren der har udført handlingen. En forekomst af CPR-nummer eller erstatnings-CPR-nummer er som udgangspunkt obligatorisk og valideres af registreringsservicen. | Streng af længde 50 | 1-* |
Destination/ UserPersonIdentifier attribut source | Kilde til UserPersonIndentifier. | CPR, Initialer, Autorisation eller en Streng med max længde 200 | 1 |
Destination/ UserPersonName | Brugerens navn. Optionelt men krævet af anvendersystemet hvor source ikke er CPR, Autorisation m.v. | Streng med max længde 147 tegn | 0 |
Destination/ UserRole | Brugerens rolle. | Streng af længde 200 (svarende til FMK's RequestedRole) | 0-1 |
Destination/ OnBehalfOfPersonIdentifier | CPR-nummer eller evt. erstatnings-CPR-nummer på brugeren handlingen er udført på vegne af. | Streng med max længde 50 | 0-1 |
Destination/ OnBehalfOfPersonIdentifier attribut source | Kilde til OnBehalfOfPersonIdentifier. | CPR, Initialer, Autorisation eller en Streng med max længde 200 | 1 |
Destination/ OnBehalfOfPersonName | Navn svarende til "på vegne af". Optionelt men krævet af anvendersystemet hvor source ikke er CPR, Autorisation m.v. | Streng med max længde 147 tegn | 0 |
Destination/ OnBehalfOfUserRole | På vegne af brugerens rolle. | Streng af længde 200 | 0-1 |
Destination/Filter | Et eller flere felter der anvendes til angivelse af hvilken målgruppe logningen skal filtreres fra for. | Streng, aktuelt defineret som en union af en enumeration aktuelt indeholdende " Ikke borger" , "Ikke forældremyndighedsindehaver" og en Streng med max længde 50 tegn. | 0-* |
Response
Følgende elementer returneres i svaret:
Navn | Beskrivelse | Definition | Kardinalitet |
RegistrationResponse | Rod-element for svaret. | 1 | |
NumberAdded | Antal LogDataEntry registreret med succes | Integer | 1 |
NumberFailed | Antal LogDataEntry registreret med med fejl | Integer | 1 |
FailedLogDataEntry | Såfremt en registrering er fejlet indeholder elementet information herom | 0-* | |
FailedLogDataEntry/ SequenceNumber | Svarer til teknisk sekvens-nummer, angivet af afsender. | Streng med max længde på 36 tegn | 1 |
FailedLogDataEntry/ FaultCode | Fejlkode: | ... | 1 |
FailedLogDataEntry/ FaultText | Fejltekst. | ... | 0-1 |
Operationer
Nedenfor følger en oversigt over den eneste tilgængelige operation. Denne operation anvendes også til at sende flere logentries i samme request.
AddRegistrations
Denne operation anvendes når der skal foretages en log registrering. Headerdelen håndterer IDCard og Medcom - se evt. nsop.dk. Efterfølgende fokuseres på body-delen af soap requestet. Check evt. integrationtest BasicRegistrationTest for komplet soaprequest.
Eksempel-Request
……. |
Eksempel-Response
……. |
...