Übung – Eine Richtlinienvorlage zum dynamischen Festlegen der Host-URL verwenden

10 Minuten

In dieser Übung erstellen Sie eine Richtlinienvorlage zum Festlegen der Host-URL bei der Verbindungserstellung. Dieser Prozess ermöglicht es einer Verbindung, entweder mit einer Test- oder einer Produktionsumgebung zu arbeiten.

Für diese Übung müssen Sie Python installieren und auf die Eingabeaufforderung auf dem Computer zugreifen, den Sie für die Übung verwenden.

Wichtig

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

Hinweis

Laden Sie die folgende Datei auf Ihren lokalen Computer herunter, um diese Übung Contoso Invoicing Triggers abzuschließen. Wählen Sie die Schaltfläche „Herunterladen“ im mittleren rechten Teil des Bildschirms aus.

Aufgabe 1: Lösung importieren

In dieser Aufgabe importieren Sie eine nicht verwaltete Lösung, die einen benutzerdefinierten Konnektor für die Contoso Invoicing enthält. Sie verwenden diesen Konnektor, um die Aufgaben in dieser Übung abzuschließen.

Navigieren Sie zum Power Apps Maker Portal, und stellen Sie sicher, dass Sie sich in der richtigen Umgebung befinden.
Wählen Sie Lösungen > Lösung importieren aus.
Wählen Sie Durchsuchen aus.
Wählen Sie die Lösung ContosoInvoicingPolicyTemplates_1_0_0_2.zip und dann Öffnen aus.
Wählen Sie Weiter aus.
Wählen Sie Importieren aus, und warten Sie dann, bis der Import abgeschlossen ist. Nach Abschluss des Imports sollte eine Erfolgsmeldung angezeigt werden.
Wählen Sie Alle Anpassungen veröffentlichen aus, und warten Sie dann, bis die Veröffentlichung abgeschlossen ist.
Öffnen Sie die Lösung Contoso Invoicing – Richtlinienvorlagen, die Sie importiert haben.

Ihnen sollte die benutzerdefinierte Konnektorkomponente Contoso Invoicing – Richtlinie angezeigt werden.

Aufgabe 2: Microsoft Power Platform-CLI installieren

Die Microsoft Power Platform-CLI enthält das paconn-Befehlszeilentool, das zur Unterstützung der Entwicklung benutzerdefinierter Konnektoren in Microsoft Power Platform entwickelt wurde. Das paconn-Tool verwendet die Python-Laufzeit, daher installieren Sie auch diese Anwendung.

Navigieren Sie zu Python herunterladen, und wählen Sie Python herunterladen aus. Sie können jede Version höher als 3.5 verwenden.
Wählen Sie die heruntergeladene .exe-Datei aus, um die Installation zu starten.
Aktivieren Sie das Kontrollkästchen Add Python xx to Path (Python xx zum Pfad hinzufügen), wählen Sie install (Installieren) aus, und warten Sie dann, bis die Installation abgeschlossen ist.
Schließen Sie den Installationsassistenten, nachdem die Installation abgeschlossen ist.
Starten Sie die Eingabeaufforderung, und führen Sie den folgenden Befehl aus, um paconn zu installieren.

pip install paconn
Warten Sie, bis die Installation abgeschlossen ist.

Aufgabe 3: Den Konnektor lokal herunterladen

In dieser Aufgabe laden Sie die Konnektor-Definitionsdateien lokal herunter, damit Sie die Eigenschaft Host URL hinzufügen können.

Führen Sie den Anmeldebefehl aus.

paconn login
Kopieren Sie den bereitgestellten Code.
Melden Sie sich in einem Browser mit denselben Anmeldeinformationen wie Ihre Umgebung an. Navigieren Sie zu Microsoft-Geräteanmeldung, fügen Sie den kopierten Code ein, und wählen Sie dann Weiter aus.
Geben Sie Ihre Anmeldeinformationen ein.
Wählen Sie Fortsetzen aus.
Sie sollten eine Nachricht über die erfolgreiche Anmeldung erhalten.
Kehren Sie zur Eingabeaufforderung zurück, und führen Sie den Download-Befehl aus.

