Spiegazione dei Bundle FHIR: i nove tipi e quando usarli

Risposta breve: Un Bundle è la risorsa FHIR che raggruppa altre risorse: risultati di ricerca, un set di scritture inviate in un'unica richiesta, un documento clinico come un riassunto del paziente o un messaggio. Il suo type indica cosa significa il gruppo e come un server deve gestirlo.

I nove tipi in FHIR R4

• searchset: i risultati di una ricerca, con collegamenti per la paginazione.
• transaction: scritture elaborate tutte o nessuna; se una fallisce, nessuna viene applicata.
• batch: scritture elaborate in modo indipendente; ogni voce ha successo o fallisce da sola.
• transaction-response / batch-response: ciò che il server restituisce per ciascuno.
• document: un documento clinico (la prima voce è una Composition), come l'International Patient Summary; viene firmato o archiviato per intero.
• message: un messaggio, la prima voce è un MessageHeader.
• history: le versioni delle risorse.
• collection: un insieme di risorse senza ulteriore significato.

Transaction vs batch

Utilizzare una transaction quando le risorse dipendono l'una dall'altra, ad esempio un Paziente e le Osservazioni che lo referenziano: i riferimenti tra le voci possono utilizzare identificatori temporanei urn:uuid: che il server risolve. Utilizzare un batch per operazioni indipendenti in cui il successo parziale è accettabile.

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {"fullUrl": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a",
     "resource": {"resourceType": "Patient", "name": [{"family": "Example"}]},
     "request": {"method": "POST", "url": "Patient"}},
    {"resource": {"resourceType": "Observation", "status": "final",
       "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]},
       "subject": {"reference": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a"},
       "valueQuantity": {"value": 72, "unit": "/min", "system": "http://unitsofmeasure.org", "code": "/min"}},
     "request": {"method": "POST", "url": "Observation"}}
  ]
}

In Anpheros

Anpheros Platform accetta bundle di tipo transaction e batch e restituisce bundle di tipo searchset con paginazione; l'International Patient Summary viene restituito come bundle di tipo document. Vedi il sandbox FHIR per provarli, e l'International Patient Summary in FHIR.

Pagine correlate

• Ricerca FHIR spiegata
• FHIR R4 vs R5

Fonti

• HL7 FHIR R4: Bundle
• HL7 FHIR R4: Tipi di Bundle

Domande frequenti

Qual è la differenza tra una transaction FHIR e un batch?

Una transaction è tutto o niente; un batch elabora ogni voce in modo indipendente.

Come faccio a referenziare una risorsa creata nello stesso bundle?

Assegnale un fullUrl come urn:uuid:... e usalo come riferimento; in una transaction il server lo sostituisce con l'id reale.

Che tipo è un riassunto del paziente?

Un bundle di tipo document la cui prima voce è una Composition.

Perché la mia ricerca restituisce un Bundle?

I risultati della ricerca sono sempre un bundle di tipo searchset, con collegamenti alla pagina successiva.

Anpheros Platform

Provalo gratis nella sandbox

La tua prima chiamata FHIR in 5 minuti. Un'API HL7 FHIR R4 con il consenso del paziente integrato: provala nella sandbox, poi collega la tua app o il sistema della tua clinica.

Crea una sandbox gratuitaLeggi le guide per sviluppatori →

Gratis · 30 pazienti sintetici · senza carta

Scritto da

Il team Anpheros

Anpheros sviluppa una cartella clinica che il paziente controlla e può condividere con qualsiasi studio medico, su una piattaforma HL7 FHIR R4, con sede in UE. Queste guide ti aiutano a comprendere e organizzare la tua salute; non sostituiscono il tuo medico.

Chi siamo →