Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Fonctionnement du FHIR R4 `$davinci-data-export` pour HealthLake Il s'agit d'une `$davinci-data-export` opération FHIR asynchrone à partir de laquelle vous pouvez exporter des données de santé. AWS HealthLake Cette opération prend en charge plusieurs types d'exportation, notamment l'attribution de membres (ATR) Payer-to-Payer, l'accès au PDex fournisseur et l'accès aux membres APIs. Il s'agit d'une version spécialisée de l'`$export`opération FHIR standard, conçue pour répondre aux exigences des guides de mise DaVinci en œuvre. ## Fonctionnalités principales + *Traitement asynchrone* : suit le modèle de demande asynchrone FHIR standard + Exportation *au niveau du groupe : exporte* les données pour les membres d'une ressource de groupe spécifique + *Plusieurs types d'exportation* : prend en charge l'ATR (attribution de membres) Payer-to-Payer, l'accès aux PDex fournisseurs et l'accès aux membres APIs + *Support complet pour les profils* : inclut US Core, CARIN Blue Button et PDex profils + *Filtrage flexible* : prend en charge le filtrage par patients, types de ressources et plages de temps + *Sortie NDJSON* : fournit des données au format JSON délimité par de nouvelles lignes ## Opération Endpoint ``` GET [base]/Group/[id]/$davinci-data-export POST [base]/Group/[id]/$davinci-data-export ``` ## Paramètres de demande | Paramètre | Cardinalité | Description | | --- | --- | --- | | patient | 0.. \$1 | Membres spécifiques dont les données doivent être exportées. En cas d'omission, tous les membres du groupe sont exportés. | | \$1type | 0,1 | Liste séparée par des virgules des types de ressources FHIR à exporter. | | \$1since | 0,1 | N'incluez que les ressources mises à jour après cette date et cette heure. | | \$1until | 0,1 | N'incluez que les ressources mises à jour avant cette date et cette heure. | | exportType | 0,1 | Type d'export à effectuer. Valeurs valides: hl7.fhir.us.davinci-atr, hl7.fhir.us.davinci-pdex, hl7.fhir.us.davinci-pdex.p2p, hl7.fhir.us.davinci-pdex.member. Valeur par défaut : hl7.fhir.us.davinci-atr. | | \$1includeEOB2xWoFinancial | 0,1 | Spécifie s'il faut inclure les ExplanationOfBenefit ressources CARIN BB 2.x avec les données financières supprimées. Valeur par défaut : false. | ### Types de ressource pris en charge Les types de ressources pris en charge dépendent du type d'exportation que vous spécifiez. Pour les exportations ATR, les types de ressources suivants sont pris en charge : + `Group` + `Patient` + `Coverage` + `RelatedPerson` + `Practitioner` + `PractitionerRole` + `Organization` + `Location` Pour les PDex exportations (accès fournisseur et accès membre), tous les types de ressources cliniques et de réclamations sont pris en charge en plus des types précédents. Payer-to-Payer Pour une liste complète des types de ressources pris en charge, consultez le [US Core Implementation Guide (STU 6.1)](https://hl7.org/fhir/us/core/STU6.1/), le [CARIN Blue Button Implementation Guide](https://hl7.org/fhir/us/carin-bb/) et le [Da Vinci Prior Authorization Support Implementation](https://hl7.org/fhir/us/davinci-pas/) Guide. ## Types d'exportation L'`$davinci-data-export`opération prend en charge les types d'exportation suivants. Vous spécifiez le type d'exportation à l'aide du `exportType` paramètre. | Type d'exportation | Objectif | Étendue des données | Limite temporelle | | --- | --- | --- | --- | | hl7.fhir.us.davinci-atr | Liste d'attribution des membres | Ressources liées à l'attribution | Aucune | | hl7.fhir.us.davinci-pdex | API d'accès aux fournisseurs | Données cliniques et relatives aux demandes de remboursement pour les patients concernés | 5 ans | | hl7.fhir.us.davinci-pdex.p2p | Payer-to-Payer Échange | Données historiques sur les membres pour les transitions d'assurance | 5 ans | | hl7.fhir.us.davinci-pdex.member | API d'accès aux membres | Données de santé propres au membre | 5 ans | **Note** Pour les PDex exportations, la limite temporelle de 5 ans ne s'applique pas aux types de ressources ATR (`Group``Patient`,`Coverage`,`RelatedPerson`,`Practitioner`,`PractitionerRole`,`Organization`,`Location`). Ces ressources sont toujours incluses quel que soit l'âge. ### ATR (hl7.fhir.us.davinci-atr) Avec le type d'exportation ATR, vous pouvez exporter les données de la liste d'attribution des membres. Utilisez ce type d'exportation pour récupérer les ressources liées à l'attribution pour les membres d'un groupe. Pour plus d'informations, consultez l'[opération d'exportation de Da Vinci ATR](https://build.fhir.org/ig/HL7/davinci-atr/OperationDefinition-davinci-data-export.html). Types de ressource pris en charge `Group`, `Patient`, `Coverage`, `RelatedPerson`, `Practitioner`, `PractitionerRole`, `Organization`, `Location` Filtrage temporel Aucun filtrage temporel n'est appliqué. Toutes les ressources correspondantes sont exportées quelle que soit la date. ### PDex Types d'exportation Tous les types PDex d'exportation partagent les mêmes profils pris en charge et la même logique de filtrage. Pour plus d'informations, consultez l'[API Da Vinci PDex Provider Access](https://build.fhir.org/ig/HL7/davinci-epdx/provider-access-api.html). Les profils suivants sont pris en charge : + US Core 3.1.1, 6.1.0 et 7.0.0 + PDex Autorisation préalable (non prise en charge pour l'accès des membres) + CARIN BB 2.x Profils de base : établissement hospitalier, établissement ambulatoire, professionnel, oral, pharmacie NonClinician Accès au fournisseur (`hl7.fhir.us.davinci-pdex`) Permet aux fournisseurs du réseau de récupérer les données des patients pour les patients auxquels ils ont été attribués. Payer-to-Payer (`hl7.fhir.us.davinci-pdex.p2p`) Permet l'échange de données entre les payeurs lorsqu'un patient change d'assurance. Accès aux membres (`hl7.fhir.us.davinci-pdex.member`) Permet aux membres d'accéder à leurs propres données de santé. Ce type d'exportation peut inclure des données financières dans les ressources relatives aux sinistres. ## Support du profil et logique d'inclusion Pour les PDex exportations, l'`$davinci-data-export`opération utilise des déclarations de profil dans l'`meta.profile`élément pour déterminer les ressources à inclure dans l'exportation. ### ExplanationOfBenefit Gestion des ressources `ExplanationOfBenefit`Les ressources (EOB) sont incluses ou exclues des PDex exportations en fonction de leurs `meta.profile` déclarations : + ExplanationOfBenefit les ressources dotées d'un profil CARIN BB 1.x sont exclues de l'exportation. + ExplanationOfBenefit les ressources non `meta.profile` définies sont exclues de l'exportation. + ExplanationOfBenefit les ressources avec un profil CARIN BB 2.x Basis sont toujours incluses. + ExplanationOfBenefit les ressources dotées d'un profil CARIN BB 2.x contenant des données financières sont exclues par défaut. Lorsqu'il `_includeEOB2xWoFinancial=true` est défini, ils sont inclus dans les données financières supprimées et la ressource est transformée selon le profil de base correspondant. + ExplanationOfBenefit les ressources avec un profil d'autorisation PDex préalable sont toujours incluses. ### Transformation des données financières Lorsque vous le définissez`_includeEOB2xWoFinancial=true`, l'opération transforme les ExplanationOfBenefit ressources [CARIN BB 2.x](https://hl7.org/fhir/us/carin-bb/) en leurs profils de base correspondants en supprimant les données financières. Par exemple, une `C4BB ExplanationOfBenefit Oral` ressource est transformée en`C4BB ExplanationOfBenefit Oral Basis`, ce qui supprime les données financières de l'enregistrement conformément à la spécification FHIR. Les éléments de données financières suivants sont supprimés lors de la transformation : + Tous les éléments sont tranchés `total` + Tous les `adjudication` éléments avec `amounttype` tranche + Tous les `item.adjudication` éléments avec des informations sur le montant L'opération met également à jour les métadonnées du profil lors de la transformation : + `meta.profile`est mis à jour vers l'URL canonique du profil Basis + La version est mise à jour vers la version CARIN BB 2.x Basis + Les ressources existantes dans le magasin de données ne sont pas modifiées + Les ressources exportées ne sont pas renvoyées dans le magasin de données ### Règles de détection des profils L'opération utilise les règles suivantes pour détecter et valider les profils : + La détection des versions est basée sur la norme `meta.profile` canonique URLs + Une ressource est incluse si l'un de ses profils déclarés correspond aux critères d'exportation + La validation du profil a lieu pendant le traitement de l'exportation ## Filtrage temporel quinquennal pour les PDex exportations Pour tous les types PDex d'exportation, HealthLake applique un filtre temporel de 5 ans basé sur la date de dernière mise à jour de la ressource. Le filtre temporel s'applique à toutes les ressources, à l'exception des types de ressources d'attribution de base suivants, qui sont toujours exportés quel que soit leur âge : + `Patient` + `Coverage` + `Organization` + `Practitioner` + `PractitionerRole` + `RelatedPerson` + `Location` + `Group` Ces ressources administratives et démographiques sont exemptées car elles fournissent un contexte essentiel pour les données exportées. Les exportations ATR ne sont soumises à aucun filtrage temporel. ## Exemple de demandes Les exemples suivants montrent comment démarrer des tâches d'exportation pour différents types d'exportation. *Exportation ATR* ``` 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" } } } ``` *Exportation de l'accès au fournisseur avec suppression des données ExplanationOfBenefit financières* ``` 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 exportation* ``` 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 ``` *Exportation de l'accès aux membres pour un patient spécifique* ``` 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 ``` ## Exemple de réponse ``` { "datastoreId": "eaee622d8406b41eb86c0f4741201ff9", "jobStatus": "SUBMITTED", "jobId": "48d7b91dae4a64d00d54b70862f33f61" } ``` ## Relations avec les ressources L'opération exporte les ressources en fonction de leurs relations au sein de la liste d'attribution des membres : ``` Group (Attribution List) ├── Patient (Members) ├── Coverage → RelatedPerson (Subscribers) ├── Practitioner (Attributed Providers) ├── PractitionerRole → Location └── Organization (Attributed Providers) ``` ### Sources de ressources | Ressource | Emplacement de la source | Description | | --- | --- | --- | | Patient | Group.member.entity | Les patients membres de la liste d'attribution | | Coverage | Group.member.extension:coverageReference | Couverture qui a donné lieu à l'adhésion du patient | | Organization | Group.member.extension:attributedProvider | Organisations auxquelles les patients sont attribués | | Practitioner | Group.member.extension:attributedProvider | Praticiens individuels auxquels les patients sont attribués | | PractitionerRole | Group.member.extension:attributedProvider | Rôles de praticiens auxquels les patients sont attribués | | RelatedPerson | Coverage.subscriber | Abonnés de la couverture | | Location | PractitionerRole.location | Lieux associés aux rôles des praticiens | | Group | Point final d'entrée | La liste d'attribution elle-même | ## Gestion du Job Vérifier le statut du job `GET [base]/export/[job-id]` Annuler une tâche `DELETE [base]/export/[job-id]` ### Cycle de vie d'une tâche + `SUBMITTED`- Le job a été reçu et mis en file d'attente + `IN_PROGRESS`- Job en cours de traitement actif + `COMPLETED`- Job terminé avec succès, fichiers disponibles au téléchargement + `FAILED`- Job a rencontré une erreur ## Format de sortie + *Format de fichier* : NDJSON (JSON délimité par une nouvelle ligne) + *Organisation des fichiers* : fichiers distincts pour chaque type de ressource + *Extension de fichier* : .ndjson + *Emplacement* : compartiment et chemin S3 spécifiés ## Gestion des erreurs L'opération renvoie une mauvaise demande HTTP 400 avec un OperationOutcome pour les conditions suivantes : Erreurs d'autorisation Le rôle IAM spécifié dans `DataAccessRoleArn` ne dispose pas des autorisations suffisantes pour effectuer l'opération d'exportation. Pour obtenir la liste complète des autorisations S3 et KMS requises, voir [Configuration des autorisations pour les tâches d'exportation](getting-started-setting-up.md#setting-up-export-permissions). Erreurs de validation des paramètres + Le `patient` paramètre n'est pas formaté comme `Patient/id,Patient/id,...` + Une ou plusieurs références de patients ne sont pas valides ou n'appartiennent pas au groupe spécifié + La valeur du `exportType` paramètre n'est pas un type d'exportation pris en charge + Le `_type` paramètre contient les types de ressources qui ne sont pas pris en charge pour le type d'exportation spécifié + Le `_type` paramètre ne contient pas les types de ressources requis (`Group`,`Patient`,`Coverage`) pour le type `hl7.fhir.us.davinci-atr` d'exportation + La valeur du `_includeEOB2xWoFinancial` paramètre n'est pas une valeur booléenne valide Erreurs de validation des ressources + La ressource de groupe spécifiée n'existe pas dans le magasin de données + La ressource de groupe spécifiée n'a aucun membre + Un ou plusieurs membres du groupe font référence à des ressources pour patients qui n'existent pas dans le magasin de données ## Sécurité et autorisation + Les mécanismes d'autorisation FHIR standard s'appliquent + Le rôle d'accès aux données doit disposer des autorisations IAM requises pour les opérations S3 et KMS. Pour obtenir la liste complète des autorisations requises, voir [Configuration des autorisations pour les tâches d'exportation](getting-started-setting-up.md#setting-up-export-permissions). ## Bonnes pratiques + *Sélection du type de ressource* : demandez uniquement les types de ressources dont vous avez besoin pour minimiser la taille des exportations et le temps de traitement + *Filtrage basé sur le temps* : utilisez le `_since` paramètre pour les exportations incrémentielles + *Filtrage des patients* : utilisez le `patient` paramètre lorsque vous n'avez besoin de données que pour des membres spécifiques + *Surveillance des tâches* : vérifiez régulièrement l'état des tâches pour les exportations importantes + *Gestion des erreurs* : implémentez une logique de nouvelle tentative appropriée pour les tâches ayant échoué + *Connaissance du filtre temporel* : pour les PDex exportations, considérez le filtre temporel de 5 ans lorsque vous sélectionnez les types de ressources + *Suppression des données financières* : à utiliser `_includeEOB2xWoFinancial=true` lorsque vous avez besoin de données relatives aux réclamations sans informations financières + *Gestion des profils* : assurez-vous que les ressources disposent de déclarations de profil appropriées, validez par rapport aux profils cibles avant l'ingestion et utilisez le versionnement des profils pour contrôler le comportement d'exportation ## Limitations + Un maximum de 500 patients peut être spécifié dans le `patient` paramètre + L'exportation est limitée aux opérations au niveau du groupe uniquement + Supporte uniquement l'ensemble prédéfini de types de ressources pour chaque type d'exportation + La sortie est toujours au format NDJSON + PDex les exportations sont limitées à 5 ans de données cliniques et de réclamations + La transformation des données financières ne s'applique qu'aux profils CARIN BB 2.x ExplanationOfBenefit ## Ressources supplémentaires + [Liste d'attribution des membres de Da Vinci IG](https://build.fhir.org/ig/HL7/davinci-atr/) + [Da Vinci Payer Data Exchange IG](https://hl7.org/fhir/us/davinci-pdex/) + [CARIN Consumer Directed Payer Data Exchange IG](https://build.fhir.org/ig/HL7/carin-bb/) + [Guide de mise en œuvre de base aux États-Unis](https://www.hl7.org/fhir/us/core/) + [Spécification d'accès aux données en masse FHIR](https://hl7.org/fhir/uv/bulkdata/)