Partager via

Exemple 1 : Configurer et connecter à FHIRlink

  • Article

Cet exemple explique comment configurer une application canevas Power Platform et s’y connecter à l’aide du connecteur FHIRlink. L’exemple couvre les étapes suivantes :

  • Création d’une application canevas vide.
  • Utilisation de la connexion FHIRlink configurée dans Créer une connexion.

Vous pouvez également télécharger et importer la solution finale comme exemple de mise en œuvre. Pour plus d’informations, consultez Télécharger l’exemple. Avant de commencer l’exemple ou de l’utiliser, consultez Hypothèses pour l’utilisation des exemples.

Note

FHIR® (propriété de Health Level Seven International), Google™ (propriété de Google LLC) et EPIC® (propriété d’Epic Systems Corporation) sont des marques déposées. L’utilisation de ces marques sur cette page ne constitue pas une approbation de Health Level Seven International, Google ou Epic Systems.

Créer une application canevas

Pour créer une nouvelle application canevas, suivez les étapes dans Créer une application canevas vide à partir de zéro. Attribuons le nom Exemple FHIRlink à cette application canevas. Pour le reste de cet exemple, nous faisons référence à cette application canevas sous le nom Exemple FHIRlink.

Maintenant, accédons à la connexion FHIRlink configurée dans la section des prérequis Créer une connexion. Dans cet exemple, nous utilisons l’option de connexion aux services FHIR Google.

  1. Dans le volet de navigation de l’application, sélectionnez Données pour développer le volet des données.

  2. Sélectionnez Ajouter des données pour sélectionner une source de données.

  3. Dans la zone de recherche, saisissez FHIRlink pour filtrer la liste des connecteurs disponibles.

  4. Sélectionnez FHIRlink. Vous devriez voir la connexion enregistrée à partir de la section Créer une connexion.

    Une capture d’écran affichant la recherche du connecteur.

Récupérer les données du serveur FHIR

Après avoir ajouté la connexion FHIRlink à l’application, vous pouvez utiliser le connecteur pour récupérer les données du serveur FHIR. Testez la récupération des données en appelant la méthode ListResources de FHIRlink, qui vous permet de répertorier les enregistrements dans le service FHIR pour une ressource donnée. Pour plus d’informations sur cette méthode, consultez Répertorier les ressources par type.

Afficher les détails de la méthode

  1. Dans l’écran principal de l’application canevas, ajoutez un nouveau bouton et étiquetez-le Répertorier les ressources.

  2. Dans l’événement OnSelect du bouton, saisissez la valeur suivante : FHIRlink.ListResources.

    Cette vue affiche les détails de la méthode et les paramètres disponibles à mesure que vous commencez à saisir la valeur.

    Une capture d’écran affichant la vue des détails de la méthode.

Ajouter des paramètres

  1. Mettez à jour l’instruction de l’événement en saisissant la valeur suivante dans le volet de modification :

    Set(_patientList, FHIRlink.ListResources("Patient", {_elements:"id,name,birthDate,telecom"}));

    Cette instruction appelle la méthode ListResources et restreint les champs renvoyés aux valeurs id, name, birthDate et telecom de la ressource. La valeur du groupe renvoyé est attribuée à la variable _patientList.

    Une capture d’écran affichant le code Power Fx et les paramètres de la méthode.

  2. Dans la capture d’écran précédente, l’instruction FHIRlink.ListResources("Patient", {_elements:"id,name,birthDate,telecom"}) récupère une liste de ressources FHIR Patient de votre service connecté. Vous pouvez également voir plus de paramètres disponibles avec la méthode Répertorier les ressources.

Appeler la méthode ListResources et valider les résultats

Pour tester le nouveau code et la méthode OnSelect du bouton Répertorier les ressources, exécutez l’application en sélectionnant Exécuter dans le menu principal de la barre d’outils. Lorsque l’application se lance, sélectionnez Répertorier les ressources. Cette action appelle la méthode ListResources à partir du concepteur, ce qui signifie que le connecteur effectue un appel en temps réel au service FHIR et recherche des patients. Si votre connexion comporte des erreurs, le volet du concepteur affiche un message d’erreur. Si aucune erreur n’est affichée, vous pouvez supposer que la méthode est appelée correctement.

Ensuite, vous pouvez tester les résultats en vérifiant la valeur actuelle de la variable _patientList. En affichant les détails de la variable, vous pouvez vérifier si l’appel à la méthode a réussi et si vous avez reçu les résultats attendus.

  1. Dans le volet de navigation, sélectionnez Variables et développez la section Variables globales pour afficher la variable _patientList.

  2. Cliquez avec le bouton droit sur la valeur de la variable pour afficher l’élément de menu Afficher la variable.

    Une capture d’écran montrant comment inspecter la variable.

  3. Dans la boîte de dialogue Afficher la variable, vous pouvez voir un seul élément de ligne pour le groupe et le contenu JSON de la réponse du groupe FHIR de la demande ListResources.

    Une capture d’écran affichant la liste des enregistrements de la ressource FHIR.

  4. En utilisant cette vue, vous pouvez vérifier les enregistrements du groupe FHIR renvoyés par le connecteur via l’appel à la méthode ListResources. Le connecteur renvoie ces données sous la forme d’un Type de données d’objet sans type.

Télécharger l’exemple

Vous pouvez télécharger et importer la solution complète de l’application canevas à partir de cet exemple en guise d’exemple de mise en œuvre. L’exemple est disponible au téléchargement dans les trois formats suivants :

Pour obtenir des instructions sur l’importation et l’exportation d’applications canevas, consultez Exporter et importer des packages d’applications canevas.

Étapes suivantes

Dans Exemple 2 : Lier les données FHIR à votre application canevas, découvrez comment lier les résultats de l’appel à la méthode et les entrées du groupe à un contrôle de l’application canevas.

Exemple 2 : Lier les données FHIR dans votre application canevas

En savoir plus

Pour en savoir plus sur les applications canevas liées à cet exemple, consultez :