Übung – Einen neuen Konnektor in einer Lösung erstellen

  • 6 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 1: 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.

    Ein Pfeil zeigt auf den API-Dokumentationslink – Screenshot

  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.

    Ein Pfeil, der auf die Schaltfläche „Speichern unter“ zeigt – Screenshot

  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.

    API-Schlüssel für Contoso Invoicing – Screenshot

  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 2: 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 für den Anzeigenamen ein, wählen Sie CDS Default Publisher für Herausgeber und dann Erstellen aus. Wenn Sie mit einem realen Projekt arbeiten, erstellen Sie am besten Ihren eigenen Herausgeber.

    Neue Lösung „Contoso Invoicing“ erstellen – Screenshot

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

Aufgabe 3: 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.

    Ein Pfeil, der auf „Neue benutzerdefinierte Verbindung erstellen“ zeigt – Screenshot

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

    Ein Pfeil, der auf das Bildsymbol für Herunterladen zeigt – Screenshot

  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 contosoinvoicingtest.azurewebsites.net für Host ein.

  7. Wählen Sie Konnektor erstellen aus.

    Ein Pfeil, der auf die Schaltfläche „Konnektor erstellen“ zeigt – Screenshot

  8. Navigieren Sie nicht von dieser Seite weg.

Aufgabe 4: 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.

    Ein Pfeil, der auf die Schaltfläche „Zurück“ verweist – Screenshot

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

    Ein Pfeil, der auf die Schaltfläche „Von OpenAPI-Datei aktualisieren“ verweist – Screenshot

  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 Fortsetzen aus.

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

    Ein Pfeil, der auf die Registerkarte „Sicherheit“ verweist – Screenshot

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

  8. Navigieren Sie nicht von dieser Seite weg.

Aufgabe 5: 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 das blaue Informationssymbol neben GetInvoice, das darauf hinweist, dass etwas Ihre Aufmerksamkeit erfordert.

    Ein Pfeil, der auf die Aktion „Rechnung abrufen“ verweist – Screenshot

  4. Wählen Sie den Vorgang GetInvoice aus.

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

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

    Zusammenfassung der Aktion „Rechnung abrufen“ – Screenshot

  7. Beachten Sie den blauen Informationskreis im 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.

    Ein Pfeil, der auf die Schaltfläche „Löschen“ verweist – Screenshot

  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.

    Ein Pfeil, der auf die Schaltfläche „Konnektor aktualisieren“ zeigt – Screenshot

  13. Navigieren Sie nicht von dieser Seite weg.

Aufgabe 6: Konnektor testen

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

  1. Wählen Sie die Registerkarte Testen aus.

  2. Wählen Sie + Neue Verbindung aus.

    Ein Pfeil, der auf die Schaltfläche „Neue Verbindung“ verweist – Screenshot

  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.

    Ein Pfeil, der auf die Schaltfläche „Aktualisieren“ zeigt – Screenshot

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

    Ein Pfeil, der auf die Schaltfläche „Vorgang testen“ zeigt – Screenshot

Ihnen sollten einige Rechnungsdaten im Textbereich angezeigt werden.