Page History

Versions Compared

Key

This line was added.
This line was removed.
Formatting was changed.

Table of Contents

Indledning

Denne vejledning beskriver de tekniske forretningsregler i forhold til at integrere til graviditetsmappen fra lokalt fagsystemer samt borgerrettede systemer under projekt for Digital Løsning til Graviditetsforløb. Vejledningen er tiltænkt forretningsarkitekter, systemarkitekter samt systemleverandører.

...

Indhold i Graviditetsmappen

...

Først og fremmest skal man kende til det indholdsformat der benyttes til CDA dokumenterne i Graviditetsmappen. Formatet er XML og indholdet er specificeret som en dansk profil af CDA. Der deles 3 dokumenttyper i via Graviditetsmappen, som alle er forankrede hos MedCom der står for den danske profilering. Se under MedComs draft udgivelser folder hvor både beskrivelse af standarderne samt forskellige eksempler opbevares(Bemærk info boksen, der nævner disse ikke er tilgængelige endnu...)

Digital vandrejournal (Pregnancy Shared Care Record, forkortet PSCR)
Digital svangerskabsjournal (Pregnancy Referral Form, forkortet PRF)
Kliniske målinger (Care Measurement Report, forkortet CMR)

...

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 CDA dokumenterne i graviditetsmappen er der tilføjet et GraviditetsforløbsID til CDA headeren, som ikke er inkluderet i CDA Header v. 1,.4 standarden - dette er beskrevet under: TODO: Indsæt når MedCom frigiver standarderneafsnit 2.1 i standarderne for header specifikke informationer.

Info
Anvenderorganisationerne er ansvarlige for at lave en mapning fra terminologien der anvendes i CDA dokumenterne (SNOMED CT samt NPU) til lokalt anvendte terminologier. Sundhedsdatastyrelsen kan være behjælpelig med at reviewe anvenderorganisationernes mapning.

Systemer der tilsluttes Graviditetsmappen, skal bl.a. godkendes af MedCom ud fra en certificering samt af Sundhedsdatastyrelsen i forhold til den tekniske implementering. Testprotokollerne for certificering til Graviditetsmappen, kan findes på MedCom's hjemmeside under: Testprotokol folderen for de respektive stander under: MedComs udgivelser folder under: TODO: Indsæt når MedCom frigiver standarderne
Krav til test og godkenddelse godkendelse kan ses under: Godkendelsestest for tilslutning til Graviditetsmappen

...

For at søge efter dokumenter i en borgers Graviditetsmappe, skal der laves en ITI-18 forespørgsel via NSP'ens dokumentdelingsservice.
Metoden som anvendes er FindDocuments med forespørgselsid: urn:uuid:14d4debf-8f97-4251-9a74-a90016b0af0d

WSDL til DDS Registry findes her: https:WSDL til DDS Registry findes her: https://wsdl.nspop.dk/ddsregistry?wsdl

...

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

Typecode: TODO, er under høring via MedCom's CDA standarder
- PRF, for digital svangerskabsjournal (Pregnancy Referral Form)
- PSCR, for digital vandrejournal (Pregnancy Shared Care Record)
- CMR, får målinger (Care Measurement Report)

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: TODO, er under høring via MedCom's CDA standarder

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

Info
XDS metadata, typecode og formatcode er endnu ikke beskrevet i MedCom's regneark: DK-IHE_Metadata-Common_Code_systems-Value_sets.xlsx

- urn:ad:dk:medcom:prf-v1.0:full, for digital svangerskabsjournal (Pregnancy Referral Form)
- urn:ad:dk:medcom:pscr-v1.0:full, for digital vandrejournal (Pregnancy Shared Care Record)
- urn:ad:dk:medcom:cmr-v2.0:full, får målinger (Care Measurement Report)
Status:
- urn:oasis:names:tc:ebxml-regrep:StatusType:Approved, for aktive dokumenter
- urn:oasis:names:tc:ebxml-regrep:StatusType:Deprecated, for slettede/erstattede dokumenter

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

...

Code Block

language	xml
title	ITI-18 AdhocQueryRequest
collapse	true

