View a markdown version of this page

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

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

Bei dem $davinci-data-export Vorgang handelt es sich um einen asynchronen FHIR-Vorgang, aus dem Sie Gesundheitsdaten exportieren können. AWS HealthLake Dieser Vorgang unterstützt mehrere Exporttypen, darunter Member Attribution (ATR), PDex Provider Access und Member Access. Payer-to-Payer APIs Es handelt sich um eine spezielle Version des $export Standard-FHIR-Vorgangs, die darauf ausgelegt ist, die Anforderungen der DaVinci Implementierungsleitfäden zu erfüllen.

Wichtigste Funktionen

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

  • Export auf Gruppenebene: Exportiert Daten für Mitglieder innerhalb einer bestimmten Gruppenressource

  • Mehrere Exporttypen: Unterstützt ATR (Member Attribution), PDex Provider Access und Payer-to-Payer Member Access APIs

  • Umfassender Profilsupport: Beinhaltet US Core, CARIN Blue Button und PDex Profile

  • Flexible Filterung: Unterstützt die Filterung 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
patient 0.. * Bestimmte Mitglieder, deren Daten exportiert werden sollen. Wenn dieser Wert weggelassen wird, werden alle Mitglieder der Gruppe exportiert.
_type 0.. 1 Kommagetrennte Liste der zu exportierenden FHIR-Ressourcentypen.
_since 0.. 1 Schließt nur Ressourcen ein, die nach diesem Datum und dieser Uhrzeit aktualisiert wurden.
_until 0.. 1 Schließt nur Ressourcen ein, die vor diesem Datum und dieser Uhrzeit aktualisiert wurden.
exportType 0.. 1 Art des auszuführenden Exports. Zulässige Werte: hl7.fhir.us.davinci-atr, hl7.fhir.us.davinci-pdex, hl7.fhir.us.davinci-pdex.p2p, hl7.fhir.us.davinci-pdex.member. Standard: hl7.fhir.us.davinci-atr.
_includeEOB2xWoFinancial 0.. 1 Gibt an, ob CARIN BB ExplanationOfBenefit 2.x-Ressourcen eingeschlossen werden sollen, deren Finanzdaten entfernt wurden. Standard: false.

Unterstützte Ressourcentypen

Die unterstützten Ressourcentypen hängen vom angegebenen Exporttyp ab. Für ATR-Exporte werden die folgenden Ressourcentypen unterstützt:

  • Group

  • Patient

  • Coverage

  • RelatedPerson

  • Practitioner

  • PractitionerRole

  • Organization

  • Location

Für PDex Exporte (Anbieterzugriff und Mitgliederzugriff) werden zusätzlich zu den vorherigen Typen alle Ressourcentypen für klinische Zwecke und Reklamationen unterstützt. Payer-to-Payer Eine vollständige Liste der unterstützten Ressourcentypen finden Sie im US Core Implementation Guide (STU 6.1), im CARIN Blue Button Implementation Guide und im Da Vinci Prior Authorization Support Implementation Guide.

Exporttypen

Der $davinci-data-export Vorgang unterstützt die folgenden Exporttypen. Sie geben den Exporttyp mithilfe des exportType Parameters an.

Art des Exports Zweck Umfang der Daten Zeitliches Limit
hl7.fhir.us.davinci-atr Liste der Zuordnung von Mitgliedern Ressourcen im Zusammenhang mit der Zuordnung Keine
hl7.fhir.us.davinci-pdex API für den Anbieterzugriff Klinische Daten und Reklamationsdaten für zugewiesene Patienten 5 Jahre
hl7.fhir.us.davinci-pdex.p2p Payer-to-Payer Austausch Historische Mitgliederdaten für Versicherungsübergänge 5 Jahre
hl7.fhir.us.davinci-pdex.member API für den Mitgliederzugriff Eigene Gesundheitsdaten des Mitglieds 5 Jahre
Anmerkung

Bei PDex Exporten gilt das Zeitlimit von 5 Jahren nicht für ATR-Ressourcentypen (GroupPatient,Coverage,RelatedPerson,Practitioner,, PractitionerRoleOrganization,Location). Diese Ressourcen sind unabhängig vom Alter immer enthalten.

ATR (hl7.fhir.us.davinci-atr)

Mit dem ATR-Exporttyp können Sie Daten aus der Mitgliedsattributionsliste exportieren. Verwenden Sie diesen Exporttyp, um Ressourcen im Zusammenhang mit der Zuordnung für Mitglieder innerhalb einer Gruppe abzurufen. Weitere Informationen finden Sie unter Da Vinci ATR-Exportvorgang.

Unterstützte Ressourcentypen

Group, Patient, Coverage, RelatedPerson, Practitioner, PractitionerRole, Organization, Location

Temporale Filterung

Es wird keine zeitliche Filterung angewendet. Alle passenden Ressourcen werden unabhängig vom Datum exportiert.

