Freigeben über


Verwenden der WebHook-Aktivität zum Aufrufen eines Endpunkts und Warten auf den Abschluss des Endpunkts

Eine Webhook-Aktivität kann die Ausführung von Pipelines über benutzerdefinierten Code steuern. Mithilfe der Webhook-Aktivität kann Code einen Endpunkt aufrufen und eine Rückruf-URL an ihn übergeben. Die Pipelineausführung wartet, bis der Rückruf aufgerufen wurde, bevor sie mit der nächsten Aktivität fortfährt.

Voraussetzungen

Um zu beginnen, müssen die folgenden Voraussetzungen erfüllt sein:

Hinzufügen einer Webhook-Aktivität zu einer Pipeline über die Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine Webhookaktivität in einer Pipeline zu verwenden:

Erstellen der Aktivität

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suchen Sie im Bereich mit den Pipelineaktivitäten nach „Webhook“, und fügen Sie es der Pipelinecanvas diese Aktivität hinzu.

    Hinweis

    Sofern Ihr Bildschirm keine sehr hohe Auflösung aufweist, müssen Sie wahrscheinlich die Liste der Aktivitäten über die Symbolleiste mithilfe der Auslassungspunkte ... erweitern, um die WebHook-Aktivität zu finden.

    Screenshot: Fabric-Benutzeroberfläche mit Aktivitätenbereich und hervorgehobener WebHook-Aktivität.

  3. Wählen Sie die neue Webhook-Aktivität im Canvas aus, wenn sie noch nicht ausgewählt ist.

    Screenshot: Registerkarte „Allgemeine Einstellungen“ der WebHook-Aktivität.

Informationen zum Konfigurieren der Registerkarte Allgemein finden Sie unter Allgemeine Einstellungen.

WebHook-Aktivitätseinstellungen

  1. Wählen Sie die Registerkarte Einstellungen oder eine vorhandene Verbindung in der Dropdownliste Verbindung aus, oder erstellen Sie eine neue Verbindung und geben Sie ihre Konfigurationsdetails an.

    Screenshot: Hervorhebung der Registerkarte „Einstellungen für WebHook-Aktivitäten“ und Festlegen einer neuen Verbindung.

  2. Wenn Sie eine neue Verbindung erstellen, wird das Dialogfeld zum Erstellen der Verbindung angezeigt, in dem Sie die Basis-URL und Anmeldeinformationen für die Verbindung angeben können.

    Screenshot des Dialogfelds „Neue Verbindung“ für die WebHook-Aktivität.

Verwendung von On-Premises- oder virtuellen Netzwerkdaten-Gateways

  1. Beim Erstellen der Verbindung können Sie jetzt entweder ein lokales Datengateway (OPDG) oder ein virtuelles Netzwerkdatengateway verwenden. Anleitungen zum Erstellen und Konfigurieren Ihres OPDG finden Sie unter Erstellen eines lokalen Datengateways.

  2. Wenn Sie ein virtuelles Netzwerkgateway verwenden möchten, erfahren Sie , wie Sie ein Virtuelles Netzwerkdatengateway erstellen.

  3. Nachdem Sie Ihr Gateway erfolgreich erstellt und konfiguriert haben, sollte es im Verbindungsdialogfeld unter der Dropdownliste "Datengateway" angezeigt werden.

    Screenshot des Dialogfelds

  4. Nachdem Sie Ihre Verbindung ausgewählt oder erstellt haben, schließen Sie die verbleibenden erforderlichen Felder ab, fügen Sie alle erforderlichen Kopfzeilen hinzu, oder legen Sie erweiterte Einstellungen fest. Die Webhook-Aktivität unterstützt nur die POST-Methode.

  5. Verwenden Sie die Ausgabe aus der Aktivität als Eingabe für jede andere Aktivität, und verweisen Sie überall dort auf die Ausgabe, wo dynamischer Inhalt in der Zielaktivität unterstützt wird.

Speichern und Ausführen oder Planen der Pipeline

In der Regel verwenden Sie die Ausgabe der Webhook-Aktivität mit anderen Aktivitäten, aber nach der Konfiguration kann sie auch ohne andere Aktivitäten direkt ausgeführt werden. Wenn Sie sie ausführen, um eine REST-API aufzurufen, die eine Aktion ausführt und keine Ausgabe der Aktivität erfordert, enthält Ihre Pipeline möglicherweise auch nur die Webaktivität.

Wechseln Sie oben im Pipeline-Editor zur Registerkarte " Start ", und wählen Sie die Schaltfläche "Speichern" aus, um Ihre Pipeline zu speichern. Wählen Sie "Ausführen" aus, um sie direkt auszuführen, oder planen Sie die Ausführung zu bestimmten Zeiten oder Intervallen. Weitere Informationen zu Pipelineausführungen finden Sie unter: Pipelineausführungen planen.

Screenshot: Die Registerkarte „Start“ im Pipeline-Editor mit den hervorgehobenen Schaltflächen „Name“, „Speichern“, „Ausführen“ und „Planen“ der Registerkarte.

Nach dem Ausführen können Sie die Ausführung der Pipeline überwachen und den Ausführungsverlauf über die Registerkarte Ausgabe unterhalb des Zeichenbereichs anzeigen.