Configurer les mappages d’entités
Les mappages d’entités se trouvent au niveau le plus élevé dans le processus de mappage. Vous pouvez mapper un concept d’entité à plusieurs ressources FHIR (Fast Health Interoperability Resources). Les mappages d’entités aident les API de soins de santé Dataverse à déplacer des données entre les enregistrements d’entités 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 pour être conformes à 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és inclut davantage d’options de configuration.
| 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 l’écriture différée sur FHIR | Lorsque l’écriture différée 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 | Une opération de recherche dans 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 l’écriture différée 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 que les enregistrements MedicationRequest soient synchronisés et stockés dans le système DME (Dossier médical électronique).
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.
Sous Configuration des mappages, sélectionnez Mappages d’entités.
Sélectionnez l’entité que vous souhaitez désactiver.
Sélectionnez Oui comme valeur pour Désactiver, puis sélectionnez Enregistrer.
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.
Sous Configuration des mappages, sélectionnez Mappages d’entités, puis sélectionnez + Nouveau.
Pour EntityName, sélectionnez Contact.
Pour Ressource Azure FHIR, tapez ou sélectionnez Patient.
Pour le champ Désactiver, sélectionnez Non.
Pour Activer l’écriture différée 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.
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, seule l’action Mettre à jour est prise en charge.
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 l’écriture différée, accédez à Vue d’ensemble de l’écriture différée 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.