PDex Exporttypen

Alle PDex Exporttypen verwenden dieselben unterstützten Profile und dieselbe Filterlogik. Weitere Informationen finden Sie in der Da Vinci PDex Provider Access API. Die folgenden Profile werden unterstützt:

  • US Core 3.1.1, 6.1.0 und 7.0.0

  • PDex Vorherige Autorisierung (wird für den Mitgliederzugriff nicht unterstützt)

  • CARIN BB 2.x Basisprofile: stationär stationär, ambulant stationär, beruflich, oral, pharmazeutisch NonClinician

Zugang zum Anbieter () hl7.fhir.us.davinci-pdex

Ermöglicht netzinternen Anbietern das Abrufen von Patientendaten für zugewiesene Patienten.

Payer-to-Payer (hl7.fhir.us.davinci-pdex.p2p)

Ermöglicht den Datenaustausch zwischen Kostenträgern, wenn ein Patient die Versicherung wechselt.

Zugang für Mitglieder () hl7.fhir.us.davinci-pdex.member

Ermöglicht Mitgliedern den Zugriff auf ihre eigenen Gesundheitsdaten. Dieser Exporttyp kann Finanzdaten aus Schadensressourcen enthalten.

Profilunterstützung und Inklusionslogik

Bei PDex Exporten verwendet der $davinci-data-export Vorgang Profildeklarationen im meta.profile Element, um zu bestimmen, welche Ressourcen in den Export aufgenommen werden sollen.

ExplanationOfBenefit Umgang mit Ressourcen

ExplanationOfBenefit(EOB) Ressourcen werden auf der Grundlage ihrer meta.profile Deklarationen in PDex Exporte aufgenommen oder ausgeschlossen:

  • ExplanationOfBenefit Ressourcen mit einem CARIN BB 1.x-Profil sind vom Export ausgeschlossen.

  • ExplanationOfBenefit Ressourcen ohne meta.profile Set sind vom Export ausgeschlossen.

  • ExplanationOfBenefit Ressourcen mit einem CARIN BB 2.x Basisprofil sind immer enthalten.

  • ExplanationOfBenefit Ressourcen mit einem CARIN BB 2.x-Profil, das Finanzdaten enthält, sind standardmäßig ausgeschlossen. Wenn diese _includeEOB2xWoFinancial=true Option gesetzt ist, werden sie in den gelöschten Finanzdaten enthalten und die Ressource wird in das entsprechende Basisprofil umgewandelt.

  • ExplanationOfBenefit Ressourcen mit einem Profil „ PDex Vorherige Autorisierung“ sind immer enthalten.

Transformation von Finanzdaten

Wenn Sie diese Einstellung vornehmen_includeEOB2xWoFinancial=true, transformiert der Vorgang die ExplanationOfBenefit Ressourcen von CARIN BB 2.x in die entsprechenden Basisprofile, indem Finanzdaten entfernt werden. Beispielsweise wird eine Ressource in eine C4BB ExplanationOfBenefit Oral Ressource umgewandeltC4BB ExplanationOfBenefit Oral Basis, wodurch Finanzdaten gemäß der FHIR-Spezifikation aus dem Datensatz entfernt werden.

Die folgenden Finanzdatenelemente werden bei der Transformation entfernt:

  • Alle Elemente werden in Scheiben geschnitten total

  • Alle adjudication Elemente mit Slice amounttype

  • Alle item.adjudication Elemente mit Mengenangaben

Der Vorgang aktualisiert auch die Profilmetadaten während der Transformation:

  • meta.profilewird auf die kanonische URL des Basisprofils aktualisiert

  • Die Version wurde auf die CARIN BB 2.x Basisversion aktualisiert

  • Bestehende Ressourcen im Datenspeicher werden nicht geändert

  • Exportierte Ressourcen werden nicht dauerhaft im Datenspeicher gespeichert

Regeln für die Profilerkennung

Der Vorgang verwendet die folgenden Regeln, um Profile zu erkennen und zu validieren:

  • Die Versionserkennung basiert auf dem meta.profile kanonischen URLs

  • Eine Ressource ist enthalten, wenn EINES ihrer deklarierten Profile den Exportkriterien entspricht

  • Die Profilvalidierung erfolgt während der Exportverarbeitung

Fünfjährige zeitliche Filterung für Exporte PDex

HealthLake Wendet für alle PDex Exporttypen einen Zeitfilter für fünf Jahre an, der darauf basiert, wann die Ressource zuletzt aktualisiert wurde. Der Zeitfilter gilt für alle Ressourcen mit Ausnahme der folgenden zentralen Attributionsressourcentypen, die unabhängig vom Alter immer exportiert werden:

  • Patient

  • Coverage

  • Organization

  • Practitioner

  • PractitionerRole

  • RelatedPerson

  • Location

  • Group

