FHIR DocumentReference
FHIR DocumentReference er tatt i bruk som en del av nye nasjonal time løsning. FHIR DocumentReference benyttes også i Skjemaløsning (se Benyttede FHIR Ressurser i Skjemaløsningen)
Det er ikke laget en egen profile, men følgende er veiledning i bruk av eksisterende nasjonal profil https://simplifier.net/hl7norwayno-basis/nobasisdocumentreference
Gjenerelt om DocumentReference i ny timeløsning
Ressursen er lagt inn som contained ressurs i Appointment og er referert fra appointment.supportingInformation. I løsningen er DocumentReference brukt som bærer av innkallingsbrev eller peker til innkallingsbrev. Det hindrer ikke at resursen kan bære andre typer dokument i andre løsninger.
Implementering av DocumentReference for innkallingsbrev som XDS dokument
|
|---|
id : Dette er den logiske identifikatoren for ressursen. Den brukes internt for å identifisere denne ressursen og er ikke det samme som XDS-identifikatoren. Andre FHIR-ressurser kan bruke denne ID-en til å vise til dette dokumentet. <id value="1ba90062-3872-4124-b2a4-2b65ba630031"/> |
masterIdentifier (mandatory): MasterIdentifier representerer den globale unike identifikatoren for dokumentet i XDS-registeret og tilsvarer DocumentEntry.uniqueId i XDS.b-spesifikasjonen. System-attributtet “urn:ietf:rfc:3986” viser at verdien følger URI/URN-format, mens value-feltet inneholder OID-en som unikt identifiserer dokumentet i det norske helsenettet. <masterIdentifier>
<system value="urn:ietf:rfc:3986"/>
<value value="urn:oid:2.16.578.1.12.4.1.2.5604"/>
</masterIdentifier> |
identifier (mandatory): Dette er en annen identifikator for dokumentet. Den brukes ofte til å referere til DocumentEntry.entryUUID i XDS. Forskjellen fra masterIdentifier er at masterIdentifier vanligvis er den stabile, globale identifikatoren som ikke endres, mens identifier kan være spesifikk for en bestemt repository eller versjon av dokumentet. <identifier>
<system value="urn:ietf:rfc:3986"/>
<value value="urn:oid:2.16.578.1.12.4.3.1.3.40.20.1870.2.1"/>
</identifier> |
status (mandatory): Status-feltet angir tilstanden til DocumentReference-ressursen, ikke selve dokumentet. Når verdien er “current”, betyr det at dokumentet er gyldig og tilgjengelig for bruk. Andre mulige verdier er “superseded” når dokumentet er erstattet, eller “entered-in-error” dersom dokumentet er registrert ved en feil. I XDS tilsvarer dette feltet availabilityStatus, for eksempel “Approved”. <status value="current"/> |
meta.profile(mandatory): Meta-seksjonen inneholder metadata om ressursen. Her peker profilen til den norske “no-basis-DocumentReference”-profilen, som angir hvilke regler, koder og felt som skal brukes for DocumentReference i Norge. Dette sikrer at ressursen er i tråd med nasjonal implementasjonsguide. <meta>
<profile value="http://hl7.no/fhir/StructureDefinition/no-basis-DocumentReference"/>
</meta> |
type: Type inneholder informasjon om hvilken type dokument ressursen refererer. Kodeverk: Dokumenttyper (9602) Kode for innkallingsbrev er <type>
<coding>
<system value="urn:oid:2.16.578.1.12.4.1.1.9602"/>
<code value="I02-2"/>
</coding>
</type> |
content.attachement (mandatory): Content-elementet beskriver hvordan dokumentet kan hentes, og hvert content-element kan representere en tilgjengelig versjon av dokumentet, for eksempel i PDF eller CDA-format. Inne i attachment defineres hvordan selve dokumentet kan nås. Feltet contentType angir MIME-typen, her “application/pdf”, slik at systemer vet hvilket format de får når dokumentet hentes. URL-feltet inneholder en XDS-referanse som følger IHEs ITI-standard (her ITI:2010), og viser til hvor dokumentet kan hentes i XDS-repositoryet. Denne verdien er ikke en direkte HTTP-adresse, men en urn som brukes av systemer som støtter IHE XDS-transaksjoner (som ITI-66 eller ITI-68). Title-feltet gir en kort og menneskelesbar beskrivelse av dokumentet som kan brukes i visninger eller pasientjournaler. <content>
<attachment>
<contentType value="application/pdf"/>
<url value="urn:ihe:iti:xds:2010:213b1b36-789e-0010-e063-2640b40a240a"/>
<title value="Innkallingsbrev"/>
</attachment>
</content> |
Implementering av DocumentReference for innkallingsbrev som vedlegg
Innkallingsbrev som vedlegg - I ny time løsning er satt grense på 20Mb totalt for vedlegg.
|
|---|
id : Dette er den logiske identifikatoren for ressursen. Den brukes internt for å identifisere denne ressursen og er ikke det samme som business identifikatoren. Andre FHIR-ressurser kan bruke denne ID-en til å vise til dette dokumentet. <id value="aa7546d0-e90c-4f07-9c63-e011aa060733"/> |
identifier (mandatory): Dette er business identifikator for dokumentet. <identifier>
<system value="urn:ietf:rfc:3986"/>
<value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier> |
status (mandatory): Status-feltet angir tilstanden til DocumentReference-ressursen, ikke selve dokumentet. Når verdien er “current”, betyr det at dokumentet er gyldig og tilgjengelig for bruk. Andre mulige verdier er “superseded” når dokumentet er erstattet, eller “entered-in-error” dersom dokumentet er registrert ved en feil. <status value="current"/> |
meta.profile(mandatory): Meta-seksjonen inneholder metadata om ressursen. Her peker profilen til den norske “no-basis-DocumentReference”-profilen, som angir hvilke regler, koder og felt som skal brukes for DocumentReference i Norge. Dette sikrer at ressursen er i tråd med nasjonal implementasjonsguide. <meta>
<profile value="http://hl7.no/fhir/StructureDefinition/no-basis-DocumentReference"/>
</meta> |
type: Type inneholder informasjon om hvilken type dokument ressursen refererer. Kodeverk: Dokumenttyper (9602) Kode for innkallingsbrev er <type>
<coding>
<system value="urn:oid:2.16.578.1.12.4.1.1.9602"/>
<code value="I02-2"/>
</coding>
</type> |
content.attachement (mandatory): Dokument legges inn base-64 encoded. I ny time løsning er det totall grense på 20 Mb for alle vedlegg. ContentType, Data og Title må legges inn i attachement. <content>
<attachment>
<contentType value="application/pdf"/>
<Data value= "{{document content-base64 encoded}}"/>
<title value="{{document title}}"/>
</attachment>
</content> |