Vue d’ensemble de l’écriture différée pour les Dataverse Healthcare API
Dataverse Healthcare API facilite l’ingestion de données FHIR (Fast Healthcare Interoperability Resources) dans Dataverse. Une fois les données disponibles dans Dataverse, les utilisateurs peuvent mettre à jour les nouveaux enregistrements, par exemple en mettant à jour les informations démographiques relatives aux patients. La solution d’écriture différée des Dataverse Healthcare API permet de publier ces modifications dans le serveur FHIR d’origine.
L’approche de solution offre une certaine extensibilité au processus d’écriture différée. La configuration de l’écriture différée peut aussi cibler un autre point de terminaison si les utilisateurs ont besoin d’injecter une logique personnalisée dans ce processus. Par exemple, une application logique Azure personnalisée peut être ciblée pour le message sortant qui effectue un traitement ou un routage ultérieur. Cet autre point de terminaison sortant doit prendre en charge l’authentification via OAuth 2.0 à l’aide d’un ID client et d’une clé secrète client.
Le diagramme suivant décrit le processus global d’écriture différée :
Les étapes de traitement standard sont les suivantes :
- Vous mettez à jour un enregistrement dans Dataverse.
- Dataverse évalue la modification et compose une nouvelle ressource FHIR qui est publiée dans le point de terminaison de l’API FHIR.
- Le point de terminaison FHIR traite la ressource FHIR et renvoie la réponse du résultat de l’opération à Dataverse.
- Dataverse consigne les résultats opérationnels dans les journaux de la boîte à outils d’intégration des données. L’administrateur peut examiner les éventuels échecs ici.
Pour des raisons d’extensibilité, vous pouvez spécifier une approche d’écriture différée alternative si nécessaire.
- Dataverse envoie la demande de ressource FHIR au point de terminaison défini.
- Le point de terminaison défini est responsable du traitement de la ressource FHIR publiée et de son envoi à l’API FHIR.
- Vous êtes responsable de la journalisation des résultats opérationnels, afin que l’administrateur puisse examiner les éventuels échecs lors de l’envoi de données au point de terminaison personnalisé.
Note
La version actuelle des Dataverse Healthcare API et le processus d’écriture différée supposent qu’un service FHIR est disponible pour la création et la validation de la ressource FHIR sortante. Cette configuration est requise pour écrire directement sur le service FHIR ou sur un autre point de terminaison sortant. Cela garantit l’intégrité de la ressource FHIR sortante lorsqu’un événement d’écriture différée se produit. Nous avons testé et validé cette configuration par rapport à un service FHIR des Services de données de santé Azure.
Un enregistrement Provenance de FHIR est également envoyé au point de terminaison FHIR lorsque l’événement d’écriture différée est traité. La ressource de provenance suit les informations sur l’activité qui a créé, révisé, supprimé ou signé une version d’une ressource. Elle décrit également les entités et les agents impliqués. Vous pouvez utiliser ces informations pour former des évaluations sur sa qualité, sa fiabilité ou son exactitude. Elle donne également des indications sur les endroits où aller pour approfondir les recherches sur les origines de la ressource et les informations qu’elle contient.
Pour plus d’informations sur la provenance de FHIR, consultez Provenance de la ressource FHIR.
Activer l’écriture différée
L’activation du processus d’écriture différée comprend les trois étapes principales suivantes :
- Fournir les détails de connectivité
- Mettre à jour les mappages d’entités
- Appliquer le consentement du patient
Fournir des détails de connexion
Fournissez les détails de connectivité pour le point de terminaison FHIR qui reçoit les ressources FHIR publiées. Vous pouvez trouver ces valeurs de configuration dans la section Paramètres d’intégration de la boîte à outils d’intégration des données.
Pour plus d’informations sur ces paramètres, se reporter à la rubrique Configurer les paramètres d’intégration.
Mettre à jour les mappages d’entités
Après avoir fourni les détails de connectivité, l’étape suivante consiste à mettre à jour les mappages d’entités qui contrôlent quelles ressources FHIR doivent participer au processus d’écriture différée.
Les plug-ins d’écriture différée utilisent les mêmes cartes d’entité configurées pour l’API upsert. Chaque mappage d’entité peut inclure un attribut intitulé Activer l’écriture différée dans FHIR. Lorsque cette valeur d’attribut est définie sur Oui, les plug-ins d’écriture différée publient des mises à jour pour la table Dataverse sélectionnée dans le point de terminaison FHIR. Ce processus permet un contrôle granulaire, table par table, des données à réécrire dans le point de terminaison du FHIR.
Une fois que vous avez activé l’écriture différée pour le mappage d’entités, l’administrateur peut sélectionner les événements qui déclenchent le processus d’écriture différée, indiqué par le champ Messages pris en charge. La solution d’écriture différée prend actuellement en charge les messages Créer et Mettre à jour.
Pour plus d’informations sur la configuration des mappages d’entités, accédez à Configurer les mappages d’entités.
Appliquer le consentement du patient
Les ressources des patients incluent un paramètre de configuration supplémentaire pour l’écriture différée. Les patients peuvent choisir de consentir ou de refuser la mise à jour de leurs données à partir de l’application Dataverse. L’attribut Synchronisation Azure FHIR activée enregistre ce consentement pour chaque patient.
Lorsque la valeur de l’attribut Synchronisation Azure FHIR activée est définie sur Oui et que le mappage d’entités Patient est configurée pour l’écriture différée, toutes les modifications apportées aux attributs mappés sont publiées sur le point de terminaison FHIR. Sinon, les plug-ins d’écriture différée ignorent les modifications du dossier patient.
Avertissements et scénarios d’erreur courants
Les avertissements et les exceptions qui peuvent se produire pendant le processus d’écriture différée sont consignés dans les journaux de la boîte à outils d’intégration des données. Pour plus d’informations sur les journaux, accédez à Examiner les journaux des Dataverse Healthcare API.
Paramètres de configuration non valides
Si les détails de connectivité fournis dans la section Paramètres d’intégration sont incorrects, le processus d’écriture différée enregistre une exception et arrête le traitement. Par exemple, les valeurs ID d’application/client ou Secret client peuvent être incorrectes.
Message traité avec des avertissements
Le point de terminaison FHIR peut renvoyer des avertissements ou des messages d’information même si la demande d’écriture différée est traitée avec succès. Les journaux enfants pour ce message d’avertissement contiennent d’autres détails que les administrateurs peuvent consulter.
Erreurs de provenance de FHIR
Toute exception liée à la création de l’enregistrement de provenance de FHIR est enregistrée avec une exception générale, ainsi que les détails renvoyés par le point de terminaison FHIR.
Attributs obligatoires manquants
Le traitement de l’écriture différée pour les mappages d’expansion nécessite une référence à l’enregistrement parent. Si la valeur de l’attribut de lien parent est manquante, le processus d’écriture différée consigne une exception et arrête le traitement.
Type de contact non valide
Pour les enregistrements de contact dans Dataverse, vous devez définir correctement l’indicateur du Type de contact pour que l’écriture différée réussisse. Par exemple, vous devez le définir sur Patient ou Praticien. Si cette valeur est manquante, le processus d’écriture différée consigne une exception et arrête le traitement.
Limitations
La solution d’écriture différée présente actuellement les limitations suivantes :
- Formatage sortant : la solution d’écriture différée ne prend pas en charge le formatage sortant. Le processus publie actuellement la ressource FHIR représentant les modifications apportées à la ressource FHIR mise à jour dans Dataverse.
- Authentification : la solution d’écriture différée prend actuellement en charge la publication uniquement sur les points de terminaison qui utilisent l’authentification OAuth.