Diese administrativen und demografischen Ressourcen sind ausgenommen, da sie den wesentlichen Kontext für die exportierten Daten bieten. ATR-Exporte unterliegen keiner zeitlichen Filterung.

Beispielanforderungen

Die folgenden Beispiele zeigen, wie Exportaufträge für verschiedene Exporttypen gestartet werden.

ATR-Export

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage,Practitioner,Organization&exportType=hl7.fhir.us.davinci-atr POST https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage,Practitioner,Organization&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" } } }

Provider Access-Export mit Entfernung von ExplanationOfBenefit Finanzdaten

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Observation,Condition,MedicationRequest,ExplanationOfBenefit&exportType=hl7.fhir.us.davinci-pdex&_includeEOB2xWoFinancial=true

Payer-to-Payer exportieren

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Coverage,ExplanationOfBenefit,Condition,Procedure&exportType=hl7.fhir.us.davinci-pdex.p2p&_includeEOB2xWoFinancial=true

Export mit Mitgliederzugriff für einen bestimmten Patienten

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Observation,Condition,ExplanationOfBenefit,MedicationRequest&exportType=hl7.fhir.us.davinci-pdex.member&patient=Patient/example-patient-id

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 Group.member.entity Die Patienten, die Mitglieder der Zuordnungsliste sind
Coverage Group.member.extension:coverageReference Versicherungsschutz, der zur Patientenmitgliedschaft führte
Organization Group.member.extension:attributedProvider Organizations, denen Patienten zugeschrieben werden
Practitioner Group.member.extension:attributedProvider Einzelne Ärzte, denen die Patienten zugeordnet sind
PractitionerRole Group.member.extension:attributedProvider Rollen von Ärzten, denen Patienten zugeschrieben werden
RelatedPerson Coverage.subscriber Abonnenten der Berichterstattung
Location PractitionerRole.location Standorte, die mit den Rollen von Praktikern in Verbindung stehen
Group 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

Die in angegebene IAM-Rolle DataAccessRoleArn verfügt nicht über ausreichende Berechtigungen, um den Exportvorgang durchzuführen. Die vollständige Liste der erforderlichen S3- und KMS-Berechtigungen finden Sie unter Berechtigungen für Exportaufträge einrichten.

Fehler bei der Parametervalidierung
  • Der patient Parameter ist nicht formatiert als Patient/id,Patient/id,...

  • Eine oder mehrere Patientenreferenzen sind ungültig oder gehören nicht zur angegebenen Gruppe

  • Der exportType Parameterwert ist kein unterstützter Exporttyp

  • Der _type Parameter enthält Ressourcentypen, die für den angegebenen Exporttyp nicht unterstützt werden

  • Dem _type Parameter fehlen die erforderlichen Ressourcentypen (GroupPatient,,Coverage) für den hl7.fhir.us.davinci-atr Exporttyp

  • Der _includeEOB2xWoFinancial Parameterwert ist kein gültiger boolescher Wert

Fehler bei der Ressourcenvalidierung
  • Die angegebene Gruppenressource ist nicht im Datenspeicher vorhanden

  • Die angegebene Gruppenressource hat keine Mitglieder

  • Ein oder mehrere Gruppenmitglieder verweisen auf Patientenressourcen, die nicht im Datenspeicher vorhanden sind

Sicherheit und Autorisierung

  • Es gelten die standardmäßigen FHIR-Autorisierungsmechanismen

  • Die Datenzugriffsrolle muss über die erforderlichen IAM-Berechtigungen für S3- und KMS-Operationen verfügen. Die vollständige Liste der erforderlichen Berechtigungen finden Sie unter Berechtigungen für Exportaufträge einrichten.

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

  • Sensibilisierung für temporäre Filter: Bei PDex Exporten sollten Sie bei der Auswahl von Ressourcentypen den Zeitfilter für 5 Jahre in Betracht ziehen

  • Entfernung von Finanzdaten: Verwenden Sie diese _includeEOB2xWoFinancial=true Option, wenn Sie Forderungsdaten ohne Finanzinformationen benötigen

  • Profilverwaltung: Stellen Sie sicher, dass die Ressourcen über die entsprechenden Profildeklarationen verfügen, überprüfen Sie sie vor der Aufnahme anhand von Zielprofilen und verwenden Sie die Profilversionsverwaltung, um das Exportverhalten zu steuern

Einschränkungen

  • In dem Parameter können maximal 500 Patienten angegeben werden patient

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

  • Unterstützt nur die vordefinierten Ressourcentypen für jeden Exporttyp

  • Die Ausgabe erfolgt immer im NDJSON-Format

  • PDex Die Exporte sind auf klinische Daten und Reklamationsdaten für einen Zeitraum von 5 Jahren begrenzt

  • Die Transformation von Finanzdaten gilt nur für CARIN BB 2.x-Profile ExplanationOfBenefit

Weitere Ressourcen