次の方法で共有


Fail アクティビティを使用して、カスタマイズされたエラー メッセージとエラー コードを使用してパイプラインの実行を失敗させる

パイプラインで意図的にエラーをスローしたい場合があります。 参照アクティビティ が一致するデータを返さない場合や、スクリプト アクティビティの が内部エラーで終了する可能性があります。 理由が何であれ、パイプラインで Fail アクティビティを使用し、エラー メッセージとエラー コードの両方をカスタマイズできるようになりました。

前提 条件

開始するには、次の前提条件を満たす必要があります。

  • アクティブなサブスクリプションを持つテナント アカウント。 無料用のアカウントを作成します。
  • ワークスペースが作成されます。

UI を使用してパイプラインに失敗アクティビティを追加する

パイプラインで失敗アクティビティを使用するには、次の手順を実行します。

アクティビティの作成

  1. ワークスペースに新しいパイプラインを作成します。

  2. パイプライン アクティビティ ペインで失敗アクティビティを検索し、それを選択してパイプライン キャンバスに追加します。 ウィンドウの右端にあるアクティビティ リストを展開する必要がある場合や、ブラウザーのウィンドウ幅に応じて、この画像に示すように、Outlook アイコンの下にテキストのラベルを付けずに圧縮できます。

    [アクティビティ] ウィンドウと [失敗] アクティビティが強調表示されている Fabric UI のスクリーンショット。

  3. まだ選択していない場合は、キャンバスで新しい Fail アクティビティを選択します。

    失敗アクティビティの [全般設定] タブを示すスクリーンショット。

全般 設定 ガイダンスを参照して、全般 設定タブを構成します。

Fail アクティビティの設定

[設定] タブを選択し、アクティビティの呼び出し時にパイプラインで報告するカスタム エラー メッセージとエラー コードを指定します。

[失敗アクティビティの設定] タブを示すスクリーンショット。タブが強調表示されています。

パイプラインを保存して実行またはスケジュールする

通常、Fail アクティビティは他のアクティビティと共に使用されます。 パイプラインに必要なその他のアクティビティを構成したら、パイプライン エディターの上部にある [ホーム] タブに切り替え、保存ボタンを選択してパイプラインを保存します。 [実行] を選択して直接実行するか、[スケジュール] を選択してスケジュールを設定します。 ここで実行履歴を表示したり、他の設定を構成したりすることもできます。

タブ名、[保存]、[実行]、[スケジュール] ボタンが強調表示されているパイプライン エディターの [ホーム] タブを示すスクリーンショット。

パイプラインの実行を監視する方法