Indledning

Denne vejledning beskriver de tekniske forretningsregler i forhold til at implementere psykiatriplaner i et lokalt fagsystem eller en patient/borgerportal. Vejledningen er tiltænkt forretningsarkitekter, systemarkitekter samt systemleverandører, således at disse kan vurdere hvordan psykiatriplanerne kan implementeres i systemerne.

På nationalt plan er der udarbejdet en indholdsprofil ud fra HL7's Clinical Document Architecture  (CDA), som beskriver udvekslingsformatet for psykiatriplanerne. Indholdsprofilen er forankret hos MedCom.
CDA-dokumenterne for psykiatriplaner udstilles via den nationale delingsinfrastruktur, således at borgerens psykiatriplaner kan fremfindes af sundhedsvæsenets aktører.
Aktører, som understøtter psykiatriplaner, kan via deres fagsystemer anvende de standardiserede IHE XDS snitflader til at hente borgernes psykiatriplaner.

Den nationale delingsinfrastruktur udstilles gennem dokumentdeling- og dokumentregistreringsservices via standardiserede IHE XDS snitflader tilpasset den nationale sikkerhedsinfrastruktur, som bl.a. omhandler autorisation, samtykkekontrol, auditlogning etc.

Anden dokumentation

De overordnede forretningsregler til psykiatriplaner kan ses i dokumentet: Indhold og forretningsregler

Udveksling af data om psykiatriplaner foregår via den nationale delingsinfrastruktur. Denne understøtter reference arkitekturen for deling af dokumenter og billeder.

For generel introduktion til den nationale delingsinfrastruktur, 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 beskrivelsen på Dokumentdeling på NSP (DROS, DDS, NXRG, OpenXDS)

Aktører

Figuren giver et overblik over de aktører som er i spil i relation til deling af psykiatriplaner.

Borgere (Patienter): Borgere har læseadgang til egnepsykiatriplaner via sundhed.dk

Pårørende: Pårørende har læseadgang til borgerenspsykiatriplaner via sundhed.dk, hvis borgeren har tildelt den pårørende en læsefuldmagt via den fælles-offentlige fuldmagtsservice på borger.dk

Sundhedspersoner: Sundhedspersoner har adgang til borgerespsykiatriplaner via Sundhedsjournalen på sundhed.dk, eller via eget fagsystem - afhængigt af lokal implementering

Sundhedsprofessionelle (uden sundhedsfaglig autorisation): Kan få adgang til borgerenspsykiatriplaner via lokal trustmodel, hvor parterne giver relevante medarbejdere adgang til at tilgå borgerespsykiatriplaner via Sundhedsjournalen på sundhed.dk, eller via eget fagsystem - afhængigt af lokal implementering

Teknisk oversigt

Indhold i psykiatriplaner

Først og fremmest skal man kende til det indholdsformat der benyttes til psykiatriplansdokumenter. Formatet er XML og indholdet er specificeret som en dansk profil af CDA. Den danske profil for CDA Careplan (PHAD-DK v1.0.0) er forankret hos MedCom der står for den danske profilering. Se under MedCom PHAD-DK hvor både beskrivelse af standarden samt forskellige eksempler opbevares. Eksempler til PHAD-DK v1.0.0 findes i Eksempel folderen.

Et CDA dokument består af en header og en body, hvor headeren generelt beskriver en række metadata omkring dokumentets indhold, mens de dokumentspecifikke data placeres i body sektionen.

Indholdet i CDA headeren er fælles for alle danske CDA dokumenter, og er ligeledes forankret hos MedCom, se under MedCom CDA Header v. 1.4. I forbindelse med psykiatriplaner er der tilføjet en forløbslabel til CDA headeren, som ikke er inkluderet i CDA Header v. 1,4 standarden - dette er beskrevet i PHAD-DK v1.0.0 under afsnit 2.1.5.3

Systemer der tilsluttes psykiatriplaner, skal bl.a. godkendes af MedCom ud fra en certificering. Testprotokollerne for certificering til psykiatriplaner, kan findes på MedCom's hjemmeside under: Testprotokoller for modtagelse og afsendelse af psykiatriplaner.