<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>TODO - Typecode for Digital Vandrejournal<<Value>PRF^^1.2.208.184.100.1</Value>
 						<Value>TODO - Typecode for Digital Svangerskabsjournal<<Value>PSCR^^1.2.208.184.100.1</Value>
  						<Value>TODO - Typecode for Kliniske målinger<<Value>CMR^^1.2.208.184.100.1</Value>
                     </ValueList>
				</Slot>
				<Slot name="$XDSDocumentEntryFormatCode">
					<ValueList>
 						<Value>TODO - Formatcode for Digital Vandrejournal<<Value>urn:ad:dk:medcom:prf-v1.0:full^^1.2.208.184.100.10</Value>
 						<Value>TODO - Formatcode for Digital Svangerskabsjournal<<Value>urn:ad:dk:medcom:pscr-v1.0:full^^1.2.208.184.100.10</Value>
  						<Value>TODO - Formatcode for Kliniske målinger<<Value>urn:ad:dk:medcom:cmr-v2.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>

...

Code Block

language	xml
title	ITI-18 AdhocQueryResponse
collapse	true

		<ns3:AdhocQueryResponse xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns:ns2="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:ns3="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns4="urn:oasis:names:tc:ebxml-regrep:xsd:cms:3.0" xmlns:ns5="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns7="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns8="http://www.w3.org/2000/09/xmldsig#" xmlns:ns9="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns10="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns11="http://www.nsi.dk/hsuid/2016/08/hsuid-1.1.xsd" totalResultCount="3" status="urn:ihe:iti:2007:ResponseStatusType:Success">
			<RegistryObjectList>
TODO 
<!-- IndsætListe eksempelaf på svar når MedCom frigiver standardernedokumentreferencer -->

			</RegistryObjectList>
		</ns3:AdhocQueryResponse>

Søgning ud fra GraviditetsforløbsID

MedCom er i spidsen for en arbejdsgruppe, som skal afklare hvordan det kan muliggøres at sammenkæde dokumenter i Graviditetsmappen under et specifiks GraviditetsforløbsID

TODO: Når arbejdsgruppen er kommet frem til en konklusion, vil der blive refereret til den herfra

Hentning af dokumenter i Graviditetsmappen

Info
Bemærk for at hente en dokumenter i Graviditetsmappen på baggrund af en søgning, skal NSP's Service Deklaration: "Særlige begrænsninger ift. anvendelse af Dokumentdelingsservicen (DDS)" følges. Se: Dokumentdelingsservice (DDS) Opsummeret står der følgende: Der må højst være 10 minutter mellem disse kald (ITI-18 og ITI-43), begge kald skal udføres af samme bruger, og begge kald skal have samme (men unikke) ‘flowID’

Info

Bemærk for at hente en dokumenter i Graviditetsmappen på baggrund af en søgning, skal NSP's Service Deklaration: "Særlige begrænsninger ift. anvendelse af Dokumentdelingsservicen (DDS)" følges.

Se: Dokumentdelingsservice (DDS)

Opsummeret står der følgende: Der må højst være 10 minutter mellem disse kald (ITI-18 og ITI-43), begge kald skal udføres af samme bruger, og begge kald skal have samme (men unikke) ‘flowID’

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

...

Der etableres ligeledes en mulighed for at fremsøge dokumenter i en borgers Graviditetsmappe på baggrund af et graviditetsforløbsid. Til dette skal der ligeledes laves en ITI-18 forespørgsel via NSP'ens dokumentdelingsservice.
Metoden som anvendes er FindDocumentsByReferenceId med forespørgselsid: urn:uuid:12941a89-e02e-4be5-967c-ce4bfc8fe492

Info
FindDocumentsByReferenceId etableres via dokumentdelingsservicen som en del af GMv2's gennemførelsesfase

Udover allerede specificeret XDS metadata til et ITI-18 kald, er ReferenceIdList en påkrævet værdi for denne type søgning

ReferenceIdList:
- 79a7424d-353d-4458-8c52-859c027dc472^^^1.2.208.176^PregnancyCourseID, hvor selv id, skal være et type 4 UUID

Se Anvendelse af graviditetsforløbsid for nærmere beskrivelse af anvendelsen af et graviditetsforløbsid

Eksempel på en ITI-18 forespørgsel efter digtal vandrejournal, digital svangerskabsjournal samt kliniske målinger:

Code Block

language	xml
title	ITI-18 AdhocQueryRequest
collapse	true

<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

...

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

Code Block

