Freigeben über

Beispiel 1: FHIRlink einrichten und Verbindung herstellen

  • Artikel

In diesem Beispiel wird erläutert, wie Sie eine Power Platform Canvas-App einrichten und mithilfe des FHIRlink-Konnektors eine Verbindung herstellen. Das Beispiel umfasst die folgenden Schritte:

  • Erstellen einer Canvas-App ohne Vorlage.
  • Verwendung der in Verbindung erstellen eingerichteten FHIRlink-Verbindung.

Sie können die endgültige Lösung auch als Implementierungsbeispiel herunterladen und importieren. Weitere Informationen finden Sie unter Beispiel herunterladen. Bevor Sie mit dem Beispiel beginnen oder die Beispieldaten verwenden, lesen Sie die Annahmen über die Beispielverwendung.

Anmerkung

FHIR® (im Eigentum von Health Level Seven International), Google™ (im Eigentum von Google LLC) und EPIC® (im Eigentum von Epic Systems Corporation) sind eingetragene Marken. Die Verwendung dieser Marken auf dieser Seite stellt keine Billigung durch Health Level Seven International, Google oder Epic Systems dar.

Erstellen Sie eine neue Canvas App

Um eine neue Canvas-App zu erstellen, gehen Sie wie unter Erstellen Sie eine Canvas-App ohne Vorlage beschrieben vor. Nennen Sie diese Canvas-App FHIRlink-Beispiel. Für den Rest dieses Beispiels bezeichnen wir diese Canvas-App als FHIRlink-Beispiel.

Nun greifen wir auf die in der Voraussetzung im Abschnitt Verbindung herstellen konfigurierte FHIRlink-Verbindung zu. In diesem Beispiel nutzen wir die Möglichkeit der Verbindung zu Google FHIR-Diensten.

  1. Wählen Sie im Navigationsbereich der App Daten aus, um den Datenbereich zu erweitern.

  2. Wählen Sie Daten hinzufügen, um eine Datenquelle auszuwählen.

  3. Geben Sie im Suchfeld FHIRlink ein, um die Liste der verfügbaren Konnektoren zu filtern.

  4. Wählen Sie FHIRlink. Anschließend sollten Sie die gespeicherte Verbindung aus dem Abschnitt Eine Verbindung herstellen sehen.

    Ein Screenshot, der die Konnektorsuche anzeigt.

Daten vom FHIR-Server abrufen

Nachdem Sie der App die FHIRlink-Verbindung hinzugefügt haben, können Sie den Konnektor verwenden, um Daten vom FHIR-Server abzurufen. Testen Sie den Datenabruf, indem Sie die FHIRlink-ListResources-Methode aufrufen, mit der Sie Datensätze im FHIR-Dienst für eine bestimmte Ressource auflisten können. Weitere Informationen zu dieser Methode finden Sie unter Ressourcen nach Typ auflisten.

Methodendetails anzeigen

  1. Fügen Sie auf dem Hauptbildschirm der Canvas-App eine neue Schaltfläche hinzu und nennen Sie es Ressourcen auflisten.

  2. Geben Sie auf dem OnSelect-Ereignis für die Schaltfläche den folgenden Wert ein: FHIRlink.ListResources.

    In dieser Ansicht werden die Methodendetails und verfügbaren Parameter angezeigt, während Sie mit der Eingabe des Werts beginnen.

    Ein Screenshot mit der Methodendetailsansicht.

Parameter hinzufügen

  1. Aktualisieren Sie die Ereignisanweisung, indem Sie den folgenden Wert in den Bearbeitungsbereich eingeben:

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

    Diese Anweisung ruft die ListResources-Methode auf und beschränkt die zurückgegebenen Felder auf id, name, birthDate und telecom der Ressource. Der zurückgegebene Paket-Wert wird der _patientList-Variablen zugewiesen.

    Ein Screenshot mit den Power Fx-Code- und -Methodenparametern.

  2. Im vorherigen Screenshot ruft die Anweisung FHIRlink.ListResources("Patient", {_elements:"id,name,birthDate,telecom"}) eine Liste von Patienten-FHIR-Ressourcen von Ihrem verbundenen Dienst ab. Sie können auch weitere Parameter anzeigen, die mit der Methode Ressource auflisten verfügbar sind.

Die ListResources-Methode aufrufen und die Ergebnisse validieren

Um den neuen Code und die OnSelect-Methode der Schaltfläche Ressourcen auflisten zu testen, führen Sie die App aus, indem Sie Ausführen im Hauptmenü der Symbolleiste auswählen. Wenn die App gestartet wird, wählen Sie Ressourcen auflisten. Diese Aktion ruft die ListResources-Methode im Designer auf, was bedeutet, dass der Konnektor in Echtzeit einen Anruf an den FHIR-Dienst tätigt und nach Patienten sucht. Wenn bei Ihrer Verbindung Fehler auftreten, wird im Designerbereich eine Fehlermeldung angezeigt. Wenn keine Fehler angezeigt werden, können Sie davon ausgehen, dass die Methode korrekt aufgerufen wurde.

Als Nächstes können Sie die Ergebnisse testen, indem Sie den aktuellen Wert der _patientList-Variablen überprüfen. Durch Anzeigen der Variablendetails können Sie überprüfen, ob der Methodenaufruf erfolgreich war und ob Sie die erwarteten Ergebnisse erhalten haben.

  1. Wählen Sie im Navigationsbereich Variablen aus und erweitern Sie den Abschnitt Globale Variablen, um die _patientList-Variable anzusehen.

  2. Klicken Sie mit der rechten Maustaste auf den Variablenwert, um das Menüelement Variable anzeigen anzuzeigen.

    Ein Screenshot, der zeigt, wie die Variable überprüft wird.

  3. Im Dialogfeld Variable anzeigen sehen Sie ein einzelnes Einzelelement für das Paket und den JSON-Inhalt der FHIR-Paket-Antwort aus der ListResources-Anfrage.

    Ein Screenshot mit der Liste der FHIR-Ressourcendatensätze.

  4. Mithilfe dieser Ansicht können Sie die FHIR-Paketdatensätze überprüfen, die der Konnektor über den ListResources-Methodenaufruf zurückgibt. Der Konnektor gibt diese Daten als Nicht typisierter Objektdatentyp zurück.

Beispiel- herunterladen

Sie können die fertige Canvas-App-Lösung aus diesem Beispiel als Implementierungsbeispiel herunterladen und importieren. Das Beispiel steht in den folgenden drei Formaten zum Download zur Verfügung:

Anweisungen zum Importieren und Exportieren von Canvas-Apps finden Sie unter Canvas-App-Pakete exportieren und importieren.

Nächste Schritte,

In Beispiel 2: FHIR-Daten in Ihrer Canvas-App binden erfahren Sie, wie Sie die Ergebnisse des Methodenaufrufs und die Paketeinträge an ein Canvas App-Steuerelement binden.

Beispiel 2: FHIR-Daten in Ihrer Canvas-App binden

Erfahren Sie mehr

Weitere Details zur Canvas-App zu diesem Beispiel finden Sie unter: