Funzionamento FHIR R4 $davinci-data-export per HealthLake - AWS HealthLake
Caratteristiche chiaveOperazione EndpointParametri della richiestaRichiesta di esempioRelazioni con le risorseGestione del JobFormato di outputGestione erroriSicurezza e autorizzazioneBest practiceLimitazioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Funzionamento FHIR R4 $davinci-data-export per HealthLake

L'$davinci-data-exportoperazione è un'operazione FHIR asincrona che consente l'esportazione dei dati della Member Attribution List da. AWS HealthLake Questa operazione è una versione specializzata dell'operazione standard FHIR, progettata specificamente per soddisfare i requisiti della DaVinci Member Attribution List $export Implementation Guide.

Caratteristiche chiave

  • Elaborazione asincrona: segue lo schema di richiesta asincrona FHIR standard

  • Esportazione a livello di gruppo: esporta i dati per i membri all'interno di un elenco di attribuzioni specifico (gruppo)

  • Gestione specializzata delle risorse: si concentra sulle risorse relative all'attribuzione

  • Filtraggio flessibile: supporta il filtraggio per pazienti, tipi di risorse e intervalli di tempo

  • Output NDJSON: fornisce dati in formato JSON delimitato da nuove righe

Operazione Endpoint

GET  [base]/Group/[id]/$davinci-data-export
POST [base]/Group/[id]/$davinci-data-export

Parametri della richiesta

Parametro Cardinalità Description
paziente 0.. * Membri specifici i cui dati devono essere esportati. Se omesso, tutti i membri del Gruppo vengono esportati
_tipo 0.. 1 Elenco delimitato da virgole di tipi di risorse FHIR da esportare
_dal 0.. 1 Includi solo le risorse aggiornate dopo questa data/ora
Tipo di esportazione 0.1.. Tipo di esportazione da eseguire (impostazione predefinita: hl7.fhir.us.davinci-atr)

Tipi di risorsa supportati

Quando si utilizza il parametro, sono supportati solo i seguenti tipi di risorse: _type

  • Gruppo

  • Paziente

  • Copertura

  • RelatedPerson

  • Professionista

  • PractitionerRole

  • Organizzazione

  • Location (Ubicazione)

Richiesta di esempio

Avvio di un Export Job

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage&exportType=hl7.fhir.us.davinci-atr

or

POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage&exportType=hl7.fhir.us.davinci-atr
Content-Type: application/json

{
  "DataAccessRoleArn": "arn:aws:iam::444455556666:role/your-healthlake-service-role",
  "JobName": "attribution-export-job",
  "OutputDataConfig": {
    "S3Configuration": {
      "S3Uri": "s3://your-export-bucket/EXPORT-JOB",
      "KmsKeyId": "arn:aws:kms:region:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab"
    }
  }
}

Risposta di esempio

{
  "datastoreId": "eaee622d8406b41eb86c0f4741201ff9",
  "jobStatus": "SUBMITTED",
  "jobId": "48d7b91dae4a64d00d54b70862f33f61"
}

Relazioni con le risorse

L'operazione esporta le risorse in base alle loro relazioni all'interno dell'Elenco di attribuzione dei membri:

Group (Attribution List)
├── Patient (Members)
├── Coverage → RelatedPerson (Subscribers)
├── Practitioner (Attributed Providers)
├── PractitionerRole → Location
└── Organization (Attributed Providers)

Fonti di risorse

Risorsa Ubicazione della fonte Description
Paziente Group.Member.Entity I pazienti che sono membri della lista di attribuzione
Copertura group.member.extension: riferimento alla copertura Copertura che ha portato all'iscrizione del paziente
Organizzazione group.member.extension: AttributedProvider Organizzazioni a cui vengono attribuiti i pazienti
Professionista group.member.extension: AttributedProvider I pazienti sono attribuiti ai singoli medici
PractitionerRole group.member.extension: AttributedProvider Ruoli di professionista a cui vengono attribuiti i pazienti
RelatedPerson Copertura. Abbonato Abbonati della copertura
Location (Ubicazione) PractitionerRole.posizione Sedi associate ai ruoli dei professionisti
Gruppo Endpoint di input La lista di attribuzione stessa

Gestione del Job

Verifica lo stato del lavoro

GET [base]/export/[job-id]

Annullamento di un processo

DELETE [base]/export/[job-id]

Ciclo di vita del processo

  • SUBMITTED- Il lavoro è stato ricevuto e messo in coda

  • IN_PROGRESS- Job è in fase di elaborazione attiva

  • COMPLETED- Job terminato con successo, file disponibili per il download

  • FAILED- Job ha riscontrato un errore

Formato di output

  • Formato di file: NDJSON (Newline Delimited JSON)

  • Organizzazione dei file: file separati per ogni tipo di risorsa

  • Estensione del file: .ndjson

  • Posizione: bucket e percorso S3 specificati

Gestione errori

L'operazione restituisce HTTP 400 Bad Request con un OperationOutcome per le seguenti condizioni:

Errori di autorizzazione

  • Autorizzazioni non valide o insufficienti per l'accesso ai dati

  • Problemi di accesso al bucket S3

  • Problemi di accesso alle chiavi KMS

Errori di convalida dei parametri

  • patientparametro non formattato come "Patient/id,Patient/id,...»

  • Riferimenti ai pazienti non validi o pazienti che non fanno parte del Gruppo

  • exportTypevalore diverso da hl7.fhir.us.davinci-atr

  • _typeparametro contenente tipi di risorse non supportati

  • _typeparametro privo dei tipi minimi richiesti (Group, Patient, Coverage) per ExportType di hl7.fhir.us.davinci-atr

Errori di convalida delle risorse

  • La risorsa del gruppo richiesta non esiste

  • Il gruppo ha un elenco di membri vuoto

  • I membri del gruppo non fanno riferimento a risorse valide per i pazienti

Sicurezza e autorizzazione

  • Si applicano i meccanismi di autorizzazione FHIR standard

  • I clienti devono disporre delle autorizzazioni di lettura appropriate per il Gruppo e le risorse correlate

  • Sono necessarie le autorizzazioni di scrittura del bucket S3 per la posizione di output

  • Le autorizzazioni della chiave KMS sono necessarie se viene specificata la crittografia

Best practice

  • Selezione del tipo di risorsa: richiedi solo i tipi di risorse necessari per ridurre al minimo le dimensioni di esportazione e i tempi di elaborazione

  • Filtraggio basato sul tempo: utilizza il _since parametro per le esportazioni incrementali

  • Filtraggio dei pazienti: utilizza il patient parametro quando sono necessari solo i dati per membri specifici

  • Job Monitoring: controlla regolarmente lo stato del lavoro per esportazioni di grandi dimensioni

  • Gestione degli errori: Implementa una logica di ripetizione corretta per i lavori non riusciti

Limitazioni

  • Nel parametro è possibile specificare un massimo di 512 pazienti patient

  • L'esportazione è limitata alle sole operazioni a livello di gruppo

  • Supporta solo il set predefinito di tipi di risorse relativi all'attribuzione

  • L'output è sempre in formato NDJSON