Einen benutzerdefinierten Connector in einem Logik-App-Workflow verwenden

In diesem Artikel erstellen Sie ein Beispiel für einen Workflow für eine Verbrauchslogik-App, der zeigt, wie der benutzerdefinierte Konnektor verwendet wird, den Sie in einem vorherigen Tutorial erstellt haben. Dieser Beispielworkflow wird ausgelöst, wenn ein Element zu einer SharePoint Online-Liste hinzugefügt wird. Der Workflow verwendet den benutzerdefinierten Connector, um die API Cognitive Services-Textanalyse aufzurufen. Der Connector gibt die Stimmungsbewertung (0 bis 1) für den Text im Listenelement zurück, und der Workflow schreibt die Bewertung zurück in die Liste.

Das folgende Beispiel zeigt den fertigen Logik-App-Workflow:

Anforderungen

• Ein Office 365 Business Premium-Abonnement oder melden Sie sich für eine kostenlose Testversion an.

• Ein Azure Konto und ein Abonnement.

• Grundlegende Erfahrung im Aufbau von Logik-Apps. Weitere Informationen finden Sie unter Erstellen Sie Ihren ersten Workflow für Logik-Apps.

• Der benutzerdefinierte Connector, den Sie in einem dieser Artikel erstellt haben:

  • Einen benutzerdefinierten Connector auf der Grundlage einer OpenAPI-Definition erstellen
  • Erstellen eines benutzerdefinierten Connectors auf der Grundlage einer Postman-Sammlung

• (Wenn Ihr benutzerdefinierter Connector mithilfe des lokalen Datengateways auf lokale Ressourcen zugreift) Richten Sie die Gateway-Installation so ein, dass ein ausgehender Zugriff für die entsprechenden sofort einsatzbereiten Connectors ausgehende IP-Adressen zulässig ist. Alle Logik-Apps in derselben Region verwenden dieselben IP-Adressbereiche.

  Weitere Informationen finden Sie unter Anpassen der Kommunikationseinstellungen für das lokale Datengateway und Konfigurieren von Proxyeinstellungen für lokales Datengateway.

Die SharePoint Online-Liste erstellen

Erstellen Sie zunächst eine dreispaltige Liste in SharePoint Online. In dieser Liste werden Filmbewertungsdaten gespeichert, die vom Logik-App-Workflow auf Stimmungen analysiert werden. Weitere Informationen zu SharePoint Online-Listen finden Sie unter Einführung in Listen.

1. Wählen Sie auf Ihrer SharePoint Online-Website Neu>Liste aus, um eine neue Liste zu erstellen.

2. Geben Sie im Feld Name den Text Filmrezensionen ein

3. Wählen Sie Erstellen aus.

   Standardmäßig erstellt SharePoint Online die Liste mit einer Spalte Titel.

4. Wählen Sie das Pluszeichen >Einzelne Textzeile.

5. Geben Sie den Namen Rezension ein und wählen Sie Speichern aus.

6. Um eine andere Spalte mit dem Datentyp Nummer und dem Namen Bewertung hinzuzufügen, wiederholen Sie die Schritte 3 und 4.

Eine Logik-App-Ressource erstellen

Nun, da Sie eine Liste haben, erstellen Sie eine Verbrauchs-Logik-App-Ressource und einen Workflow im Azure-Portal.

1. Melden Sie sich beim Azure-Portal mit Ihren Azure-Kontoanmeldeinformationen an.

2. Geben Sie im Suchfeld des Portals Logik-App ein und wählen Sie dann Logik-Apps aus.

3. Wählen Sie den Plan Verbrauch aus.

4. Geben Sie für Ihre Logik-App-Ressource die folgenden Informationen ein:

   Eigenschaften	Wert	Beschreibung
   Abonnement	<Azure-Abonnement-Name>	Der Name für Ihr Azure-Abonnement.
   Ressourcengruppe	<Ressourcengruppenname>	Der Name für die Azure-Ressourcengruppe, die zum Organisieren verwandter Ressourcen verwendet wird. In diesem Beispiel wird My-First-LA-RG verwendet.
   Logik-App-Name	<logic-app-name>	Der Name für Ihre Logik-App. In diesem Beispiel wird SentimentAnalysis verwendet.
   Region	<Azure-Region>	Die Region Azure, in der Ihre Logik-App gehostet wird. Anmerkung: Ihre Logik-App-Ressource und Ihr benutzerdefinierter Connector müssen in der gleichen Region vorliegen. In diesem Beispiel wird USA, Osten 2 verwendet.
   Protokollanalyse aktivieren	Nein	Lassen Sie die Diagnoseprotokollierung deaktiviert.