language	xml
title	ITI-43 RetrieveDocumentSetRequest
collapse	true

        <RetrieveDocumentSetRequest xmlns="urn:ihe:iti:xds-b:2007" xmlns:ns5="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0">
			<ns3:ResponseOption            <DocumentRequest>
                <HomeCommunityId>urn:oid:1returnComposedObjects="true" returnType="LeafClass"/>
			<AdhocQuery id="urn:uuid:12941a89-e02e-4be5-967c-ce4bfc8fe492">
				<Slot name="$XDSDocumentEntryTypeCode">
					<ValueList>
						<Value>PRF^^1.2.208.176.43210.8.20.11</HomeCommunityId>
                <RepositoryUniqueId>1184.100.1</Value>
 						<Value>PSCR^^1.2.208.184.100.1</Value>
  						<Value>CMR^^1.2.208.176184.43210.8.20.11</RepositoryUniqueId>100.1</Value>
                        <DocumentUniqueId>1   </ValueList>
				</Slot>
				<Slot name="$XDSDocumentEntryFormatCode">
					<ValueList>
 						<Value>urn:ad:dk:medcom:prf-v1.0:full^^1.2.208.184^e23d1b0d-f4cc-4b3e-9973-b2a499aa15ba</DocumentUniqueId>
            </DocumentRequest>
        </RetrieveDocumentSetRequest>

Det svar der returneres er patientens dokument i Graviditetsmappen, indeholdende de dataelementer der er beskrevet i MedCom's CDA standarder til Graviditetsmappen

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

Code Block

language	xml
title	ITI-43 RetrieveDocumentSetResponse
collapse	true

		<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="184.100.10</Value>
 						<Value>urn:ad:dk:medcom:pscr-v1.0:full^^1.2.208.184.100.10</Value>
  						<Value>urn:ad:dk:medcom:cmr-v2.0:full^^1.2.208.184.100.10</Value>
                     </ValueList>
				</Slot>
 				<Slot name="$XDSDocumentEntryReferenceIdList">
					<ValueList>
						<Value>'79a7424d-353d-4458-8c52-859c027dc472^^^1.2.208.176^PregnancyCourseID'</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:xsd:rim:3.0" xmlns:ns9="urn:StatusType:Approved')</Value>
					</ValueList>
				</Slot>
			</AdhocQuery>
</ns3:AdhocQueryRequest>

Retur-svaret indeholder referencerne til dokumenterne i graviditetsmappen, der skal benyttes efterfølgende til at udtrække de konkrete dokumenter i Graviditetsmappen, alle dokumenter har tilknyttet samme graviditetsforløbsid

Code Block

language	xml
title	ITI-18 AdhocQueryResponse
collapse	true

		<ns3:AdhocQueryResponse xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rsrim:3.0" xmlns:ns10ns2="urn:oasis:names:tc:ebxml-regrep:xsd:cmsrs:3.0" xmlns:ns11ns3="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns12ns4="urn:oasis:names:tc:ebxml-regrep:xsd:lcmcms:3.0">
			<ns9:RegistryResponse status xmlns:ns5="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:xsd:lcm:3.0" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns7="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns8="http://www.w3.org/20042000/0809/xop/includexmldsig#" hrefxmlns:ns9="cid:37b3a03a-70c8-45ea-9be5-bbaec58de49a-128338@urn%3Aihe%3Aiti%3Axds-b%3A2007"/>
				</Document>
			</DocumentResponse>
		</RetrieveDocumentSetResponse>

Oprettelse af dokumenter i Graviditetsmappen

Oprettelse af graviditetsdokumenter i Graviditetsmappen foregår via den dokumentregistreringsservic (DROS) som understøtter Graviditetsmappen, detaljeret dokumentation er beskrevet under: Dokumentregistreringsservice

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

Arbejdsgangene omkring skabelsen af dokumenter i den gravides Graviditetsmappe, 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 dokumenter til Graviditetsmappen 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.

http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns10="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns11="http://www.nsi.dk/hsuid/2016/08/hsuid-1.1.xsd" totalResultCount="3" status="urn:ihe:iti:2007:ResponseStatusType:Success">
			<RegistryObjectList>

<!-- Liste af dokumentreferencer -->

			</RegistryObjectList>
		</ns3:AdhocQueryResponse>

Hentning af dokumenter i Graviditetsmappen