paconn download
Wenn Sie aufgefordert werden, eine Umgebung auszuwählen, geben Sie eine Nummer für die Umgebung ein, in der Sie die Lösung installiert haben, und drücken Sie dann die Eingabetaste.
Es sollte nur ein Konnektor aufgeführt werden: Contoso Invoicing-Richtlinie. Drücken Sie erneut die Eingabetaste, um diesen Konnektor auszuwählen.
Der Download sollte erfolgreich abgeschlossen werden. Notieren Sie sich den Speicherort, in den der Konnektor heruntergeladen wurde.

Aufgabe 4: apiProperties.json zum Hinzufügen der Eigenschaft „Host URL“ bearbeiten

In dieser Aufgabe bearbeiten Sie die Datei „apiProperties.json“, um die Eigenschaft hostUrl zu konfigurieren. Wenn die Eigenschaft konfiguriert ist, werden Benutzer, die eine Verbindung erstellen, zusammen mit dem API-Schlüssel zur Eingabe dieses Werts aufgefordert.

Navigieren Sie zu dem Ordner, den Sie in der vorherigen Aufgabe heruntergeladen haben, und öffnen Sie die Datei apiProperties.json.

Fügen Sie JSON in ConnectionParameters vor der Eigenschaft api_key ein.

"hostUrl": {
        "type": "string",
        "uiDefinition": {
          "constraints": {
            "required": "true"
          },
          "description": "Specify your API Url e.g. https://test.contoso.com",
          "displayName": "API URL",
          "tooltip": "Specify your API Url e.g. https://test.contoso.com"
        }
      },

Speichern Sie Ihre Änderungen.
Wechseln Sie zur Befehls-Eingabeaufforderung, und ändern Sie das Verzeichnis in den Ordner, den Sie heruntergeladen haben.
Führen Sie den Befehl update aus.

paconn update --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png
Wählen Sie die richtige Umgebung aus, in der Sie die Lösung installiert haben.
Wählen Sie den Konnektor Contoso Invoicing – Richtlinie aus.

Das Update sollte erfolgreich abgeschlossen werden.

Aufgabe 5: Die Richtlinie für den Hostnamen hinzufügen

In dieser Aufgabe konfigurieren Sie die Richtlinienvorlage Hostnamen festlegen, um die in der vorherigen Aufgabe konfigurierte Verbindungseigenschaft zu verwenden.

Navigieren Sie zum Power Apps-Entwicklerportal, und stellen Sie sicher, dass Sie die richtige Umgebung ausgewählt haben.
Wählen Sie Lösungen aus, und öffnen Sie dann die Lösung Contoso Invoicing – Richtlinienvorlagen, die Sie importiert haben.
Wählen Sie den benutzerdefinierten Konnektor Contoso Invoicing – Richtlinie und dann Bearbeiten aus.
Wählen Sie die Registerkarte Definition aus.
Scrollen Sie nach unten zum Abschnitt Richtlinien, und wählen Sie dann + Neue Richtlinie aus.
Geben Sie Host-URL-Richtlinie für Name ein, und wählen Sie dann Host-URL festlegen für Vorlage aus.
Geben Sie @connectionParameters('hostUrl') für URL-Vorlage ein, und wählen Sie dann Konnektor aktualisieren aus.

Der Konnektor sollte erfolgreich aktualisiert werden.
Navigieren Sie nicht von dieser Seite weg.

Aufgabe 6: Testen

In dieser Aufgabe erstellen Sie mithilfe der neuen Konfiguration eine Verbindung und testen diese anschließend.

Öffnen Sie ein neues Browserfenster, und gehen Sie dann zu Contoso Invoicing.
Wählen Sie den Link API-Schlüssel aus.
Kopieren Sie den API-Schlüssel.
Kehren Sie zum Konnektor zurück.
Wählen Sie die Registerkarte Testen aus.
Wählen Sie + Neue Verbindung aus.
Geben Sie https://contosoinvoicingtest.azurewebsites.net/ für API-URL ein, fügen Sie den kopierten API-Schlüssel ein, und wählen Sie dann Verbindung erstellen aus.
Wählen Sie Verbindungen aktualisieren aus.
Wählen Sie ListInvoice > Vorgang testen aus.

Der Test sollte Rechnungen zurückgeben.

Weiter