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.. \$1 | Bestimmte Mitglieder, deren Daten exportiert werden sollen. Wenn dieser Wert weggelassen wird, werden alle Mitglieder der Gruppe exportiert. | | \$1type | 0.. 1 | Kommagetrennte Liste der zu exportierenden FHIR-Ressourcentypen. | | \$1since | 0.. 1 | Schließt nur Ressourcen ein, die nach diesem Datum und dieser Uhrzeit aktualisiert wurden. | | \$1until | 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. | | \$1includeEOB2xWoFinancial | 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)](https://hl7.org/fhir/us/core/STU6.1/), [im CARIN Blue Button Implementation Guide](https://hl7.org/fhir/us/carin-bb/) und im [Da Vinci Prior Authorization Support](https://hl7.org/fhir/us/davinci-pas/) 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 (`Group``Patient`,`Coverage`,`RelatedPerson`,`Practitioner`,, `PractitionerRole``Organization`,`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](https://build.fhir.org/ig/HL7/davinci-atr/OperationDefinition-davinci-data-export.html) 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](https://build.fhir.org/ig/HL7/davinci-epdx/provider-access-api.html). 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](https://hl7.org/fhir/us/carin-bb/) in die entsprechenden Basisprofile, indem Finanzdaten entfernt werden. Beispielsweise wird eine Ressource in eine `C4BB ExplanationOfBenefit Oral` Ressource umgewandelt`C4BB 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.profile`wird 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](getting-started-setting-up.md#setting-up-export-permissions). 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 (`Group``Patient`,,`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](getting-started-setting-up.md#setting-up-export-permissions). ## 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 + [Zuordnungsliste für Da Vinci-Mitglieder IG](https://build.fhir.org/ig/HL7/davinci-atr/) + [Da Vinci Payer Data Exchange AG](https://hl7.org/fhir/us/davinci-pdex/) + [CARIN Consumer Directed Payer Data Exchange IG](https://build.fhir.org/ig/HL7/carin-bb/) + [Leitfaden zur Implementierung von US Core](https://www.hl7.org/fhir/us/core/) + [FHIR-Spezifikation für den Zugriff auf Massendaten](https://hl7.org/fhir/uv/bulkdata/)