Info
Bemærk for at hente en dokumenter i Graviditetsmappen på baggrund af en søgning, skal NSP's Service Deklaration: "Særlige begrænsninger ift. anvendelse af Dokumentdelingsservicen (DDS)" følges. Se: Dokumentdelingsservice (DDS) Opsummeret står der følgende: Der må højst være 10 minutter mellem disse kald (ITI-18 og ITI-43), begge kald skal udføres af samme bruger, og begge kald skal have samme (men unikke) ‘flowID’

Info

Se: Dokumentdelingsservice (DDS)

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

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

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

Code Block

language	xml
title	ITI-43 RetrieveDocumentSetRequest
collapse	true

        <RetrieveDocumentSetRequest xmlns="urn:ihe:

Code Block

language	xml
title	ITI-41 ProvideAndRegisterDocumentSetRequest
collapse	true

		<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 på svar når MedCom frigiver standarderne

            <DocumentRequest>
                </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 dokumenter i Graviditetsmappen

Ændring af dokuemter i graviditetsmappen foregår som oprettelser. Fagsystemet skal blot sikre sig at documententryid'en gemmes lokalt når dokumentet oprettes (husk atdocumententryid 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 med Graviditetsmappen.

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 dokumetnet bliver samtidigt kædet til den tidligere instans - således der er historik på dokumenterne.

Sletning af dokumenter i Graviditetsmappen

Der er ikke udstillet funktionalitet til at slette dokumenter for fagsystemerne.
Dokumenter i graviditetsmappen bliver automatisk slettet efter et givet tidsrum (TODO: Indsættes når lovbekendtgørelse offentliggøres), hvilket fastsættes lovgivningsmæssigt.

<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 dokument i Graviditetsmappen, indeholdende de dataelementer der er beskrevet i MedCom's CDA standarder til Graviditetsmappen

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

Code Block

language	xml
title	ITI-43 RetrieveDocumentSetResponse
collapse	true

		<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 dokumenter i Graviditetsmappen

Oprettelse af graviditetsdokumenter i Graviditetsmappen foregår via den dokumentregistreringsservice (DROS) som understøtter Graviditetsmappen, detaljeret dokumentation er beskrevet under: Dokumentregistreringsservice

Info
Anvenderorganisationerne har mulighed for at benytte egen infrastruktur, og have en opkobling af denne op imod den nationale dokumentdelingsservice. Det er således ikke et krav at dokumentregistreringsservice (DROS) som understøtter graviditetsmappen skal anvendes. Anvenderorganisationerne har derved mulighed for selv at udstille de specificerede CDA-dokumenter enten som statiske dokumenter eller som en on-demand dokumentkilde. Bemærk ITI-18 funktionerne FindDocuments og FindDocumentsByReferenceIdList skal understøttes. Ved at anvende egen infrastruktur, er det ikke nødvendigt for anvenderorganisationerne at vedligeholde en mapning mellem lokale graviditetsdata og de CDA-dokumenter de placerer i Sundhedsdatastyrelsens infrastruktur.

Info

Anvenderorganisationerne har mulighed for at benytte egen infrastruktur, og have en opkobling af denne op imod den nationale dokumentdelingsservice. Det er således ikke et krav at dokumentregistreringsservice (DROS) som understøtter graviditetsmappen skal anvendes.

Anvenderorganisationerne har derved mulighed for selv at udstille de specificerede CDA-dokumenter enten som statiske dokumenter eller som en on-demand dokumentkilde.

Bemærk ITI-18 funktionerne FindDocuments og FindDocumentsByReferenceIdList skal understøttes.

Ved at anvende egen infrastruktur, er det ikke nødvendigt for anvenderorganisationerne at vedligeholde en mapning mellem lokale graviditetsdata og de CDA-dokumenter de placerer i Sundhedsdatastyrelsens infrastruktur.

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

Endpoint til graviditetsmappespecifik DROS er gennem afkoblingskomponenten er: https://<NSP-SERVER_URL>:<NSP-SERVER_PORT>/decoupling/nspservices/gm
SOAPAction for ITI-41 endpoint er "urn:ihe:iti:2007:ProvideAndRegisterDocumentSet-b", se detaljer dokumenteret under: https://www.nspop.dk/display/public/web/DROS+-+Guide+til+anvendere#DROSGuidetilanvendere-Graviditetsmapperepository/registryviaDCC