Yderligere information om hvordan CDA dokumenter er opbygget kan findes hos IHE, under: IHE - Hvad er HL7 CDA?

Tekniske forudsætninger

Se Administrative forudsætninger for at få adgang til NSP'en.

Psykiatriplaner udstilles via services på NSP'en, disse skal tilgås gennem en afkoblingskomponent "DCC'en". DCC'en viderestiller kald til underliggende services, så der er ikke en WSDL for DCC'en. Se DCC Dokumentation for adgang til services gennem DCC'en.

NSP services kan tilgås enten via Den Gode Webservice (DGWS) eller via OIO-IDWS (Udelukkende borger adgang). 
Den Gode WebService (DGWS) benytter XMLDSIG til at signere SAML assertions ud fra X.509 certifikater/nøgler - for adgang til psykiatriplaner skal sundhedspersoner have et STS-underskrevet SOSI-ID kort på niveau 4 (medarbejder), hvilket også er beskrevet under administrative forudsætninger, således at borgeren har mulighed for at lave en spærring så psykiatriplaner ikke kan deles med specifikke sundhedspersoner, samt at patienten har mulighed for at se hvem der har haft adgang til patientens Aftaleoversigt via MinLog.
For mere information om den gode webservice, se: https://www.medcom.dk/standarder/webservice-standarder/den-gode-webservice

Sundhedsdatastyrelsen har beskrevet hvordan et SOSI-ID kort kan skabes og anvendes under STS Dokumentationen

De servicesnitflader der udstilles til psykiatriplaner er alle baseret på SOAP kald der understøtter DGWS.
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, se nærmere beskrivelse under: Dokumentdeling på NSP (DROS, DDS, NXRG/SDS Patientindex, OpenXDS)

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å psykiatriplaner

For at søge efter en borgers psykiatriplaner, 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å psykiatriplaner, kan der søges på de værdier, der er angivet som XDS-metadata. Psykiatriplaner benytter metadata profil version 0.96, der kan hentes på https://svn.medcom.dk/svn/releases/Standarder/IHE/DK_profil_metadata/

Borgerens CPR-nummer (PatientId) samt psykiatriplansdokumenterne statuskode (Status) er påkrævede felter, som skal inkluderes i alle søgninger.

For psykiatriplaner, er der desuden følgende forretningsmæssige XDS-metdata, som skal anvendes i søgninger:

• Typecode: 103140-0
• EventCodeList
  
  • ALAL03 for Psykiske lidelser og adfærdsmæssige forstyrrelser 

Desuden anbefales det at forespørge både efter specifikt format samt statiske og dynamiske (on-demand) dokumentkilder, angives denne værdi ikke, returneres kun data fra statiske dokumentkilder.

• Type
  • urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1 (for statiske dokumentkilder)
  • urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248 (for dynamiske "on-demand" dokumentkilder)
    
    
• FormatCode: urn:ad:dk:medcom:phad-v1.0:full

Værdierne (klassifikationerne) som anvendes i XDS-metadata er defineret i et regneark hos MedCom, se: DK-IHE_Metadata-Common_Code_systems-Value_sets.xlsx

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

Eksempel på en ITI-18 forespørgsel efter psykiatriplaner:

