Partager via

Configurer les mappages d’attributs

  • Article

Note

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

La boîte à outils d’intégration des données fournit des mappages par défaut créés en conformité avec la spécification HL7 FHIR. Cependant, les mappages d’entités et d’attributs 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’attributs, accédez à Vue d’ensemble des mappages d’attributs.

Astuce

Vous pouvez utiliser l’option Exporter vers Excel dans la barre de commandes pour exporter les informations de mappage dans un fichier Excel. Pour en savoir plus sur l’exportation des données depuis votre application vers un fichier Excel, consultez Exporter les données vers Excel.

Champs de mappages d’attributs

Les mappages d’attributs fournissent le nœud FHIR pour le mappage au niveau du champ Dataverse. Ils doivent tenir compte de différents types de données.

Nom du champ Description
Désactiver Indicateur qui indique si le mappage d’attributs est désactivé. Si la valeur est définie sur True, Dataverse Healthcare API ignore le mappage d’attributs lors du traitement d’une ressource FHIR pour le mappage d’entités associé.
Attribut requis FHIR Lorsque la réécriture est activée, cet indicateur indique si l’attribut est requis lors de l’envoi de données au serveur FHIR.
Mappage d’entités du service de mise à jour Recherchez dans le mappage d’entité parent pour le mappage d’attributs.
Nom de l’entité Le nom du schéma de la table Dataverse pour le mappage d’entité parent.
Nom de l’attribut Le nom du schéma de la colonne Dataverse à laquelle les valeurs FHIR sont mappées. Cette liste change en fonction de la sélection du mappage d’entités.
Type d’action Type du mappage de valeurs qui se produit pour l’attribut. La section suivante répertorie les différentes valeurs du type d’action :

Copier les données : copie directe des données sans aucun type de transformation. Ce type d’action est principalement utilisé lorsque le type de données dans les deux systèmes correspond.
Définir la valeur par défaut : définissez toujours une valeur par défaut dans CDS. Ce type d’action est utile lorsque l’attribut est nécessaire mais n’existe pas dans le système source.
Valeur mappée : transformation et mappage des données. Ce type d’action convient mieux lorsque les types de données ne correspondent pas, par exemple avec les choix Dataverse ou les options Oui ou Non.
Recherche : mappe les références FHIR aux valeurs de recherche de Dataverse.
Codeable Concept : mappe un nœud de codage FHIR à une recherche codeable concept dans Dataverse.
Étendre : mappe un nœud FHIR de type tableau à une table d’extension associée.
Type d’élément FHIR Valeur indiquant le type de données de l’élément dans le message JSON FHIR.
Mappage d’éléments FHIR Champ contenant la requête JSONPath pour le nœud FHIR spécifique. Il comprend des instructions sur la façon de récupérer la valeur entrante et de structurer la valeur sortante pour la réécriture. Pour plus d’informations sur ce champ, accédez à Mappage d’éléments FHIR.
Mappage d’entités d’extension Lorsque vous sélectionnez Étendre comme Type d’action, cette valeur est une recherche du mappage d’entités associé du type Extension. Pour plus d’informations sur les mappages d’extension, accédez à Configurer les mappages d’extension.
Utilisé dans la mise en correspondance des enregistrements Pour les mappages d’attributs liés aux mappages d’entités d’extension, ce champ indique si le champ Dataverse est une clé ou fait partie d’une clé composite qui identifie de manière unique l’enregistrement envoyé à Dataverse. Pour plus d’informations, accédez à Utilisé dans la mise en correspondance des enregistrements.

Mappage d’éléments FHIR

Les définitions de mappage d’attributs d’entité sur Microsoft Dataverse contiennent un champ Mappage d’éléments FHIR. Ce champ définit comment récupérer et envoyer des valeurs entre le service FHIR des services de données de santé Azure et les points de terminaison activés pour FHIR.

Ces définitions de mappage sont contenues dans un objet JSON sérialisé avec des entrées pour prendre en charge la sélection JSONPath pour récupérer et mettre à jour les valeurs de propriété existantes. Il comprend également des définitions pour insérer de nouvelles valeurs de propriété qui n’existent pas déjà dans la plateforme de réception.

Définition de l’objet JSON

