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:
GroupPatientCoverageRelatedPersonPractitionerPractitionerRoleOrganizationLocation
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)
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
- 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
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.profileSet 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=trueOption 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.xC4BB 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
totalAlle
adjudicationElemente mit SliceamounttypeAlle
item.adjudicationElemente mit Mengenangaben
Der Vorgang aktualisiert auch die Profilmetadaten während der Transformation:
meta.profilewird auf die kanonische URL des Basisprofils aktualisiertDie 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.profilekanonischen URLsEine 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:
PatientCoverageOrganizationPractitionerPractitionerRoleRelatedPersonLocationGroup
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 gestelltIN_PROGRESS- Der Job wird aktiv bearbeitetCOMPLETED- Job erfolgreich abgeschlossen, Dateien zum Herunterladen verfügbarFAILED- 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
DataAccessRoleArnverfü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
patientParameter ist nicht formatiert alsPatient/id,Patient/id,...Eine oder mehrere Patientenreferenzen sind ungültig oder gehören nicht zur angegebenen Gruppe
Der
exportTypeParameterwert ist kein unterstützter ExporttypDer
_typeParameter enthält Ressourcentypen, die für den angegebenen Exporttyp nicht unterstützt werdenDem
_typeParameter fehlen die erforderlichen Ressourcentypen (GroupPatient,,Coverage) für denhl7.fhir.us.davinci-atrExporttypDer
_includeEOB2xWoFinancialParameterwert 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
_sinceParameter für inkrementelle ExportePatientenfilterung: Verwenden Sie den
patientParameter, wenn Sie nur Daten für bestimmte Mitglieder benötigenAuftragsü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=trueOption, wenn Sie Forderungsdaten ohne Finanzinformationen benötigenProfilverwaltung: 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
patientDer 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