<ns3:AdhocQueryRequest xmlns:ns3="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns:ns2="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:ns4="urn:ihe:iti:xds-b:2007" xmlns:ns5="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0">
			<ns3:ResponseOption returnComposedObjects="true" returnType="LeafClass"/>
			<AdhocQuery id="urn:uuid:14d4debf-8f97-4251-9a74-a90016b0af0d">
				<Slot name="$XDSDocumentEntryTypeCode">
					<ValueList>
						<Value>('103140-0^^2.16.840.1.113883.6.1')</Value>
					</ValueList>
				</Slot>
				<Slot name="$XDSDocumentEntryEventCodeList">
					<ValueList>
						<Value>('ALAL03^^1.2.208.176.2.4')</Value>
					</ValueList>
				</Slot>
				<Slot name="$XDSDocumentEntryFormatCode">
					<ValueList>
						<Value>('urn:ad:dk:medcom:phad-v1.0:full^^1.2.208.184.100.10')</Value>
					</ValueList>
				</Slot>
				<Slot name="$XDSDocumentEntryPatientId">
					<ValueList>
						<Value>'2512489996^^^&1.2.208.176.1.2&ISO'</Value>
					</ValueList>
				</Slot>
				<Slot name="$XDSDocumentEntryType">
					<ValueList>
						<Value>('urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248')</Value>
						<Value>('urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1')</Value>
					</ValueList>
				</Slot>
				<Slot name="$XDSDocumentEntryStatus">
					<ValueList>
						<Value>('urn:oasis:names:tc:ebxml-regrep:StatusType:Approved')</Value>
					</ValueList>
				</Slot>
			</AdhocQuery>
</ns3:AdhocQueryRequest>

Retur-svaret indeholder referencerne til psykiatriplan dokumenterne, der skal benyttes efterfølgende til at udtrække de konkrete psykiatriplaner

Hentning af psykiatriplaner

Der er tre værdier fra retursvaret på ITI-18 forespørgslen som skal benyttes for at hente indholdet af en konkret psykiatriplan:

1. HomeCommunityId - der beskriver det domæne dokumentet befinder sig i.

   Værdien hentes ud fra ...ExtrinsicObject/@home
   
   

2. RepositoryUniqueId - der bekriver den kilde under domænet der opbevarer dokumentet
   Værdien hentes ud fra ...ExtrinsicObject/Slot[@name=’repositoryUniqueId’]/Value List/Value
   
   
3. DocumentUniqueId - der identificerer selve dokumentet
   Værdien hentes ud fra ...ExtrinsicObject/ExternalIdentifier[@identificationScheme=’urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab]/@value

Ud fra disse værdier 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

        <RetrieveDocumentSetRequest xmlns="urn:ihe:iti:xds-b:2007">
            <DocumentRequest>
                <HomeCommunityId>urn:oid:1.2.208.176.43210.8.20.11</HomeCommunityId>
                <RepositoryUniqueId>1.2.208.176.43210.8.20.11</RepositoryUniqueId>
                <DocumentUniqueId>1.2.208.184^e23d1b0d-f4cc-4b3e-9973-b2a499aa15ba</DocumentUniqueId>
            </DocumentRequest>
        </RetrieveDocumentSetRequest>

Det svar der returneres er patientens psykiatriplan, indeholdende de dataelementer der er beskrevet i PHAD v.1.0.0

Bemærk at selve body delen af psykiatriplanen skal hentes ud som en mime attachement

		<RetrieveDocumentSetResponse xmlns="urn:ihe:iti:xds-b:2007" xmlns:ns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns3="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns4="http://www.w3.org/2000/09/xmldsig#" xmlns:ns5="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns6="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns7="http://www.nsi.dk/hsuid/2016/08/hsuid-1.1.xsd" xmlns:ns8="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns:ns9="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:ns10="urn:oasis:names:tc:ebxml-regrep:xsd:cms:3.0" xmlns:ns11="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns12="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0">
			<ns9:RegistryResponse status="urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success"/>
			<DocumentResponse>
				<RepositoryUniqueId>1.2.208.176.43210.8.20.11</RepositoryUniqueId>
				<DocumentUniqueId>1.2.208.184^e23d1b0d-f4cc-4b3e-9973-b2a499aa15ba</DocumentUniqueId>
				<mimeType>text/xml</mimeType>
				<Document>
					<xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" href="cid:37b3a03a-70c8-45ea-9be5-bbaec58de49a-128338@urn%3Aihe%3Aiti%3Axds-b%3A2007"/>
				</Document>
			</DocumentResponse>
		</RetrieveDocumentSetResponse>

Oprettelse af psykiatriplaner

