Configurer les Dataverse Healthcare API
Cet article fournit un guide détaillé pour configurer les Dataverse Healthcare API.
Accorder à une application Azure l’accès à l’environnement Dataverse
La première étape pour activer l’accès aux Dataverse Healthcare API consiste à accorder à une application Azure l’accès à l’environnement Dataverse. Les étapes suivantes vous guident dans la configuration d’un Enregistrement d’application dans Azure, puis l’octroi à cette application d’un accès à Dataverse en configurant un utilisateur de l’application.
Enregistrer une application avec la plateforme d’identité Microsoft. Une fois que vous avez configuré l’enregistrement de l’application, assurez-vous de capturer l’ID de l’application ou du client.
Dans le centre d’administration Power Platform, ouvrez votre environnement Dataverse.
Dans le volet d’actions, sélectionnez Paramètres.
Sous Utilisateurs + Autorisations, sélectionnez Utilisateurs de l’application.
Dans le volet d’actions, sélectionnez Nouvel utilisateur de l’application.
Dans le volet qui s’ouvre, sélectionnez Ajouter une application.
Effectuez une recherche à l’aide de votre ID d’application/client, sélectionnez votre application, puis sélectionnez Ajouter.
Sélectionnez votre Division.
Sélectionnez le rôle de sécurité Utilisateur enregistré de l’application Administrateur de la synchronisation pour FHIR, puis sélectionnez Enregistrer.
Sélectionnez Créer.
Configurer les paramètres d’intégration
Les paramètres d’intégration de la boîte à outils d’intégration des données vous donnent accès aux variables d’environnement Dataverse que vous pouvez utiliser pour configurer les Dataverse Healthcare API.
Avec la prise en charge de l’écriture différée, configurez des mappages d’entités pour les enregistrements Dataverse à réécrire sur le serveur distant. Après la configuration, les nouveaux enregistrements créés dans Dataverse ou les enregistrements créés en utilisant les Dataverse Healthcare API entrantes peuvent être mis à jour et publiés sur le point de terminaison distant.
Outre les étapes de configuration, la section suivante décrit également les paramètres d’intégration requis pour se connecter au point de terminaison à distance pour les événements d’écriture différée. Pour accéder aux paramètres d’intégration dans la boîte à outils d’intégration des données :
Connectez-vous à Microsoft Power Apps.
Dans le volet Environnements, sélectionnez l’environnement dans lequel vous avez déployé la boîte à outils d’intégration des données.
Dans le volet de navigation gauche, sélectionnez Applications, puis Boîte à outils d’intégration des données.
Sous Configuration de l’application, sélectionnez Paramètres d’intégration, puis sélectionnez Dataverse Healthcare API.
Définissez les variables avec les valeurs de votre environnement.
Les paramètres pour les Dataverse Healthcare API sont classés dans les deux sections suivantes :
- Paramètres généraux : couvre les paramètres de journalisation et d’ingestion.
- Configuration de l’écriture différée : couvre les paramètres de connectivité et de nouvelle tentative pour le point de terminaison d’écriture différée à distance.
Paramètres généraux
Le tableau suivant décrit les paramètres généraux des variables d’environnement :
| Nom | Description | active |
|---|---|---|
| Niveau de journalisation | Contrôle le niveau d’informations enregistrées dans Dataverse pour les Dataverse Healthcare API entrantes et les événements d’écriture différée. Par défaut, la valeur est définie sur Désactivé. Pour plus d’informations, consultez Examiner les journaux des Dataverse Healthcare API. |
Utilisez l’une des valeurs suivantes : Informations seulement : détails du journal marqués comme informations. Avertissement seulement : détails du journal marqués comme avertissement. Exception seulement : détails du journal marqués comme erreur ou exception. Détaillé : enregistrez tous les détails. Désactivé : désactivez la journalisation. |
| Limite de taille du pack FHIR pour Upsert | Nombre maximal de ressources dans un pack. Par défaut, la valeur est 100. | Utiliser une valeur de 1 à 500 pour contrôler le nombre maximum de ressources dans un pack valide. Si la taille du pack dépasse la limite configurée, l’API du pack upsert répond par une erreur. |
Configuration de l’écriture différée
Les messages d’écriture différée peuvent être publiés sur un autre point de terminaison au lieu du service FHIR, par exemple une Azure Logic App ou une Azure Function prenant en charge Open Authorization (OAuth) Les paramètres d’écriture différée vous permettent de fournir des détails de connexion pour le point de terminaison FHIR et un autre point de terminaison sortant (si disponible) pour les messages publiés. Les valeurs du service FHIR sont nécessaires pour la validation et la construction des messages FHIR sortants. Ces valeurs de connexion sont facultatives, et si elles sont fournies, les messages sont publiés sous forme de pack FHIR sur ce point de terminaison.
Les sections suivantes décrivent les paramètres des variables d’environnement pour la configuration de la solution d’écriture différée. Vous pouvez sélectionner les valeurs à configurer en fonction de votre scénario d’utilisation.
Paramètres de service FHIR
Ces paramètres constituent les paramètres spécifiques à un service FHIR, tel qu’un service FHIR des services de données de santé Azure.
| Nom | Description | active |
|---|---|---|
| ID application/client | ID utilisateur d’enregistrement d’application configuré pour le service FHIR auquel le service d’écriture différée se connecte. | ID d’utilisateur d’inscription de l’application (GUID) |
| Clé secrète client | La clé secrète client associée à l’ID utilisateur d’inscription d’application. Note : pour des raisons de sécurité, vous ne pouvez pas utiliser les outils d’administration pour accéder à la valeur du secret client après l’avoir enregistrée. |
Clé secrète client (chaîne) |
| Ressource | Chaîne de ressource ou de portée du service FHIR utilisé pour acquérir le jeton d’authentification. Pour le service FHIR des services de données de santé Azure, cette valeur est généralement la même que l’URL du point de terminaison. |
Chaîne ou URL correctement formatée |
| URL de base du point de terminaison | L’URL du service FHIR auquel le service d’écriture différée se connecte. | URL correctement formatée |
| URL d’autorité | L’URL du fournisseur d’autorité OAuth, y compris l’ID du locataire. Le service d’écriture différée utilise cette URL pour acquérir le jeton d’authentification pour l’ID client et la clé secrète donnés. | URL correctement formatée |
Autres paramètres de point de terminaison sortant
Ces paramètres constituent les paramètres spécifiques à un autre point de terminaison d’écriture différée, tel qu’une application logique. Le point de terminaison sortant alternatif doit prendre en charge l’authentification via OAuth 2.0 en utilisant un ID client et un secret client, et doit être configuré avec un déclencheur HTTP.
| Nom | Description | active |
|---|---|---|
| ID application/client | L’ID utilisateur d’enregistrement de l’application configuré pour le point de terminaison distant auquel le service d’écriture différée se connecte. | ID d’utilisateur d’inscription de l’application (GUID) |
| Clé secrète client | La clé secrète client associée à l’ID utilisateur d’inscription d’application. Note : pour des raisons de sécurité, vous ne pouvez pas utiliser les outils d’administration pour accéder à la valeur du secret client après l’avoir enregistrée. |
Clé secrète client (chaîne) |
| Ressource | Chaîne de ressource ou de portée du point de terminaison distant utilisé pour acquérir le jeton d’authentification. Pour le service FHIR des services de données de santé Azure, cette valeur est généralement la même que l’URL du point de terminaison. | Chaîne ou URL correctement formatée |
| URL de base du point de terminaison | L’URL du point de terminaison distant auquel le service d’écriture différée se connecte. | URL correctement formatée |
| URL d’autorité | L’URL du fournisseur d’autorité OAuth, y compris l’ID du locataire. Le service d’écriture différée utilise cette URL pour acquérir le jeton d’authentification pour l’ID client et la clé secrète donnés. | URL correctement formatée |
Important
Lorsque vous utilisez un autre point de terminaison tel qu’une Azure Function ou une Logic App, assurez-vous de configurer le point de terminaison avec un déclencheur HTTP. Lorsque le service d’écriture différée publie sur cet emplacement, il envoie également un Pack FHIR contenant la ressource FHIR créée ou mise à jour et un message de provenance FHIR.
Le service d’écriture différée attend un pack contenant la réponse du service FHIR distant en tant que réponse du point de terminaison FHIR distant. Ce réponse est nécessaire pour mettre à jour l’enregistrement Dataverse avec le nouvel ID de version FHIR et les dernières valeurs modifiées. Pour obtenir des exemples de réponses attendues, consultez Écriture différée dans un point de terminaison alternatif.
Paramètres généraux de l’écriture différée
| Nom | Description | Valeur |
|---|---|---|
| Délai d’attente maximal des nouvelles tentatives | Le nombre maximal de minutes entre les tentatives automatiques avant l’échec d’un message. | Délai d’expiration de la nouvelle tentative (minutes) Valeur par défaut : 5 |
| Nombre maximal de nouvelles tentatives | Le nombre maximal de tentatives avant l’échec d’un message. | Nombre de nouvelle tentatives (nombre) Valeur par défaut : 3 |
| ID d’utilisateur d’inscription de l’application FHIR | L’ID utilisateur d’enregistrement de l’application configuré pour le traitement des messages entrants. Cette variable permet au processeur d’écriture différée de filtrer les messages entrants et d’éviter le traitement circulaire. | ID d’utilisateur d’inscription de l’application (GUID) |
Configurer l’ingestion des données
Après avoir mis à jour les paramètres d’intégration, vous pouvez publier des offres groupées FHIR directement sur le point de terminaison de l’API personnalisée. Vous pouvez également déployer une application logique pour faciliter le relais des données entre Dataverse et le service FHIR des services de données de santé Azure. Pour en savoir plus, consultez :
- Publiez des données directement dans les Dataverse Healthcare API.
- Créez une application logique via une configuration manuelle pour synchroniser les données entre les Dataverse Healthcare API et les services de données de santé Azure.
- Déployez un groupe de Logic Apps à l’aide d’un modèle pour orchestrer l’ingestion des offres groupées FHIR dans les Dataverse Healthcare API et les services de données de santé Azure.