Share via


Configurer les mappages d’entités

Note

L’administrateur de la synchronisation pour FHIR a maintenant été renommé Boîte à outils d’intégration des données.

Les mappages d’entités constituent le niveau le plus élevé du processus de mappage. Vous pouvez mapper un concept d’entité à plusieurs ressources FHIR. Les mappages d’entités aident les Dataverse Healthcare API à déplacer des données entre les enregistrements d’entité Dataverse et les ressources FHIR et aident Dataverse à envoyer les données correctes aux points de terminaison FHIR distants.

La boîte à outils d’intégration des données fournit une collection extensive de mappages par défaut créés en conformité avec la spécification HL7 FHIR. Les mappages d’entités sont déployés en tant qu’enregistrements Dataverse et sont hautement configurables pour s’adapter aux diverses exigences de votre solution.

Pour en savoir plus sur les mappages d’entités et pour examiner des exemples d’utilisation, accédez à Vue d’ensemble des mappages d’entités et Exemples de mappages d’entités.

Champs des mappages d’entités

Les mappages d’entités mappent la ressource FHIR à une entité Dataverse (table), mais chaque mappage d’entité comprend des options de configuration supplémentaires.

Nom du champ Description
Désactiver Indicateur qui indique si le mappage d’entités est désactivé. Si la valeur est définie sur True, Dataverse Healthcare API ignore le mappage d’entités lors du traitement d’un message pour le type de ressource FHIR Azure sélectionné.
Activer la réécriture sur FHIR Lorsque la réécriture est activée, cet indicateur indique si la valeur du champ doit être incluse lors de la publication des ressources FHIR dans le système.
Ressource Azure FHIR Recherchez le type de ressource FHIR associé mappé à la table Dataverse. Par exemple, la table Dataverse Compte est mappée à la ressource FHIR Organisation.
Messages pris en charge Lorsque Activer la réécriture sur FHIR est défini sur True, ce champ indique le type d’opérations prises en charge lors de la publication des données dans le service FHIR. Les valeurs prises en charge sont Créer, Mettre à jour, ou les deux.
Développer Indicateur qui indique si le mappage d’entités s’applique à une table d’extension, et non à une ressource FHIR au niveau racine. Chaque mappage d’extension a la même valeur de ressource FHIR Azure, mais un seul mappage d’entités au niveau racine peut être spécifié pour chaque ressource FHIR Azure.

Gérer les enregistrements de mappage d’entités

Vous pouvez effectuer des mises à jour au niveau de l’enregistrement pour les mappages d’entités par défaut déployés avec Microsoft Cloud for Healthcare.

Désactiver un mappage d’entités

Si vous n’avez plus besoin d’utiliser un mappage d’entités inclus avec la boîte à outils d’intégration des données, vous pouvez le désactiver. Par exemple, vous n’aurez peut-être pas besoin de synchroniser et de stocker les enregistrements des demandes de médicaments dans le système de DME.

Important

Vous ne pouvez pas supprimer un mappage d’entités qui fait partie de la boîte à outils d’intégration des données, car il est compatible avec la solution. Pour le supprimer, vous devez supprimer toute la solution. Nous vous recommandons de désactiver le mappage ou de l’archiver.

  1. Sous Configuration des mappages, sélectionnez Mappages d’entités.

  2. Sélectionnez l’entité que vous souhaitez désactiver.

  3. Sélectionnez Oui comme valeur pour Désactiver, puis sélectionnez Enregistrer.

    Capture d’écran affichant comment désactiver un mappage d’entités.

Créer un mappage d’entités

La création de mappages d’entités rend la boîte à outils d’intégration des données plus extensible. Par exemple, si vous souhaitez créer un mappage d’entités pour les patients, commencez par désigner la nouvelle entité. Dans cet exemple, la ressource FHIR Azure est intitulée Patient et l’entité Dataverse est intitulée Contact.

  1. Sous Configuration des mappages, sélectionnez Mappages d’entités, puis sélectionnez + Nouveau.

  2. Pour EntityName, sélectionnez Contact.

  3. Pour Ressource Azure FHIR, tapez ou sélectionnez Patient.

  4. Pour la valeur Désactiver, sélectionnez Non.

  5. Pour Activer la réécriture sur FHIR, sélectionnez Oui.

    Définir la valeur sur Oui signifie que les changements dans Dataverse répondent au FHIR. Si vous sélectionnez Non, FHIR écrit toutes ces informations dans Dataverse et aucune des mises à jour ne revient dans le système FHIR.

    Capture d’écran affichant un exemple de création de mappage d’entités.

  6. Pour Messages pris en charge, sélectionnez les actions valides pour que les données soient renvoyées vers le système FHIR. Vous pouvez sélectionner Créer ou Mettre à jour, ou les deux.

    • Si vous sélectionnez Créer, un enregistrement est également créé dans FHIR quand un enregistrement est créé dans Dataverse.
    • Si vous sélectionnez Mettre à jour, chaque changement d’enregistrement dans Dataverse est également mis à jour dans FHIR.

    Pour cet exemple qui utilise l’entité Contact, sélectionnez uniquement Mettre à jour.

    Note

    Pour une ressource Patient ou une entité Contact, uniquement Mettre à jour est pris en charge.

  7. Sélectionnez Enregistrer.

La capture système change dans Azure FHIR quand l’entité Contact est mise à jour.

Pour plus d’informations sur la configuration de la réécriture, accédez à Vue d’ensemble de la réécriture pour les Dataverse Healthcare API.

Important

Nous vous recommandons de ne pas créer de nouveaux patients dans Dataverse. Ajoutez toujours de nouveaux patients dans votre système FHIR et laissez les Dataverse Healthcare API créer les enregistrements Dataverse correspondants.

Les patients sont la principale ressource (entité) dans FHIR. Toutes les autres ressources dans FHIR se rapportent à la ressource/entité Patient. Les systèmes FHIR attribuent automatiquement un identifiant unique quand vous ajoutez un nouveau patient. Cet attribut ID est en lecture seule. Si vous essayez de créer un dossier patient dans Dataverse, Dataverse ne peut pas attribuer de valeur à l’attribut ID patient dans FHIR. Ainsi, les Dataverse Healthcare API ne peuvent pas écrire les modifications de données dans votre système FHIR.

Quand vous ajoutez un nouveau patient dans votre système DME, la modification de données est transmise au serveur agent de synchronisation Azure FHIR, puis à Dataverse. Ensuite, vous pouvez ajouter des enregistrements associés, tels que des rencontres, des rendez-vous et des observations.

Voir aussi

Présentation de Microsoft Cloud for Healthcare
Vue d’ensemble de la boîte à outils d’intégration des données
Gérer les données FHIR en utilisant la boîte à outils d’intégration des données
Configurer les mappages d’attributs
Configurer les mappages d’extension
Mappages de la boîte à outils d’intégration des données : exemples et cas d’utilisation