Indledning
Denne vejledning beskriver de tekniske forretningsregler i forhold til at implementere Høremappen i et lokalt fagsystem eller en borgerportal. Vejledningen er tiltænkt forretningsarkitekter, systemarkitekter samt systemleverandører, således at disse kan vurdere hvordan Høremappen kan implementeres i systemerne.
Høremappen gør det muligt for fagsystemer hos sundhedsvæsenets aktører som indgår i borgerens samlede høreapparatbehandling at dele audiologiske data om patienten, således at de bliver tilgængelige for de øvrige parter i sundhedsvæsenet samt for den enkelte patient.
Høremappen realiserer deling af dokumenter via den nationale IHE XDS dokumentdelingsinfrastruktur på NSP, hvor dokumenterne baserer sig på indfoldsformater fastlagt i Noah datastandarderne fra det internationale hørebrancheorganisation HIMSA.
De aktører, der indgår i borgernes hørerehabilitering, kan gennem brug af de standardiserede IHE XDS snitflader i dokumentdelingsinfrastrukturen dele information om gennemførte audiologiske undersøgelser, målinger og udleverede høreapparater til andre aktører.
Under hele behandlingsforløbet kan aktørerne få et overblik over borgerens audiologiske data ved fremsøge og hente disse gennem standardiserede IHE XDS snitflader i dokumentdelingsinfrastrukturen, der i processen vil håndterer check af behandlingsrelation, check for eventuelle spærringer, samt loging til borgerens MinLog.
De standardiserede IHE XDS snitflader kan ligeledes anvendes til at give patienter det samlede overblik over deres Høremappe via sundhed.dk.
OBS: Vejledningen er baseret på nuværende eksisterende Høremappe version 1.0, der understøtter deling af audigrammer, refleks-/tympanometri-målinger og oplysninger og udleverede høreapparater. Der pågår et arbejde med at videreudvikle Høremappen til en version 2.0, der kan dele yderlige data, som skal understøtte digital visitation. Høremappe 2.0 vil dog være baseret på det samme IHE XDS dokumentdelingskoncept og de samme snitfladeroperationer, men med yderligere indholdsmæssige datatyper. |
|---|
Anden dokumentation
De overordnede forretningsregler til Høremappen kan ses i dokumentet Forretningsregler.
Teknisk oversigt
Udveksling af borgerernes audiologiske data foregår via den nationale infrastruktur til dokumentdeling. Denne understøtter referencearkitekturen for deling af dokumenter og billeder. For generel introduktion til den nationale infrastruktur om IHE XDS dokumentdeling, se vejledningen ’Kom godt i gang med dokumentdeling’ til deling af dokumenter via Dokumentdelingsservice på NSP lavet af MedCom. For detaljeret teknisk dokumentation omkring dokumentdeling via NSP, se Dokumentdelingsservice.
Som illustreret i nedenstående figur er det generiske IHE XDS dokumentdelingskoncept bygget op om omkring rollerne Document Registry og Document Repository, hvor et Registry alene indeholder metadata og et Repository indeholder selve dokumenterne. Der kan være flere Repositories tilknyttet til samme Registry. Derudover kan der registreres metadata for såkaldte On Demand dokument kilder, hvor dokumenter først genereres on-the-fly, når de bliver hentet.
Høremappen er realiseret gennem et dedikeret centralt Registry og et dedikeret central Repository på NSP.
Som vist i figuren defineres i IHE-XDS en række faste roller og operationer (kaldet transaktioner og navngivet som ITI-xx), eksempelvis benytter en dokumentaftager (en Document Consumer) ITI-18 transaktionen til at søge i et Registry og ITI-43 transaktionen til efterfølgende at hente fremsøgte dokumenter fra det pågældende Repository.
Teknisk implementering
Høremappe snitfladeoperationer
Høremappen tilgås med standardiserede ITI-transaktioner som udstilles af dokumentdelingsinfrastrukturen (se også ovenstående figur), hvor skrive-operationer laves via DROS-snitfladen og søge/læse-operationer via DDS-snitfladen. Følgende operationer anvendes:
- ITI-41 Provide And Register transaktionen på DROS til at lægge et nyt dokument i Høremappen (DROS kalder videre til Repository som læser metadata fra requestet, lægger disse i Registry med ITI-42 transaktionen og gemmer selv det medsendte dokument).
- ITI-41 Provide And Register transaktionen på DROS med instruksen ’erstat eksisterende’ for at opdatere et eksisterende dokument.
- ITI-57 Update Document Set på DROS til at slette et eksisterende dokument ved at sætte ’availabilityStatus’ i metadata til ’deprecated’ (Forventes kun at blive anvendt for at kunne slette dokumenter, som fejlagtigt er blevet lagt i Høremappen).
- ITI-18 Registry Stored Query på DDS til at søge i Høremappen (DDS/Registry returnerer ID’er på matchende dokumenter).
- ITI-43 Retrieve Document Set på DDS til at hente dokumenter fra Høremappen ud fra de i ITI-18 søgeresultatet returnerede ID’er.
Nedenstående figur illustrerer anvendelsen af Høremappens snitflader fra henholdvis et audiologisk fagsystem og en webvisning.
Indholdstyper i Høremappen
Noah ....
Metadata opmærkning
Tekniske forudsætninger
Se Administrative forudsætninger for at få adgang til NSP'en.
Høremappen udstilles via services på NSP'en og kan tilgås enten via Den Gode Webservice (DGWS) eller via OIO-IDWS (kun for borger adgang).
For mere information om den gode webservice, se https://www.medcom.dk/standarder/webservice-standarder/den-gode-webservice.
Til at understøtte DGWS har Sundhedsdatastyrelsen udviklet biblioteker til Java og .NET (SEAL biblioteket). Dette bør benyttes så vidt det er muligt, se STS Dokumentation.
De servicesnitflader der udstilles til Høremappen er alle baseret på SOAP kald der opfylder DGWS og OIO-IDWS (kun for borger adgang).
Indholdsdelen af den enkelte servicekald (SOAP body) er den del der er specificeret af IHE XDS snitfladerne, dvs. for eksempel ITI-18 og ITI-43.
De detaljerede beskrivelser af snitfladerne findes i IHE IT Infrastructure Technical Framework dokumenterne volume 1, 2a, 2b, 2x og 3.
- IHE ITI TF Vol. 1 - Integration Profiles
http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol1.pdf - IHE ITI TF Vol. 2a - Transactions 1-28
http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol2a.pdf - IHE ITI TF Vol. 2b - Transactions 29-64
http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol2b.pdf - IHE ITI TF Vol. 2x - Appendices A-X
http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol2x.pdf - IHE ITI TF Vol. 3 - Metadata
http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol3.pdf
Beskrivelserne i de officielle dokumenter fra IHE er relativt komplicerede, og det kan være svært at opnå et godt overblik over hvordan specifikke kald sættes sammen. Der findes en række generelle og praktiske eksempler og programmer på IPF Open eHealth Integration Platform siderne. Se for eksempel:
- IPF Open eHealth Integration Platform
http://oehf.github.io/ipf/ipf-platform-camel-ihe/ - IPF Commons IHE XDS
https://mvnrepository.com/artifact/org.openehealth.ipf.commons/ipf-commons-ihe-xds
Søgning på Aftaler
For at søge på en patients Aftaleoversigt, skal der laves en ITI-18 forespørgsel via NSP'ens dokumentdelingsservice.
WSDL til DDS Registry findes her: https://wsdl.nspop.dk/ddsregistry?wsdl
Når der søges på Aftaleoversigten, kan der søges på de værdier der er angivet i dokument metadata. Aftaleoversigten benytter MedCom's metadata profil version 0.96, der kan hentes på https://svn.medcom.dk/svn/releases/Standarder/IHE/DK_profil_metadata/
Typisk angives patientens CPR nummer, samt en typecode - for APD er typecode 39289-4, bemærk at aftaledokumenter både udstilles som statiske dokumenter, og on-demand dokumenter hvorfor DocumentEntryType for begge typer skal angives. Se følgende eksempel.
En søgning efter en patients aftale dokumenter baserer sig typisk på et tidsinterval. For Aftaler er det parametrene ServiceStartTime og ServiceStopTime, der angiver hvornår en aftale begynder og slutter.
For parametre med tidsangivelser gælder følgende søgeregel, således alle tidspunkter der angives inden for dette interval inkluderet. (eksempel med ServiceStartTime):
$XDSDocumentEntryServiceStartTimeFrom <= XDSDocumentEntry.serviceStartTime < $XDSDocumentEntryServiceStartTimeTo
Der er specielle regler for søgninger, hvor ServiceStopTime ikke er angivet. Konkret betyder det følgende:
Hvis DocumentEntry.serviceStopTime ikke er angivet, og hvis søge paramtrerne inkluderer en værdi for enten $XDSDocumentEntryServiceStopTimeFrom eller $XDSDocumentEntryServiceStopTimeTo. Så vil disse parametre ikke blive benyttet for udsøgning af det konkrete dokument.
For henholdsvis AND og OR søgninger gælder det at angives der flere søgeværdier i samme <slot> så tæller det som en OR søgning for disse værdier. Hvor der mellem de forskellige <slot> tæller som en AND søgning.
De detaljerede tekniske informationer om ITI-18 og angivelse af søgeparametre, kan ses i IHE ITI dokumentation volume 2
Specifikt for Aftaler der løber over flere dage, gælder det at søgningen skal inkludere de tidspunkter Aftalen har angivet. Hvis ServiceStartTime angives til 1/1-2021 og ServiceStopTime angives til 3/1-2021 vil det ikke returnere en aftale der har sat ServiceStartTime til 31/12-2020, og ServiceStopTime til 2/1-2021, da ServiceStartTime og ServiceStopTime er angivet i hvert deres <slot> og det derfor er en AND søgning mellem parametrene. I dette tilfælde skal anvendersystemerne stå for filtreringen selv hvis denne funktionalitet ønskes (evt. med flere søgninger, eller udvide angivelserne for søgetidsrum).
Specifikt for Aftaler hvor sluttidspunktet ikke er defineret, kan det ikke afgøres om Aftalen løber over flere dage. Der vil søgningen gælde som om ServiceStopTime ikke er angivet (som specificeret ovenfor)
Svaret indeholder referencerne til Aftale dokumenterne, der skal benyttes efterfølgende til at udtrække Aftaleoversigten
Der er tre værdier der skal benyttes:
- HomeCommunityId - der beskriver det domæne dokumentet befinder sig i.
Værdien hentes ud fra ...ExtrinsicObject/@home
- RepositoryUniqueId - der bekriver den kilde under domænet der opbevarer dokumentet
Værdien hentes ud fra ...ExtrinsicObject/Slot[@name=’repositoryUniqueId’]/Value List/Value
- DocumentUniqueId - der identificerer selve dokumentet
Værdien hentes ud fra ...ExtrinsicObject/ExternalIdentifier[@identificationScheme=’urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab]/@value
Yderligere information omkring forespørgsler via dokumentdeling kan ses i Brugervejledning til forespørgsler via DDS
Hentning af Aftaler
For at hente en patients Aftaleoversigt, skal der laves en ITI-43 forespørgsel via NSP'ens dokumentdelingsservice.
Som beskrevet ovenfor benyttes de tre værdier: HomeCommunityId, RepositoryUniqueId og DocumentUniqueId til at hente dokumenterne.
WSDL til DDS Repository findes her: https://wsdl.nspop.dk/ddsrepository?wsdl
Det svar der returneres er patientens Aftaleoversigt, indeholdende de dataelementer der er beskrevet under indhold.
Bemærk at selve body delen af aftalen skal hentes ud som en mime attachement
Oprettelse af Aftaler
Oprettelse af aftaler foregår via dokumentregistreringsservicen (DROS), detaljeret dokumentation er beskrevet under: Dokumentregistreringsservice
Arbejdsgangene omkring booking af aftaler med patienter, og derved deling af aftalerne foregår ofte som automatiske processer og system til system kommunikation, derfor kan der både benyttes et medarbejdercertifikat (MOCES) eller et Funktionscertifikat (FOCES) til deling af aftaler via Dokumentregistreringsservicen.
WSDL til DROS'en findes under: Snitfladebeskrivelse og endpoints og på https://wsdl.nspop.dk/#dros
Igen som når aftaler hentes ud, så skal selve ClinicalDocument oprettes som en MIME attachment, se eksemplet for detaljer.
<ProvideAndRegisterDocumentSetRequest xmlns:lcm="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0" xmlns:rim="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns="urn:ihe:iti:xds-b:2007"> <lcm:SubmitObjectsRequest> <rim:RegistryObjectList> <rim:ExtrinsicObject id="10614913492668759151.7526722965054630547.1561027587628" lid="17744819518467516435.5289508129896542596.1561027587628" mimeType="text/xml" objectType="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved"> <rim:Slot name="creationTime"> <rim:ValueList> <rim:Value>20170531120000</rim:Value> </rim:ValueList> </rim:Slot> <rim:Slot name="serviceStartTime"> <rim:ValueList> <rim:Value>20190101010101</rim:Value> </rim:ValueList> </rim:Slot> <rim:Slot name="serviceStopTime"> <rim:ValueList> <rim:Value>20200101010101</rim:Value> </rim:ValueList> </rim:Slot> <rim:Slot name="sourcePatientId"> <rim:ValueList> <rim:Value>2512489996^^^&1.2.208.176.1.2&ISO</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="Aftale for 2512489996" xml:lang="en-US"/> </rim:Name> <rim:Classification classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:0f2732cd-628f-4df7-821c-ede951749ccd" nodeRepresentation=""> <rim:Slot name="authorInstitution"> <rim:ValueList> <rim:Value>OUH Radiologisk Afdeling (Svendborg)^^^^^&1.2.208.176.1.1&ISO^^^^242621000016001</rim:Value> </rim:ValueList> </rim:Slot> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:03549911-5dd4-4406-8157-2f0c76cf6565" nodeRepresentation="001"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>1.2.208.184.100.9</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="Klinisk rapport" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:fa1a078e-43e8-4cc3-a177-a670656b56e9" nodeRepresentation="urn:ad:dk:medcom:appointmentsummary:full"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>1.2.208.184.100.10</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="DK PHMR schema" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:21648bfe-b78c-46d2-8bb1-80017f618775" nodeRepresentation="550621000005101"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>2.16.840.1.113883.6.96</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="hjemmesygepleje" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:a0594198-3c4a-4039-a269-18a970de3abf" nodeRepresentation="408443003"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>2.16.840.1.113883.6.96</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="almen medicin" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:f0306f51-975f-434e-a61c-c59651d33983" classifiedObject="10614913492668759151.7526722965054630547.1561027587628" id="urn:uuid:98128f66-7cfc-480d-b1cf-14bedac10132" nodeRepresentation="39289-4"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>2.16.840.1.113883.6.1</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="Dato og tidspunkt for møde mellem patient og sundhedsperson" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:ExternalIdentifier id="urn:uuid:7c0f749b-679d-4ac4-b039-0e4a6cd1378f" identificationScheme="urn:uuid:58a6f841-87b3-4a3e-92fd-a8ffeff98427" registryObject="10614913492668759151.7526722965054630547.1561027587628" value="2512489996^^^&1.2.208.176.1.2&ISO"> <rim:Name> <rim:LocalizedString value="XDSDocumentEntry.patientId"/> </rim:Name> </rim:ExternalIdentifier> <rim:ExternalIdentifier id="urn:uuid:c8eb9924-b511-4883-8736-a6c24e329ee7" identificationScheme="urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab" registryObject="10614913492668759151.7526722965054630547.1561027587628" value="10613314401450021042.16485562384221947016.1561027587628"> <rim:Name> <rim:LocalizedString value="XDSDocumentEntry.uniqueId"/> </rim:Name> </rim:ExternalIdentifier> </rim:ExtrinsicObject> <rim:RegistryPackage id="7874116232104445829.6778506344390820751.1561027587628" lid="7874116232104445829.6778506344390820751.1561027587628" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved"> <rim:Slot name="submissionTime"> <rim:ValueList> <rim:Value>20170531120000</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="7874116232104445829.6778506344390820751.1561027587628" xml:lang="en-US"/> </rim:Name> <rim:Classification classificationScheme="urn:uuid:aa543740-bdda-424e-8c96-df4873be8500" classifiedObject="7874116232104445829.6778506344390820751.1561027587628" id="urn:uuid:3f20f9c0-ef4b-449d-985b-2e923431e1d8" nodeRepresentation="39289-4"> <rim:Slot name="codingScheme"> <rim:ValueList> <rim:Value>2.16.840.1.113883.6.1</rim:Value> </rim:ValueList> </rim:Slot> <rim:Name> <rim:LocalizedString charset="UTF-8" value="Dato og tidspunkt for møde mellem patient og sundhedsperson" xml:lang="en-US"/> </rim:Name> </rim:Classification> <rim:Classification classificationScheme="urn:uuid:a7058bb9-b4e4-4307-ba5b-e3f0ab85e12d" classifiedObject="7874116232104445829.6778506344390820751.1561027587628" id="urn:uuid:b28dc026-efd5-40bc-895c-f978127be6fd" nodeRepresentation=""> <rim:Slot name="authorInstitution"> <rim:ValueList> <rim:Value>OUH Radiologisk Afdeling (Svendborg)^^^^^&1.2.208.176.1.1&ISO^^^^242621000016001</rim:Value> </rim:ValueList> </rim:Slot> </rim:Classification> <rim:ExternalIdentifier id="urn:uuid:a541991d-f8b3-47f1-8dab-78cec036815f" identificationScheme="urn:uuid:6b5aea1a-874d-4603-a4bc-96a0a7b38446" registryObject="7874116232104445829.6778506344390820751.1561027587628" value="2512489996^^^&1.2.208.176.1.2&ISO"> <rim:Name> <rim:LocalizedString value="XDSSubmissionSet.patientId"/> </rim:Name> </rim:ExternalIdentifier> <rim:ExternalIdentifier id="urn:uuid:d49106ed-2ccf-403b-a785-4d5a1bd25242" identificationScheme="urn:uuid:96fdda7c-d067-4183-912e-bf5ee74998a8" registryObject="7874116232104445829.6778506344390820751.1561027587628" value="7874116232104445829.6778506344390820751.1561027587628"> <rim:Name> <rim:LocalizedString value="XDSSubmissionSet.uniqueId"/> </rim:Name> </rim:ExternalIdentifier> <rim:ExternalIdentifier id="urn:uuid:9bdc2b25-a86b-4088-9ae8-1e1d7027214d" identificationScheme="urn:uuid:554ac39e-e3fe-47fe-b233-965d2a147832" registryObject="7874116232104445829.6778506344390820751.1561027587628" value="7874116232104445829.6778506344390820751.1561027587628"> <rim:Name> <rim:LocalizedString value="XDSSubmissionSet.sourceId"/> </rim:Name> </rim:ExternalIdentifier> </rim:RegistryPackage> <rim:Classification classificationNode="urn:uuid:a54d6aa5-d40d-43f9-88c5-b4633d873bdd" classifiedObject="7874116232104445829.6778506344390820751.1561027587628" id="urn:uuid:6e17db47-168b-49bc-bbaa-c2570e255cf2"/> <rim:Association associationType="urn:oasis:names:tc:ebxml-regrep:AssociationType:HasMember" id="5855258517755215834.4341855612522046622.1561027587628" sourceObject="7874116232104445829.6778506344390820751.1561027587628" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved" targetObject="10614913492668759151.7526722965054630547.1561027587628"> <rim:Slot name="SubmissionSetStatus"> <rim:ValueList> <rim:Value>Original</rim:Value> </rim:ValueList> </rim:Slot> </rim:Association> </rim:RegistryObjectList> </lcm:SubmitObjectsRequest> <Document id="10614913492668759151.7526722965054630547.1561027587628"> <xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" href="cid:d028af6e-dc46-4049-b3bd-a4496767e42d@urn%3Aihe%3Aiti%3Axds-b%3A2007"/> </Document> </ProvideAndRegisterDocumentSetRequest>
Ændring af Aftaler
Ændring af aftaler er tilsvarende oprettelse af aftaler. Fagsystemet skal blot sikre sig at aftaleid'en er den samme når dokumentet oprettes (husk at aftale-id og dokument-id ikke er det samme - se beskrivelsen ovenfor).
Når ændringen af kalenderaftalen har betydning for patienten og/eller sundhedsprofessionelle, fx ændring af tid eller sted, skal ændringerne i kalenderaftalen være tilgængelige på infrastrukturen.
Når en aftale er ændret, eksempelvis fordi mødetidspunktet er flyttet, skal metoden der er beskrevet i dokumentationen benyttes (altså lave et ITI-41 provideAndRegister request, men man skal som dokument-provider selv angive associationstypen, source-objektet og target objektet
For en præcis teknisk vejledning, kan opskriften fra IHE’s wikiside følges (https://wiki.ihe.net/index.php/Annotated_ProvideAndRegister.b_Transaction#Document_Replacement)
Infrastrukturen vil derefter automatisk sørge for at tage den tidligere instans af aftalen, og sætte den til status "deprecated" og så gemme den nye instans af aftalen.
Den nye instans af aftalen bliver samtidigt kædet til den tidligere instans - således der er historik på aftalen.
Arbejdsgangene omkring ændringer af en aftale med patienten, og derved deling af aftalen foregår ofte som automatiske processer og system til system kommunikation, derfor kan der både benyttes et medarbejdercertifikat (MOCES) eller et Funktionscertifikat (FOCES) til deling af aftaler via Dokumentregistreringsservicen.
Sletning af Aftaler
Der er ikke udstillet funktionalitet til at slette aftaler for fagsystemerne.
Aftaler bliver automatisk slettet 2 år efter udførelsestidspunktet, hvilket er fastsat lovgivningsmæssigt.
Fagsystemer skal istedet ændre aftalen, og give den status "deprecated". Det kan gøres ved at benytte ITI-57 UpdateDocumentSet, hvorved AvailabilityStatus stættes til "deprecated" istedet for "approved"
Arbejdsgangene omkring sletning af en aftale med patienten, og derved stoppe deling af aftalen foregår ofte som automatiske processer og system til system kommunikation, derfor kan der både benyttes et medarbejdercertifikat (MOCES) eller et Funktionscertifikat (FOCES).
Sikkerhed, roller og rettigheder
For adgang til Aftaleoversigten skal der for sundhedspersoner eksistere et gyldigt SOSI-ID kort som er signeret af NSP'ens Secure Token Service, dokumentationen for SOSI-ID kort og STS ligger under: Anvenderguide til STS
Sundhedspersoner, med en sundhedsfaglig autorisation har adgang til Aftaleoversigten. Sundhedspersoner uden sundhedsfaglig autorisation skal have tilknyttet en rettighed før disse kan få adgang. Lokale organisationer kan enten tilknytte disse rettigheder via Sundhedsstyrelsens Elektroniske Brugerstyring (SEB), eller give rettigheden via den lokale identifikations- og rettighedsstyring.
Følgende roller anvendes i forbindelse med Et samlet patientoverblik.
Rollenavn | Rettighed | Notation som indsættes i SOSI IdKort ved udstedelse |
nspSundAssistR2 | Giver ret til at læse Aftaleoversigten Giver også adgang til at læse andre dokumenter, der deles via dokumentdelingsinfrastrukturen jvf. Sundhedslovens §42a stk. 4 (Se overordnet dokumentation for nationale roller her: SEB - Sundhedsvæsenets Elektroniske Brugerstyring - Sundhedsdatastyrelsen Services (nsi.dk)) | urn:dk:healthcare:national-federation-role:code:41002:value:SundAssistR2 |
En sundhedsperson kan ikke have tilknyttet flere roller på samme tid - dette skal administreres via den lokale identifikations- og rettighedsstyring, eller via SEB
Bemærk: SEB-dokumentationen samt vejledningen ved oprettelse af en rolle er ved at blive tilrettet, så rettigheden for nspSundAsisstR2 afspejler ovenstående.
Håndtering af Spærring og Fuldmagt
Spærring
Patienten kan have spærret for at data fra Aftaleoversigten må deles med andre parter i sundhedssektoren, i det tilfælde vil fejlkoden "Consent Filter Applied” blive returneret (se nedenstående xml eksempel for ITI-18 spærrede dokumenter). Det betyder at borgeren enten har spærret for deling af Aftaler til den specifikke sundhedsperson, for Aftaler i et givet tidsrum, for Aftaler fra bestemte organisationer, eller i en kombination af disse. Klienten skal håndtere at der er angivet en spærring, og give sundhedspersonen mulighed for at få adgang til den fulde Aftaleoversigt under specielle vilkår.
For adgang til spærrede Aftaler kan klienten enten angive et værdispring, eller angive at der ligger et explicit samtykke til at se data, og så sende forespørgslen igen med “ConsentOverride” flaget sat til “True”. Der laves logning i dokumentdelingsinfrastrukturen der angiver at en spærring er tilsidesat. Klienten skal samtidig angive årsagen (Eksempelvis: eksplicit samtykke fra patienten for at få adgang til data) til at spærringen er tilsidesat i eget journalsystem, da der kan forventes at være opfølgning på tilsidesatte spærringer.
Yderligere information omkring spærring og forespørgsler via dokumentdeling kan ses i Brugervejledning til forespørgsler via DDS
Fuldmagt
Patientportaler kan give patienternes pårørende adgang via den Fælles Offentlige Fuldmagtsservice, hvortil der er tilknyttet en brugergrænseflade på Borger.dk.
Bevis for fuldmagter er understøttet i OIO-IDWS identitytokens signeret af STS'en, dog understøtter dokumentdelingsservicen ikke OIO-IDWS - så fuldmagter er i stedet etableret via en trust-løsning hvor patientportalen selv håndterer kontrol af fuldmagter.
Information angående angivelse af fuldmagter via dokumentdelingsservicen, kan ses i HSUID header dokumentation.
Ændringslog
| 0.1 | 2024-09-30 | Udkast til Teknisk implementeringsguide til Høremappen | CHG |