5. Schließen Sie die Erstellung Ihrer Logik-App ab.

6. Nachdem Azure Ihre App bereitgestellt hat, wählen Sie Zu Ressource gehen.

   Alternativ können Sie Ihre Logik-App suchen und auswählen, indem Sie den Namen in das Azure-Suchfeld eingeben.

Trigger hinzufügen

Fügen Sie als ersten Schritt in Ihrem Workflow einen SharePoint-Trigger hinzu. Dieser Trigger wird ausgelöst, wenn ein Element zu der angegebenen SharePoint Online-Liste hinzugefügt wird.

1. Wählen Sie im Logik-App-Menü unter Entwicklungstools die Option Logik-App-Designer aus, falls dies noch nicht geschehen ist.

2. Wählen Sie im Designer Trigger hinzufügen aus.

3. Gehen Sie im Suchfeld des Connector-Katalogbereichs SharePoint und wählen Sie den SharePoint-Trigger namens Wenn ein Element erstellt wird aus. Wenn der Trigger nicht in der Liste angezeigt wird, wählen Sie in der oberen rechten Ecke der SharePoint-Triggerliste Mehr anzeigen aus.

   

4. Melden Sie sich nach dem Öffnen des Bereichs Verbindung erstellen mit Ihren SharePoint-Anmeldeinformationen an.

5. Geben Sie die folgenden Informationen für den SharePoint-Trigger ein.

   Parameter	Wert
   Standort-Adresse	<SharePoint-Websiteadresse>
   Listenname	Film-Besprechungen

6. Erweitern Sie den Abschnitt Wie oft möchten Sie nach Elementen suchen, um die Einrichtung des Triggers abzuschließen:

   Parameter	Wert
   Intervall	10
   Frequenz	Second

   Wenn Sie fertig sind, sieht der Trigger wie im folgenden Beispiel aus:

   

Eine Aktion von einem benutzerdefinierten Connector hinzufügen

Nach dem Trigger können Sie eine oder mehrere auszuführende Aktionen hinzufügen. Gehen Sie folgendermaßen vor, um eine Aktion aus Ihrem benutzerdefinierten Konnektor hinzuzufügen:

1. Wählen Sie unter dem Trigger das Pluszeichen (+) und dann Aktion hinzufügen aus.

2. Geben Sie im Suchfeld des Connector-Katalogbereichs den Namen für Ihren benutzerdefinierten Connector ein, der in diesem Beispiel SentimentDemo lautet, und wählen Sie die gewünschte Aktion aus.

   Tipp

   Um die Suche zu vereinfachen, wählen Sie unter Runtime die Option Benutzerdefiniert aus.

   

   Die Aktion und die Beschreibung stammen aus Informationen, die Sie beim Erstellen des Connectors angegeben haben.

3. Geben Sie einen Namen für die Verbindung und den API-Schlüssel ein.

   Parameter	Wert
   Verbindungsname	Ein Name für die Verbindung, zum Beispiel SentimentDemoConnection.
   API-Schlüssel	Der API-Schlüssel für die Text Analytics API. Weitere Informationen finden Sie unter Einen API-Schlüssel erhalten.

4. Geben Sie die Informationen für die Aktion an, zum Beispiel:

   Parameter	Wert
   Dokumenten-ID	1 Dieser Wert ist erforderlich, da der Konnektor mehrere Dokumente verarbeiten kann. In diesem Beispiel wird jeweils ein Dokument gesendet. In der Produktion stammen die Werte Dokumentensprache und Dokumenten-ID jedoch vielleicht aus einer Liste oder einer anderen Datenquelle.
   Dokumentensprache	en
   Dokumententext	Das SharePoint-Feld Rezension. Gehen Sie wie folgt vor, um diesen Wert einzugeben: 1. Tippen Sie in das Feld Dokumententext und wählen Sie das Blitzsymbol aus, um die dynamische Inhaltsliste zu öffnen. 2. Wählen Sie in der Liste im SharePoint-Triggerabschnitt die Option Rezension aus.

5. Fügen Sie Ihrem Workflow die SharePoint-Aktion namens Element aktualisieren hinzu und geben Sie die folgenden Werte an:

   Parameter	Wert
   Standort-Adresse	< SharePoint-Websiteadresse>
   Listenname	Film-Besprechungen
   Kennung	Das Feld SharePoint ID
   Titel	Die SharePoint-Triggerausgabe mit dem Namen Title. Gehen Sie wie folgt vor, um diesen Wert einzugeben: 1. Tippen Sie in das Feld Titel und wählen Sie das Blitzsymbol aus, um die dynamische Inhaltsliste zu öffnen. 2. Wählen Sie in der Liste im SharePoint-Triggerabschnitt die Option Titel aus.