Direkte endpoint (som kun bør anvendes til testformål er: https://<NSP-SERVER_URL>:<NSP-SERVER_PORT>/dros_gm/iti41
NSP TEST1 endpoint er: http://test1-cnsp.ekstern-test.nspop.dk:8080/dros_gm/iti41
NSP TEST2 endpoint er: https://test2-cnsp.ekstern-test.nspop.dk:8080/dros_gm/iti41

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

Igen som når et dokument hentes, så skal selve ClinicalDocument oprettes som en MIME attachment, se eksemplet for detaljer.

Code Block

language	xml
title	ITI-41 ProvideAndRegisterDocumentSetRequest
collapse	true

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

<!-- Se eksempel for standarderne under gældende standard i MedCom's folder -->

            </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 dokumenter i Graviditetsmappen

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

Info
Anvenderorganisationerne er ansvarlige for at vedligeholde en mapning mellem det lokale data, og de CDA dokumenter de placerer i Sundhedsdatastyrelsens infrastruktur, således de kan foretage opdateringer af CDA-dokumenter som beskrevet.

Sletning af dokumenter i Graviditetsmappen

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 i Graviditetsmappen, ændre dokumentet, og give det status "deprecated". Det kan gøres ved at benytte ITI-57 UpdateDocumentSet, hvorved AvailabilityStatus stættes til "deprecated" i stedet for "approved". UpdateDocumentSet er ligeledes tilgængelig via ovenstående DROS endpoint.

Info
Anvenderorganisationerne er ansvarlige for at vedligeholde en mapning mellem det lokale data, og de CDA dokumenter de placerer i Sundhedsdatastyrelsens infrastruktur, således de kan ændre statusaf CDA-dokumenter som beskrevet.

Adviseringer fra Graviditetsmappen

Graviditetsmappen vil udsende en advisering hver gang der sker en oprettelse eller en ændring af et dokument graviditetsmappen (ITI-41 og ITI-57 kald)

Info
Anvenderorganisationerne der benytter egen infrastruktur, skal kunne anvende det beskrevne topic på den nationale adviseringsservice, således der også notificeres på dokumenter der ligger i den lokal infrastruktur. On-demand dokumentkilder kan ikke udsende notifikationer, da det altid er seneste version af et dokument som hentes.

Info

Anvenderorganisationerne der benytter egen infrastruktur, skal kunne anvende det beskrevne topic på den nationale adviseringsservice, således der også notificeres på dokumenter der ligger i den lokal infrastruktur.

On-demand dokumentkilder kan ikke udsende notifikationer, da det altid er seneste version af et dokument som hentes.

Den tekniske understøttelse af adviseringer fra Graviditetsmappen følger de overordnede principper udstukket af den Nationale Adviseringsservice (NAS)

Fagsystemerne kan implementere en adviseringskomponent, der håndterer at fagsystemet kan lytte på adviseringer fra Graviditetsmappen, således de bliver notificeret om nye eller ændrede dokumenter.
Den tekniske dokumentation i forhold til brugen af de viste endpoints til NAS, er beskrevet i NAS-2 Anvenderguide

Topic

Navn til Topic for ændringer til stamkortregisteret er:

http://sundhedsdatastyrelsen.dk/PregnancyDocuments/2024/06/01:PregnancyDocumentUpdated

Endpoint NSP TEST-1: https://test1.ekstern-test.nspop.dk:8443/nas2
Endpoint NSP TEST-2: https://test2.ekstern-test.nspop.dk:8443/nas2
Endpoint NSP Produktion: Der skal laves en sundhedsdatanetaftale mod: Service #2127 (195.80.254.10 nas-prod.nsp.dsdn.dk (http_8080, tcp-8443))

Beskedformat

Beskedformat for ændringer i Graviditetsmappen, er pakket ind i NAS'ens generelle beskedformat (Markeret med blåt)

Indholdet i notifikationen er neutralt, idet der ikke må inkluderes hvad ændringen omhandler. Følgende værdier ligger i adviseringen

id: Patientens CPR nummer
date: Dato for hvornår ændringen er sket
type: Type for beskeddefinitionen
version: Versionsnummer for beskeddefinitionen.
messageid: unik besked-id på baggrund af enten DGWS eller IDWS kald, derved har fagsystemer mulighed for at se om adviseringen sker på baggrund af fagsystemets egne opdateringer.

<NotificationMessage>
<Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">http://sundhedsdatastyrelsen.dk/PregnancyDocuments/2024/06/01:PregnancyDocumentUpdated</Topic>
<Message>
<NotifyContent id="borgerens CPR nummer" idType="http://nsi.dk/advis/v10/CPR">
<PregnancyDocumentUpdated xmlns:ns16="http://sundhedsdatastyrelsen.dk/gm/2024/06/01" xmlns:ns2="http://www.w3.org/2005/08/addressing" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<date value="2024-06-13"/>
<messageId value="messageid fra MedCom header til request der skabte adviseringen"/>
<type value="http://sundhedsdatastyrelsen.dk/MessageDefinition/Pregnancy-notification"/>
<version value="1"/>
</PregnancyDocumentUpdated>
</NotifyContent>
</Message>
</NotificationMessage>

Det skal bemærkes, at der godt kan foreligge flere adviseringer for den samme patient, da der vil blive skabt en advisering hver gang der er foretaget en ændring på patientens data i graviditetsmappen. Fagsystemet skal kunne håndtere dette scenarie. Uanset hvor mange adviseringer der ligger i pullpointet, skal der dog kun foretages en synkronisering.

Ved tekniske fejl er der altid en risiko for at adviseringer går tabt, fagsystemet bør derfor have mulighed for at hente graviditetsdata fra graviditetsmappen, selvom det ikke har modtaget en advisering, eksempelvis via en aktiv handling fra en sundhedsperson.Fagsystemer kan, hvis dokumentet ikke længere bør deles i Graviditetsmappen, æ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

...

Bevis for fuldmagter er understøttet i OIO-IDWS identitytokens signeret af STS'en, dog understøtter dokumentdelingsservicen ikke fuldmagter i 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 .

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

Graviditetsspecifik indhold i henvisninger

MedCom er i spidsen for en arbejdsgruppe, som skal afklare hvordan det kan muliggøres at effektivisere visitationen af den gravide.

via dokumentdelingsservicen, kan ses i HSUID header dokumentation.

Graviditetsspecifik indhold i henvisninger

GMv2 ændrer ikke på nuværende anvendelser af MedCom's meddelelsestyper (REF01 og DIS91).
MedCom har igangsat et moderniseringsprojekt, herunder en moderisering af meddelelsestyper. Graviditetsprojektet har givet input til at nye meddelelsestyper skal kunne indeholde bl.a. et graviditetsforløbsid.

For GMv2 betyder dette at nuværende meddelelsestyper (henvisninger og korrespondancemeddelelser) fastholdes, man at der til henvisningen vedhæftes en PDF-fil indeholdende visitationsgrundlaget for svangrehenvisningen.

Regioner kan derved modtage bl.a. den gravides ønskede fødested, estimerede terminsdato, omsorgsniveau samt det tekniske graviditetsforløbsid ud fra denne PDF-fil vedhæftning. TODO: Når arbejdsgruppen er kommet frem til en konklusion, vil der blive refereret til den herfra

Ændringslog

0.8	2023-04-22	Udkast til Teknisk implementeringsguide	SDS
1.0	2024-05-29	Endelig udgave til GM version 2 (GMv2)	SDS
1.1	2024-0408-0222	Præcisering af punkt 6. sådan at reference til den nuværende DSJ-løsning udeladesOpdateret, således kun referencer til MedCom's CDA standarder mangler	SDS

Content

Space Tools

Versions Compared

Old Version 10

New Version Current

Key

Indledning

Indhold i Graviditetsmappen

Søgning ud fra GraviditetsforløbsID

Hentning af dokumenter i Graviditetsmappen

Oprettelse af dokumenter i Graviditetsmappen

Hentning af dokumenter i Graviditetsmappen

Ændring af dokumenter i Graviditetsmappen

Sletning af dokumenter i Graviditetsmappen

Oprettelse af dokumenter i Graviditetsmappen

Ændring af dokumenter i Graviditetsmappen

Sletning af dokumenter i Graviditetsmappen

Adviseringer fra Graviditetsmappen

Sikkerhed, roller og rettigheder

Graviditetsspecifik indhold i henvisninger

Graviditetsspecifik indhold i henvisninger

Ændringslog