Verwenden Sie die Fail-Aktivität, damit die Pipelineausführung mit einer angepassten Fehlermeldung und einem Fehlercode fehlschlägt.

Sie sollten von Zeit zu Zeit gelegentlich einen Fehler in einer Pipeline auslösen. Eine Lookup-Aktivität gibt möglicherweise keine übereinstimmenden Daten zurück, oder eine Skript-Aktivität beendet möglicherweise mit einem internen Fehler. Unabhängig vom Grund können Sie die Fail-Aktivität jetzt in einer Pipeline verwenden und sowohl deren Fehlermeldung als auch dessen Fehlercode anpassen.

Voraussetzungen

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

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

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

Erstellen der Aktivität

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suchen Sie im Bereich Aktivitäten in der Pipeline nach der Fail-Aktivität, und wählen Sie diese Option aus, um sie dem Pipelinecanvas hinzuzufügen. Je nach Breite des Fensters Ihres Browsers kann es erforderlich sein, die Aktivitätenliste ganz rechts im Fenster zu erweitern oder das Outlook-Symbol ohne den darunter befindlichen Beschriftungstext zu komprimieren, wie in diesem Bild gezeigt.

    Screenshot of the Fabric UI with the Activities pane and Fail activity highlighted.

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

    Screenshot showing the General settings tab of the Fail activity.

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

Einstellungen der Fail-Aktivität

Wählen Sie die Registerkarte Einstellungen aus, und geben Sie einen benutzerdefinierten Fehlermeldungs- und Fehlercode an, den die Pipeline melden soll, wenn die Aktivität aufgerufen wird.

Screenshot showing the Fail activity Settings tab, and highlighting the tab.

Speichern und Ausführen oder Planen der Pipeline

Die Fail-Aktivität kann in der Regel mit anderen Aktivitäten verwendet werden. Nachdem Sie alle anderen Aktivitäten konfiguriert haben, die für Ihre Pipeline erforderlich sind, wechseln Sie oben im Pipeline-Editor zur Registerkarte Start, und klicken Sie auf die Schaltfläche „Speichern“, um die Pipeline zu speichern. Wählen Sie Ausführen aus, um sie direkt auszuführen, oder Planen, um sie zu planen. Sie können hier auch den Ausführungsverlauf anzeigen oder andere Einstellungen konfigurieren.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.

Überwachen von Pipelineausführungen