6. Öffnen Sie im Aktionsbereich Element aktualisieren die Liste Erweiterte Parameter und wählen Sie die gewünschten Parameter aus, die je nach SharePoint Online-Liste variieren, um sie der Aktion hinzuzufügen. Öffnen Sie für jeden hinzugefügten Parameter die dynamische Inhaltsliste und wählen Sie die entsprechende Ausgabe des SharePoint-Triggers mit dem Namen Wenn ein Element erstellt wird und der benutzerdefinierten Connector-Aktion aus.

   In diesem Beispiel werden die folgenden Parameter sowie die entsprechenden Trigger- und Aktionsausgaben hinzugefügt:

   Erweiterter Parameter	Trigger- oder Aktionsausgabe
   Bewertung	Die SharePoint-Triggerausgabe mit dem Namen Rezension
   Ergebnis	Die Ausgabe der benutzerdefinierten Connector-Aktion mit dem Namen Bewertung. Wenn Sie die Triggerausgabe auswählen, die in diesem Feld verwendet werden soll, fügt der Designer automatisch eine Für jedes-Aktion hinzu, da die benutzerdefinierte Connector-Aktion mehrere Dokumente akzeptieren kann. Obwohl die benutzerdefinierte Connector-Aktion immer nur ein Dokument auf einmal sendet, entspricht der Designer den Fähigkeiten des Connectors.

   Wenn Sie fertig sind, sieht die Aktion Element aktualisieren wie im folgenden Beispiel aus:

   

7. Wenn Sie fertig sind, speichern Sie Ihren Workflow. Wählen Sie in der Symbolleiste des Designers Speichern aus.

Den Workflow testen

Um den Workflow zu testen, fügen Sie Rezensionen zu Ihrer SharePoint Online-Liste hinzu und überprüfen Sie, wie der Workflow reagiert.

1. Wählen Sie in der Symbolleiste des Designers Ausführen>Ausführen aus.

2. In Ihrer SharePoint Online-Liste wählen Sie Schnellbearbeitung.

3. Fügen Sie der Liste zwei Rezensionen hinzu (eine negative und eine positive) basierend auf den folgenden Werten und wählen Sie dann Fertig.

   Parameter	Vorgeschlagener Wert
   Titel (positiv)	Mein Lieblingsfilm
   Überprüfen (positiv)	Ich habe den neuen Film nach einem langen Tag genossen.
   Titel (negativ)	Einige andere Filme
   Überprüfen (negativ)	Der schlechteste Film, den ich seit Jahrzehnten gesehen habe.

4. Wählen Sie im Azure-Portal im Logik-App-Menü Übersicht aus, um sich den Workflow-Ausführungsverlauf anzusehen. Wählen Sie auf der Seite Übersicht die Option Ausführungsverlauf aus.

   Auf der Registerkarte Ausführungsverlauf werden zwei Workflowausführungen angezeigt, eine für jede Rezension, die Sie der Liste hinzugefügt haben.

5. Um nach Abschluss dieses Workflows den Ressourcenverbrauch niedrig zu halten, wählen Sie auf der Symbolleiste der Übersichtsseite die Option Deaktivieren aus.

6. Aktualisieren Sie, wieder auf der SharePoint Online-Listenseite, den Browser, um die Bewertungen zu sehen, die der Workflow hinzugefügt hat.

   

Herzlichen Glückwunsch! Obwohl es sich bei diesem Beispiel um einen einfachen Workflow handelt, fügt der benutzerdefinierte Konnektor leistungsstarke Funktionen mit der Funktion zum Aufrufen von Cognitive Services hinzu.

Zugehöriger Inhalt

Sie können Ihren benutzerdefinierten Connector innerhalb Ihrer Organisation freigeben oder ihn zertifizieren lassen, damit auch Personen außerhalb Ihrer Organisation ihn verwenden können.

• Ihren Connector mit anderen teilen
• Ihren Connector zertifizieren

Feedback senden

Wir freuen uns sehr über Feedback zu Problemen mit unserer Connector-Plattform oder neuen Feature-Ideen. Wenn Sie Feedback geben möchten, gehen Sie zu Probleme melden oder Hilfe zu Connectors und wählen Sie einen Feedbacktyp aus.