FHIR Bulk Data

• Stai costruendo un client per dati in blocco che deve avviare esportazioni, eseguire il polling dello stato e scaricare file NDJSON da un server FHIR.
• Stai implementando il supporto server-side per $export e hai bisogno di comprendere i requisiti di conformità, la struttura del manifest o le dichiarazioni CapabilityStatement.
• Hai bisogno di filtrare esportazioni di grandi dimensioni per tipo di risorsa, intervallo di date o criteri di ricerca FHIR utilizzando parametri come _type, _since o _typeFilter.
• Stai integrando SMART Backend Services (credenziali client OAuth 2.0 + JWT) per un accesso bulk sicuro da server a server.

• Hai bisogno di recuperare singole risorse FHIR tramite REST standard — usa invece uno skill FHIR generico.
• Il tuo caso d'uso prevede lo streaming di dati in tempo reale o quasi in tempo reale, anziché l'esportazione in batch.
• Stai lavorando con un formato di esportazione in blocco proprietario che non segue l'HL7 Bulk Data Access IG.

Ti guida attraverso ogni fase del ciclo di vita dell'esportazione bulk: richiesta di avvio, gestione del 202 Accepted, polling dello stato con Retry-After e X-Progress, analisi del manifest, download dei file e pulizia con DELETE.

Copre Patient/$export (tutti i pazienti), Group/[id]/$export (limitato a una coorte) e [base]/$export (a livello di sistema), inclusi i casi d'uso di ciascuno e il modo in cui il perimetro di applicazione influisce sull'output.

Guida dettagliata su tutti i parametri supportati: _outputFormat, _since, _until, _type, _elements, _typeFilter, includeAssociatedData, organizeOutputBy e allowPartialManifests.

Regole precise per produrre e consumare JSON delimitato da nuove righe: una risorsa per riga, codifica UTF-8, corretta terminazione di riga, nessuna nuova riga incorporata e tipo di media corretto (application/fhir+ndjson).

Spiega il flusso delle credenziali client OAuth 2.0 con asserzione JWT richiesta per l'accesso bulk server-to-server, inclusa la struttura della richiesta di token e l'utilizzo del bearer token.

Tratta l'interpretazione di OperationOutcome, il rate limiting (429 Too Many Requests), la scadenza del token (401), il job mancante (404) e le strategie per client di polling resilienti.

Implementa un client che avvia un'esportazione, interroga l'URL di stato con backoff esponenziale, analizza il manifest completo e trasmette in streaming i file NDJSON per l'elaborazione a valle.

Configura un server FHIR per supportare $export, restituire le corrette risposte HTTP in ogni fase del flusso di lavoro e dichiarare la conformità tramite CapabilityStatement.

Utilizza Group/$export con i parametri _type, _since e _typeFilter per esportare solo i tipi di risorse e gli intervalli di date necessari per uno specifico caso d'uso di analisi o ricerca.

Diagnostica e risolvi gli errori di esportazione massiva interpretando le risposte OperationOutcome, comprendendo la semantica degli status HTTP e gestendo i casi limite come i manifest parziali e l'output paginato.