Composition
Composition representerer et signert skjemadokument i Open Aidn.
Open Aidn eksponerer foreløpig utvalgte felter fra HL7 FHIR R4-grunnressursen Composition. En formell Aidn-profil kan bli publisert senere.
Standarder og profiler
- HL7 FHIR R4: Composition
- HL7 FHIR R4 search: FHIR search
Endepunkter
| Metode | Path | Påkrevd scope | Beskrivelse |
|---|---|---|---|
POST |
/Composition/_search |
composition.search |
Søk med application/x-www-form-urlencoded body-parametre. |
GET |
/Composition/{id} |
composition.read |
Les én Composition med skjemainstans-ID. |
Søkeresponser returneres som FHIR Bundle-ressurser med type satt til searchset.
Søkeparametre
| Parameter | Type | Beskrivelse |
|---|---|---|
patient.Identifier |
identifier | Pasientidentifikator brukt til å filtrere compositions for én pasient. |
type |
token | Composition-type. Flere typeverdier kan sendes kommaseparert. |
_include |
token, repeterbar | Legger støttede refererte ressurser til responsbundlen. |
patient.Identifier og type er påkrevd for søk.
Støttede dokumenttyper
Parameteren type angir hvilken dokumenttype det skal søkes etter. Støttede verdier kan utvides over tid. Her er noen eksempler:
| Kode | System | Merknad |
|---|---|---|
A04-2 |
volven:9602 |
Sykepleiesammenfatning. |
B01-2 |
volven:9602 |
Tverrfaglig behandlingsplan. |
445414007 |
http://snomed.info/sct |
Clinical frailty scale. |
Sett sammen søkeparameteren type som <system>|<code>, for eksempel type=urn:oid:2.16.578.1.12.4.1.1.9602|A04-2. Open Aidn støtter både urn:oid:2.16.578.1.12.4.1.1.9602 og volven:9602 som system for Volven dokumenttyper. Flere dokumenttyper kan sendes som én kommaseparert verdi uten mellomrom, for eksempel type=volven:9602|A04-2,volven:9602|B01-2.
Støttede includes
_include-verdi |
Inkludert ressurs | Beskrivelse |
|---|---|---|
Composition:author |
Practitioner |
Legger til refererte forfatterressurser. |
Composition:subject |
Patient |
Legger til refererte pasientressurser. |
Composition:encounter |
Encounter |
Legger til refererte encounter-ressurser. |
Responsfelter
Open Aidn kan utvide responsen over tid, men integrasjoner bør foreløpig forvente data i disse feltene:
| Felt | Beskrivelse |
|---|---|
id |
Composition-identifikator. |
meta.lastUpdated |
Tidspunkt for siste oppdatering når tilgjengelig. |
type |
Koding for Composition-type. |
status |
FHIR Composition-status, for eksempel final, preliminary eller entered-in-error. |
date |
Klinisk tidspunkt for composition. |
title |
Dokumenttittel. |
author.reference |
Referanse til forfatter/behandler. |
subject.reference |
Referanse til pasienten. |
encounter.reference |
Referanse til encounter når tilgjengelig. |
section.title |
Seksjonstittel for hvert skjemafelt. |
section.text.div |
Tekstverdi for hvert skjemafelt når tilgjengelig. |
Eksempelsøk
POST /Composition/_search HTTP/1.1
Host: <OPEN_AIDN_FHIR_HOST>
Accept: application/fhir+json
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer <ACCESS_TOKEN>
patient.Identifier=<PATIENT_IDENTIFIER>&type=<SYSTEM>|<CODE>&_include=Composition:author
Responsen er en FHIR search bundle med matchende Composition-ressurser og eventuelle forespurte includes.