{
    "s": "",
    "c": { 
            "p": "",
            "a": [
                   ""
                 ]
}

où

  • "s" = Une expression JSONPath valide utilisée pour sélectionner une propriété JSON existante de la ressource FHIR pour extraire ou définir des valeurs depuis et vers Dataverse.
  • "c" = Champs de propriété JSON utilisés pour insérer ou créer des propriétés JSON quand le chemin d’accès sélectionné est inexistant dans l’objet JSON de la ressource.
  • "p" = Le nom de la propriété JSON parent à créer.
  • "un" = Tableau d’attributs à définir sur la propriété JSON sélectionnée.

Pour obtenir plus de détails et des exemples de configuration du mappage d’attributs, accédez à Exemples de mappages d’attributs.

Utilisé dans la mise en correspondance des enregistrements

Étant donné que les tableaux enfants dans les messages JSON FHIR ne contiennent pas d’identificateurs uniques comme des ressources FHIR au niveau racine, les Dataverse Healthcare API, le processus de réécriture et les tables de données de santé virtuelles nécessitent d’autres critères pour garantir que les valeurs correctes sont créées et mises à jour. Le champ Utilisé dans la mise en correspondance des enregistrements vous permet d’identifier quel attribut de mappage d’extension doit être utilisé pour signaler l’unicité. Ceci est important pour les mappages d’extension et pour maintenir l’intégrité des données lors de la mise à jour des enregistrements Dataverse.

Pour que la valeur Utilisé dans la mise en correspondance des enregistrements soit définie sur True, vous devez avoir au moins un mappage d’attributs pour un mappage d’entité d’extension. Si plusieurs mappages d’attributs ont ce champ marqué comme True, la liste combinée des mappages d’attributs fournit ensemble une clé composite lors de la création et de la mise à jour de nouveaux enregistrements au niveau de l’extension.

Note

La modification de cette valeur de champ une fois qu’un système est activé en production peut potentiellement entraîner des problèmes d’altération des données lors de la modification des enregistrements existants. Assurez-vous que votre équipe d’interopérabilité vérifie ceci avant d’apporter des modifications.

Gérer les enregistrements de mappage d’attributs

Les sections suivantes répertorient certaines étapes courantes pour configurer et gérer des mappages d’attributs. Pour obtenir des exemples détaillés, accédez à Exemples de mappages d’attributs.

Ajouter un mappage d’attributs à un mappage d’entités

  1. Ouvrez le mappage d’entités.

  2. Dans l’onglet Général, sous Mappages d’attributs associés, sélectionnez + Nouveau mappage d’attributs du service de mise à jour.

Désactiver un mappage d’attributs

Si vous n’avez pas besoin d’un mappage d’attributs pour une entité incluse avec les mappages par défaut de la boîte à outils d’intégration des données, vous pouvez le désactiver. Par exemple, pour l’entité encounter, vous n’aurez peut-être pas besoin de l’attribut au nom de synchronisé et stocké dans le système DME.

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

  2. Sélectionnez l’entité msemr_encounter, puis Modifier.

  3. Dans Mappages d’attributs associés, sélectionnez msemr_onbehalfof, puis sélectionnez Modifier.

  4. Définissez la valeur de l’option Désactivé sur Oui.

    Capture d’écran affichant comment désactiver un mappage d’attributs.

  5. Sélectionnez Enregistrer.

Archiver un mappage d’attributs

Vous pouvez désactiver un mappage d’attributs, mais il apparaît toujours dans la vue Mappages d’attributs du service de mise à jour actifs. Pour supprimer un mappage d’attributs de cette vue, vous pouvez archiver le mappage d’attributs.

  1. Ouvrez le mappage d’entités.

  2. Dans l’onglet Général, sous Mappages d’attributs associés, sélectionnez le mappage d’attributs.

  3. Dans l’en-tête de la vue Mappages d’attributs du service de mise à jour actifs, sélectionnez Archiver.

Afficher les mappages d’attributs archivés

  1. Ouvrez le mappage d’entités.

  2. Dans l’onglet Général, sous Mappages d’attributs associés, sélectionnez Mappages d’attributs du service de mise à jour actifs, puis sélectionnez Mappages d’attributs du service de mise à jour archivés.

Crérer un mappage d’attributs du service

L’entité Contact dans Dataverse est mappé à la ressource Patient dans Azure FHIR. Vous pouvez ajouter des mappages d’attribut au mappage d’entité.

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

  2. Dans la liste des entités, sélectionnez le Contact qui est mappé à la ressource FHIR Patient, puis sélectionnez Modifier.

  3. Dans Mappages d’attributs connexes, sélectionnez +Nouveau mappage d’attributs du service de mise à jour.

  4. Définissez la valeur de l’option Attribut FHIR obligatoire sur Non.

    Ce paramètre indique comment les données sont renvoyées vers le point de terminaison FHIR configuré. Si une modification se produit dans Dataverse pour ce patient et l’Attribut FHIR obligatoire est défini sur Oui, mais il n’a pas été renseigné par l’utilisateur, la modification Dataverse sera enregistrée dans Dataverse, mais ne sera pas renvoyée vers le point de terminaison FHIR et l’événement sera écrit dans les journaux. L’événement est écrit dans les journaux.

  5. Pour Nom d’attribut, sélectionnez Prénom.

  6. Pour Type d’action, sélectionnez Copier les données. Cette valeur signifie que les données de chaîne d’un système sont copiées sur l’autre système.

  7. Pour Carte de l’élément FHIR, ajoutez la chaîne de recherche JSON qui fonctionne avec l’API FHIR. Par exemple, vous pouvez ajouter une chaîne de recherche JSON qui vous permet d’accéder à l’élément FHIR qui est Prénom.

    Capture d’écran affichant un exemple de valeur de mappage d’élément FHIR.

  8. Sélectionnez Enregistrer. La section Mise en correspondance des valeurs est maintenant affichée sur la même fenêtre avec l’option + Nouvelle mise en correspondance des valeurs d’attribut. L’entité Contact n’a pas besoin d’une mise en correspondance des valeurs, car il s’agit d’une chaîne.

  9. Dans le mappage d’entités pour Contact, dans Mappages d’attributs associés, le mappage d’attributs du prénom apparaît sur les mappages d’attributs.

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’entités
Configurer les mappages d’extension
Mappages de la boîte à outils d’intégration des données : exemples et cas d’utilisation