So verwenden Sie benutzerdefinierte Konnektoren in Power Apps, um mit Learn365-Daten zu interagieren

Konnektoren ermöglichen es benutzerdefinierten Anwendungen, über Microsoft Power Apps mit Learn365-Daten zu interagieren. Falls Sie zusätzliche Daten abrufen müssen, auf die Sie mithilfe der standardmäßigen LMS365-Konnektoren nicht zugreifen können, können Sie eigene Konnektoren erstellen und verwenden. Dieser Artikel beschreibt die Schritte zum Erstellen benutzerdefinierter Konnektoren und zu deren Verwendung in Power Apps.

Außerdem kann dies hilfreich sein, wenn Sie die Aktionen HttpRequest und HttpRequest_v2 des standardmäßigen LMS365-Konnektors in Power Apps verwenden möchten. Da diese Aktionen nur in Power Automate ohne Einschränkungen verwendet werden können, kann das Erstellen eines benutzerdefinierten Konnektors in einem solchen Fall als Workaround dienen.

In diesem Artikel

• So erstellen Sie einen benutzerdefinierten Konnektor
• So verwenden Sie einen benutzerdefinierten Konnektor in Power Apps

So erstellen Sie einen benutzerdefinierten Konnektor

So erstellen Sie einen neuen Konnektor:

1. Navigieren Sie zum Menü Power Apps, wählen Sie Solutions aus und wählen Sie +New solution, um eine neue Lösung zu erstellen. Füllen Sie das Feld aus und wählen Sie Create aus.

2. Doppelklicken Sie auf die neue Lösung, die Sie gerade erstellt haben. Dadurch können Sie ihr einen Konnektor hinzufügen, indem Sie das Dropdown-Menü +New erweitern und zu Automation > Custom connector navigieren

Weitere Informationen zu Lösungskonzepten finden Sie in der Microsoft-Dokumentation.

3. Über Custom connector gelangen Sie zur Seite für die Konnektorerstellung.

• Füllen Sie die Felder im Abschnitt General Schritt für Schritt aus: Fügen Sie den Konnektor-Namen hinzu, laden Sie ein Symbol hoch und fügen Sie eine Beschreibung, ein Schema, einen Host und eine Basis-URL hinzu. 
   

Da wir an den Learn365 Daten interessiert sind, verwenden wir den Learn365 Cloud API-Host.

• Wechseln Sie zum Abschnitt Sicherheit. Wählen Sie hier die Basic authentication aus.
   

• Im nächsten Abschnitt – Definition – müssen Sie Definitionen für Ihren Connector erstellen. Sie können zahlreiche Aktionen oder Trigger hinzufügen, die zu verschiedenen Antworten führen. In unserem Beispiel verwenden wir nur eine Aktion. Damit sollten wir die Learn365 Daten aus der Tabelle Courses abrufen können. 
   

Sie können eine Anfrage hinzufügen, die von dieser Aktion verwendet wird. Wählen Sie dazu Import from sample aus, wählen Sie die Methode GET aus und geben Sie die Anfrage-URL an. In unserem Fall lautet sie https://ne-api.365.systems/odata/v2/Courses.

Wir fügen außerdem Abfrageparameter hinzu. Wir möchten $expand verwenden, da wir die Tags und Kategorien-Parameter erweitern möchten, und zusätzlich die Möglichkeit hinzufügen, $filters zu nutzen.

Der nächste Schritt besteht darin, ein Antwort-Beispiel zu erstellen. Wählen Sie dazu Response > +Add default sample aus. Ein Bereich wird geöffnet, in dem Sie den Body des Antwortbeispiels angeben können.

Bevor Sie starten, müssen Sie jedoch zunächst den Body des Antwortbeispiels abrufen. Folgen Sie dazu den untenstehenden Schritten:

1. Navigieren Sie zu api.365.systems

2. Verwenden Sie den Endpunkt GET /odata/v2/Courses.

3. Erweitern Sie Tags and Categories, damit Sie die Antwort erhalten, mit der das entsprechende Schema erstellt wird

4. Laden Sie das Ergebnis herunter, fügen Sie es in das Feld für den Body des Antwortbeispiels ein und wählen Sie die Schaltfläche Import aus. Das Schema sollte automatisch erstellt und dem Connector-Code hinzugefügt werden.

Bei einem erfolgreichen Ergebnis sehen Sie, dass viele Parameter zum Antworttext hinzugefügt wurden und die Meldung „Validation succeeded“ angezeigt wird.

Der Abschnitt Code (Vorschau) ist optional.

Wenn Sie mit Schritt 1 bis 3(4) fertig sind, speichern Sie alle Änderungen, erstellen Sie den Connector und fahren Sie mit dem Testen fort. Wenn alles korrekt ist, sollten Sie einen 200-Antwortcode erhalten.

So verwenden Sie einen benutzerdefinierten Connector in Power Apps

Im nächsten Schritt erstellen Sie eine einfache App, die die mithilfe unseres benutzerdefinierten Connectors abgerufenen Daten verwendet. Führen Sie dazu die folgenden Schritte aus:

1. Navigieren Sie zu Power Apps und wählen Sie im Seitenmenü +Create aus. Wählen Sie dann Blank app > Blank canvas app. Geben Sie den Namen an und bestätigen Sie mit Create.

2. Suchen Sie im Menü Data nach Ihrem neuen Connector und stellen Sie eine Verbindung zu ihm her.

3. Navigieren Sie zum Menü Insert und fügen Sie ein Element hinzu, um die Daten zu visualisieren.

4. Mit unserem benutzerdefinierten Connector führen wir eine Abfrage aus, um die Kursliste abzurufen. Wir möchten, dass die Tabellen Tags and Categories erweitert werden. Außerdem filtern wir so, dass wir nur Kurse aus einem bestimmten Katalog erhalten. Auf diese Weise sollte die Formel wie folgt aussehen:

Defaulttitle.GetCourses({'$expand':"Tags,Categories", '$filter': "CourseCatalogId eq value"}).value

Nach ein paar Sekunden werden die Daten geladen sein. Sie können Ihrer Tabelle Spalten hinzufügen. Wählen wir Title, CourseType, CreatedAt, Categories und Tags aus.

Die ersten drei Spalten werden ausgefüllt, aber die nächsten beiden, die erweitert wurden, liefern keine Ergebnisse – außer dem [object Object]-Wert in den Zeilen, in denen wir eigentlich eine Kategorie oder ein Tag erhalten sollten. Außerdem sehen wir Formelfehler für diese Spalten.

Das lässt sich jedoch beheben, da wir diese Tabellen in unserer Abfrage bereits erweitert haben. Für diese Spalten wählen wir mithilfe der Concat-Funktion nur einen Wert aus der Tabelle aus: Wählen Sie die Spalte aus und setzen Sie statt ThisItem.Categories Concat(ThisItem.Categories.Name, Name, ", ") ein. 

Dasselbe gilt für ThisItem.Tags.

Das ergibt folgendes Ergebnis: