Einen benutzerdefinierten Konnektor für die vorhandene API erstellen

  • 20 Minuten

In dieser Übung erstellen Sie Ihren ersten benutzerdefinierten Konnektor für eine vorhandene API namens Contoso Invoicing.

Wichtig

Verwenden Sie eine Testumgebung mit bereitgestelltem Microsoft Dataverse. Wenn Sie keine Testumgebung haben, können Sie sich für den Power Apps-Community-Plan anmelden.

Aufgabe: Die API überprüfen

Um die API zu überprüfen, gehen Sie wie folgt vor:

  1. Navigieren Sie zu Contoso Invoicing.

  2. Wählen Sie den Dokumentationslink aus.

    Screenshot eines Pfeils, der auf den API-Dokumentationslink zeigt

  3. Überprüfen Sie die verfügbaren Vorgänge.

  4. Wählen Sie diese Option aus, um jeden Vorgang zu erweitern und zu überprüfen.

  5. Schließen Sie die Browserregisterkarte oder das Browserfenster der Dokumentation.

  6. Wählen Sie den Link API-Definition öffnen aus.

  7. Das folgende Bild zeigt ein Beispiel für die OpenAPI-Version, die auf der Dokumentationsseite angezeigt wurde. Klicken Sie mit der rechten Maustaste, und wählen Sie Speichern unter aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Speichern unter“ zeigt

  8. Speichern Sie die Datei lokal ab. Sie verwenden diese Datei später in der Übung.

  9. Schließen Sie die Browserregisterkarte oder das Browserfenster der Definition.

  10. Wählen Sie den Link API-Schlüssel aus.

  11. Kopieren Sie den API-Schlüssel, und speichern Sie ihn, da Sie ihn später benötigen.

    Screenshot des API-Schlüssels für Contoso Invoicing

  12. Wählen Sie Zurück zur Startseite aus.

  13. Wählen Sie Logo herunterladen aus.

  14. Speichern Sie das Logo-Bild lokal. Sie werden es später verwenden.

Aufgabe: Eine neue Lösung erstellen

Gehen Sie wie folgt vor, um eine neue Lösung zu erstellen:

  1. Navigieren Sie zum Power Apps Maker Portal, und stellen Sie sicher, dass Sie sich in der richtigen Umgebung befinden.

  2. Wählen Sie Lösungen > + Neue Lösung aus.

  3. Geben Sie Contoso invoicing als Anzeigename ein, und klicken Sie dann auf + Neuer Herausgeber.

    Screenshot der Schaltfläche „Neuer Herausgeber“

  4. Geben Sie als Anzeigename Contoso ein, als Name Contoso und als Präfix contoso ein, und klicken Sie dann auf Speichern.

  5. Wählen Sie den von Ihnen erstellten HerausgeberContoso aus, und klicken Sie dann auf Erstellen. Wenn Sie mit einem realen Projekt arbeiten, erstellen Sie am besten Ihren eigenen Herausgeber.

    Screenshot des Erstellens von neuen Lösungsdetails für Contoso Invoicing

  6. Navigieren Sie nach der Auswahl von Erstellen nicht von dieser Seite weg.

Aufgabe: Einen neuen Konnektor erstellen

Gehen Sie wie folgt vor, um einen neuen Konnektor zu erstellen:

  1. Öffnen Sie die Lösung Contoso Invoicing, die Sie erstellt haben.

  2. Wählen Sie + Neu > Automatisierung > Benutzerdefinierter Konnektor aus.

    Screenshot eines Pfeils, der auf „Neue benutzerdefinierte Verbindung erstellen“ zeigt

  3. Geben Sie Contoso Invoicing für den Konnektornamen ein, und wählen Sie dann Hochladen für das Bild aus.

    Screenshot eines Pfeils, der auf das Bildsymbol für Herunterladen zeigt

  4. Wählen Sie das Konnektor-Logobild aus, das Sie in Aufgabe 1: Die API überprüfen ausgewählt haben.

  5. Geben Sie #175497 für Symbol-Hintergrundfarbe ein.

  6. Geben Sie Benutzerdefinierter Konnektor für Contoso Invoicing-API für Beschreibung ein.

  7. Geben Sie contosoinvoicingtest.azurewebsites.net für Host ein.

  8. Wählen Sie Konnektor erstellen aus.

    Screenshot der Schaltfläche „Benutzerdefinierten Konnektor erstellen“

  9. Navigieren Sie nicht von dieser Seite weg.

Aufgabe: OpenAPI-Definition importieren

Führen Sie die folgenden Schritte aus, um die OpenAPI-Definition zu importieren:

  1. Wählen Sie den Pfeil neben Konnektorname aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Zurück“ verweist

  2. Wählen Sie die Auslassungsschaltfläche (...) für den Konnektor und dann Von OpenAPI-Datei aktualisieren aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Von OpenAPI-Datei aktualisieren“ verweist

  3. Wählen Sie Importieren aus.

  4. Wählen Sie die Datei swagger.json aus, die Sie in Aufgabe 1: Die API überprüfen heruntergeladen haben, und dann Öffnen.

  5. Wählen Sie Weiter aus.

  6. Geben Sie die Host-URL als contosoinvoicingtest.azurewebsites.net an, und wählen Sie dann Sicherheit aus.

    Screenshot eines Pfeils, der auf die Registerkarte „Sicherheit“ verweist

  7. Beachten Sie, dass die Felder über die importierte Datei ausgefüllt wird.

  8. Navigieren Sie nicht von dieser Seite weg.

Aufgabe: Definitionen überprüfen und anpassen

Gehen Sie folgendermaßen vor, um Definitionen zu überprüfen und anzupassen:

  1. Wählen Sie die Registerkarte Definition aus.

  2. Nehmen Sie sich ein paar Minuten Zeit, um die importierten Vorgänge zu überprüfen.

  3. Beachten Sie neben GetInvoice den blauen Informationskreis.

  4. Wählen Sie den Vorgang GetInvoice aus.

    Screenshot mit der Aktion „Rechnung abrufen“

  5. Beachten Sie, dass der Vorgang eine fehlende Zusammenfassung angibt.

  6. Geben Sie Rechnung abrufen als Zusammenfassung ein, um die Benutzerfreundlichkeit zu verbessern.

    Screenshot der Zusammenfassung der Aktion „Rechnung abrufen“

  7. Beachten Sie den blauen Informationskreis neben dem Vorgang PayInvoice. Er weist auf eine fehlende Beschreibung hin.

  8. Geben Sie Eine Rechnung bezahlen als Beschreibung ein.

  9. Löschen Sie die beiden Vorgänge NewInvoice, da Sie sie nicht verwenden.

    Screenshot mit der Schaltfläche „Aktion löschen“

  10. Wählen Sie den Vorgang GetInvoiceSchema aus.

  11. Ändern Sie die Option Visibility in internal, damit Benutzer sie nicht in der Aktionsliste sehen.

  12. Wählen Sie Konnektor aktualisieren aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Konnektor aktualisieren“ verweist

  13. Navigieren Sie nicht von dieser Seite weg.

Aufgabe: Konnektor testen

Gehen Sie folgendermaßen vor, um den Konnektor zu testen:

  1. Wählen Sie die Registerkarte Test aus.

  2. Wählen Sie + Neue Verbindung aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Neue Verbindung“ verweist

  3. Fügen Sie den API-Schlüssel ein, den Sie in Aufgabe 1: Die API überprüfen gespeichert haben, und wählen Sie dann Verbindung erstellen aus.

  4. Wählen Sie die Schaltfläche Aktualisieren aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Aktualisieren“ zeigt

  5. Wählen Sie ListInvoiceTypes > Vorgang testen aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Vorgang testen“ verweist

  6. Ihnen sollten die Rechnungstypen im Textbereich angezeigt werden.

    Screenshot der Rechnungstypen

Aufgabe: Benutzerdefinierten Konnektor in Canvas-App verwenden

In dieser Aufgabe erstellen Sie eine Canvas-Anwendung und verwenden den von Ihnen erstellten benutzerdefinierten Konnektor, um eine Liste von Rechnungen anzuzeigen.

  1. Navigieren Sie zum Power Apps Maker Portal, und überprüfen Sie, ob Sie sich in der richtigen Umgebung befinden.

  2. Wählen Sie Lösungen aus, und öffnen Sie die von Ihnen erstellte Lösung Contoso Invoicing.

  3. Wählen Sie + Neu und anschließend App > Canvas-App aus.

    Screenshot der Schaltfläche „Neue Canvas-Anwendung erstellen“

  4. Geben Sie als App-Name Contoso invoicing-App ein, wählen Sie als Format Telefon und dann die Option Erstellen aus.

  5. Wählen Sie die Registerkarte Daten und dann + Daten hinzufügen aus, erweitern Sie Konnektoren, und klicken Sie dann auf den von Ihnen erstellten benutzerdefinierten Konnektor Contoso Invoicing.

    Screenshot des benutzerdefinierten Contoso Invoicing-Konnektors

  6. Wählen Sie + Einen Konnektor hinzufügen aus.

  7. Fügen Sie den API-Schlüssel ein, den Sie in Aufgabe 1: Die API überprüfen gespeichert haben, und wählen Sie dann Verbinden aus.

  8. Wählen Sie im Premium-Warnungs-Popup-Fenster die Option Verstanden aus.

  9. Wählen Sie die Registerkarte Strukturansicht aus.

  10. Wählen Sie + Einfügen und dann Vertikaler Katalog aus.

    Screenshot der Schaltfläche „Vertikalen Katalog einfügen“

  11. Wählen Sie unter „Daten“ ContosoInvoicing aus.

    Screenshot des Dialogfelds „Daten auswählen“

  12. Legen Sie die Elemente auf die Werte unten fest.

    ContosoInvoicing.ListInvoices().invoices

    Screenshot des Werts der Galerieelemente

  13. Erweitern Sie den Katalog, und wählen Sie Untertitel aus.

  14. Richten Sie den Wert Text des Untertitels auf ThisItem.amount ein:

  15. Erweitern Sie den Katalog, und wählen Sie im Katalog den Titel aus.

  16. Richten Sie den Wert Text des Titels auf ThisItem.accountName ein.

    Screenshot des Werts des Titeltexts

  17. Der Katalog sollte nun wie im Bild unten aussehen.

    Screenshot mit dem Katalog