Oprettelse af psykiatri foregår via den dokumentregistreringsservice (DROS), detaljeret dokumentation er beskrevet under: Dokumentregistreringsservice

Endpoint til psykiatriplanspecifik DROS er: https://<NSP-SERVER_URL>:<NSP-SERVER_PORT>/dros_plind/iti41
NSP TEST1 endpoint er: http://test1-cnsp.ekstern-test.nspop.dk:8080/dros_plind/iti41
NSP TEST2 endpoint er: https://test2-cnsp.ekstern-test.nspop.dk:8080/dros_plind/iti41

Arbejdsgangene omkring skabelsen af psykiatriplansdokumenter, og derved deling af dokumenterne 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 psykiatriplansdokumenter via Dokumentregistreringsservicen.

WSDL til DROS'en findes under: Snitfladebeskrivelse og endpoints og på https://wsdl.nspop.dk/#dros

Igen som når et dokuemnt hentes, 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>

TODO - Indsæt eksempel

            </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 psykiatriplaner

Ændring af psykiatriplansdokumenter foregår som oprettelser. Fagsystemet skal blot sikre sig at documententryid'en gemmes lokalt når dokumentet oprettes (husk at documententryid og dokument-id ikke er det samme - se beskrivelsen ovenfor).

Når ændringen af indholdet i CDA dokumentet har betydning for patienten og/eller sundhedsprofessionelle, fx rettelse af fejl eller tilføjelse af information, skal ændringerne i deles via infrastrukturen.

Når et dokument er ændret, skal der laves 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 dokumentet, og sætte den til status "deprecated" og så gemme den nye instans af dokumentet.
Den nye instans af dokumentet bliver samtidigt kædet til den tidligere instans - således der er historik på dokumenterne.

Sletning af psykiatriplaner

Der er ikke udstillet funktionalitet til at slette dokumenter for fagsystemerne.
Dokumenter i graviditetsmappen bliver automatisk slettet efter et givet tidsrum, hvilket fastsættes lovgivningsmæssigt.

Fagsystemer kan, hvis dokumentet ikke længere bør deles via infrastrukturen, ændre dokumentet, og give det status "deprecated". Det kan gøres ved at benytte ITI-57 UpdateDocumentSet, hvorved AvailabilityStatus stættes til "deprecated" istedet for "approved". UpdateDocumentSet er ligeledes tilgængelig via ovenstående DROS endpoint

Sikkerhed, roller og rettigheder

For adgang til psykiatriplaner 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

Sundhedsfaglige 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 psykiatriplaner.

En sundhedsfaglig uden sundhedsfaglig autorisation kan ikke have tilknyttet flere roller på samme tid - dette skal administreres via den lokale identifikations- og rettighedsstyring, eller via SEB

Ansvaret for at tildele rettigheder til sundhedsfaglige uden sundhedsfaglig autorisation ligger hos de enkelte parter. Parterne skal ligeledes via deres eget rolle/rettighedssystem kunne styre om en sundhedsfaglige uden sundhedsfaglig autorisation skal have adgang til psykiatriplaner.

For yderligere information, se Administrative forudsætninger #Brugerstyring/trust

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

Borgeren kan have spærret for deling af at data, herunder psykiatriplaner, 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 data til den specifikke sundhedsperson, for data i et givet tidsrum, for data 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 psykiatriplaner under specielle vilkår, se forretningsregel #6 under: Indhold og forretningsregler Psykiatriplaner 

For adgang til spærrede data kan klienten angive at der ønskes foretaget et værdispring 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

<rs:RegistryError codeContext="urn:dk:nsi:Consent Filter Applied" errorCode="XDSRegistryError" severity="urn:oasis:names:tc:ebxml-regrep:ErrorSeverityType:Error"/>

Fuldmagt

Borgerportaler kan give borgernes 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 borgerportalen selv håndterer kontrol af fuldmagter.

Information angående angivelse af fuldmagter via dokumentdelingsservicen, kan ses i HSUID header dokumentation.

Ændringslog