FHIR R4-Betrieb $davinci-data-export für HealthLake - AWS HealthLake
Wichtigste FunktionenEndpunkt des VorgangsAnforderungsparameterBeispielanforderungBeziehungen zu RessourcenVerwaltung von AufträgenAusgabeformatFehlerbehandlungSicherheit und AutorisierungBewährte MethodenEinschränkungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

FHIR R4-Betrieb $davinci-data-export für HealthLake

Der $davinci-data-export Vorgang ist ein asynchroner FHIR-Vorgang, der den Export von Daten aus der Mitgliedsattributionsliste ermöglicht. AWS HealthLake Bei diesem Vorgang handelt es sich um eine spezielle Version des standardmäßigen $export FHIR-Vorgangs, der speziell für die Erfüllung der Anforderungen des Implementierungsleitfadens für die DaVinci Mitgliederzuordnungsliste (ATR) konzipiert wurde.

Wichtigste Funktionen

  • Asynchrone Verarbeitung: Folgt dem standardmäßigen asynchronen FHIR-Anforderungsmuster

  • Export auf Gruppenebene: Exportiert Daten für Mitglieder innerhalb einer bestimmten Attributionsliste (Gruppe)

  • Spezialisierter Umgang mit Ressourcen: Konzentriert sich auf Ressourcen im Zusammenhang mit der Zuordnung

  • Flexibles Filtern: Unterstützt das Filtern nach Patienten, Ressourcentypen und Zeiträumen

  • NDJSON-Ausgabe: Stellt Daten im durch Zeilenumbruch getrennten JSON-Format bereit

Endpunkt des Vorgangs

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

Anforderungsparameter

Parameter Kardinalität Description
Patientin 0.. * Bestimmte Mitglieder, deren Daten exportiert werden sollen. Wenn nicht angegeben, werden alle Mitglieder der Gruppe exportiert
_typ 0.. 1 Kommagetrennte Liste der zu exportierenden FHIR-Ressourcentypen
_seit 0.. 1 Schließt nur Ressourcen ein, die nach diesem Datum/dieser Uhrzeit aktualisiert wurden
Exporttyp 0.. 1 Art des auszuführenden Exports (Standard: hl7.fhir.us.davinci-atr)

Unterstützte Ressourcentypen

Bei Verwendung des _type Parameters werden nur die folgenden Ressourcentypen unterstützt:

  • Group (Gruppieren)

  • Patient

  • Deckung

  • RelatedPerson

  • Praktiker

  • PractitionerRole

  • Organisation

  • Speicherort

Beispielanforderung

Exportjob starten

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"
    }
  }
}

Beispielantwort

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

Beziehungen zu Ressourcen

Der Vorgang exportiert Ressourcen auf der Grundlage ihrer Beziehungen innerhalb der Mitgliedsattributionsliste:

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

Quellen der Ressourcen

Ressource Standort der Quelle Description
Patient Gruppe.Mitglied.Entität Die Patienten, die Mitglieder der Zuordnungsliste sind
Deckung group.member.extension: Deckungsreferenz Versicherungsschutz, der zur Patientenmitgliedschaft führte
Organisation group.member.extension: attributedProvider Organizations, denen Patienten zugeschrieben werden
Praktiker group.member.extension: Anbieter mit Attributen Patienten werden einzelnen Ärzten zugeschrieben
PractitionerRole group.member.extension: attributedProvider Die Rollen des Praktikers werden den Patienten zugeschrieben
RelatedPerson Reichweite. Abonnent Abonnenten der Berichterstattung
Speicherort PractitionerRole. Standort Standorte, die den Rollen von Praktikern zugeordnet sind
Group (Gruppieren) Eingabeendpunkt Die Zuordnungsliste selbst

Verwaltung von Aufträgen

Überprüfen Sie den Jobstatus

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

Auftrag abbrechen

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

Auftragslebenszyklus

  • SUBMITTED- Der Job wurde empfangen und in die Warteschlange gestellt

  • IN_PROGRESS- Der Job wird aktiv bearbeitet

  • COMPLETED- Job erfolgreich abgeschlossen, Dateien zum Herunterladen verfügbar

  • FAILED- Job ist auf einen Fehler gestoßen

Ausgabeformat

  • Dateiformat: NDJSON (Newline Delimited JSON)

  • Dateiorganisation: Separate Dateien für jeden Ressourcentyp

  • Dateierweiterung: .ndjson

  • Speicherort: Spezifizierter S3-Bucket und Pfad

Fehlerbehandlung

Der Vorgang gibt HTTP 400 Bad Request mit einer OperationOutcome der folgenden Bedingungen zurück:

Fehler bei der Autorisierung

  • Ungültige oder unzureichende Berechtigungen für den Datenzugriff

  • Probleme beim Zugriff auf S3-Buckets

  • Probleme beim Zugriff auf KMS-Schlüssel

Fehler bei der Parametervalidierung

  • patientDer Parameter ist nicht als "Patient/id,Patient/id,...“ formatiert

  • Ungültige Patientenreferenzen oder Patienten, die nicht zur Gruppe gehören

  • exportTypeanderer Wert als hl7.fhir.us.davinci-atr

  • _typeParameter, der nicht unterstützte Ressourcentypen enthält

  • _typeDem Parameter fehlen die erforderlichen Mindesttypen (Group, Patient, Coverage) für den ExportType von hl7.fhir.us.davinci-atr

Fehler bei der Ressourcenvalidierung

  • Die angeforderte Gruppenressource ist nicht vorhanden

  • Die Gruppe hat eine leere Mitgliederliste

  • Gruppenmitglieder verweisen nicht auf gültige Patientenressourcen

Sicherheit und Autorisierung

  • Es gelten die standardmäßigen FHIR-Autorisierungsmechanismen

  • Die Clients müssen über die entsprechenden Leseberechtigungen für die Gruppe und die zugehörigen Ressourcen verfügen

  • S3-Bucket-Schreibberechtigungen für den Ausgabespeicherort erforderlich

  • KMS-Schlüsselberechtigungen sind erforderlich, wenn Verschlüsselung angegeben ist

Bewährte Methoden

  • Auswahl des Ressourcentyps: Fordern Sie nur die Ressourcentypen an, die Sie benötigen, um die Exportgröße und die Verarbeitungszeit zu minimieren

  • Zeitbasierte Filterung: Verwenden Sie den _since Parameter für inkrementelle Exporte

  • Patientenfilterung: Verwenden Sie den patient Parameter, wenn Sie nur Daten für bestimmte Mitglieder benötigen

  • Auftragsüberwachung: Überprüfen Sie regelmäßig den Auftragsstatus für große Exporte

  • Fehlerbehandlung: Implementieren Sie die richtige Wiederholungslogik für fehlgeschlagene Jobs

Einschränkungen

  • Im Parameter können maximal 512 Patienten angegeben werden patient

  • Der Export ist nur auf Operationen auf Gruppenebene beschränkt

  • Unterstützt nur den vordefinierten Satz von attributionsbezogenen Ressourcentypen

  • Die Ausgabe erfolgt immer im NDJSON-Format