エラーをスローするカスタムアクションの作成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:2分
  • 意図的にエラーをスローするアクションを作成し、フローエラー処理をテストします。

    始める前に

    必要なロール:flow_designer、action_designer、 または admin

    このタスクについて

    このカスタムアクションは、アクションの入力値が 1 に設定されている場合にエラーをスローします。入力値がその他の値の場合、エラーをスローせずにアクションを実行できます。このカスタムアクションをフローに追加して、フローエラー処理をテストできます。

    手順

    1. 移動先 すべて > プロセス自動化 > フローデザイナー.
      ワークフロースタジオ のランディングページが表示されます。
    2. 選択 新規 > アクション
      [アクションプロパティ] ダイアログが表示されます。
    3. 次のサンプル値を入力します。
      フィールド
      名前 エラーをスロー
      アプリケーション グローバル
      アクセス可能 すべてのアプリケーションスコープ
    4. [送信] を選択します。
      ワークフロースタジオ インターフェイスが表示されます。
    5. [アクションアウトライン] から、 入力 > 入力の作成
      新しいアクション入力が表示されます。
    6. 次の値を使用してアクション入力を構成します。
      フィールド
      ラベル エラーコード
      タイプ 整数
      必須 True
    7. [アクションアウトライン] から [新しいステップを追加] を選択します。
      利用可能なステップのリストが表示されます。
    8. [スクリプトステップ] を選択します。
    9. [入力変数] セクションから [変数の作成] を選択します。
    10. 次の値を使用して変数を構成します。
      フィールド
      名前 コード
      データピル [アクション -> エラーコード] を選択します
    11. [スクリプト] にこの JavaScript コードを入力します。
      (function execute(inputs, outputs) {
        if (inputs.code == 1) {
            throw 'My custom error message'
            }
      })(inputs, outputs);
    12. [保存] をクリックします。
      エラーをスローするサンプルアクションのアクションアウトラインおよび構成。
    13. [テスト] を選択します。
      [アクションのテスト] ダイアログが表示されます。
    14. 次のテスト値を入力します。
      入力
      エラーコード 1
    15. [テストを実行] を選択します。
      指定されたテスト値を使用してアクションが実行されます。
    16. 次を選択します:テストの実行が終了しました。(Your test has finished running.) アクションの実行の詳細を表示します。
      アクション実行の詳細が表示されます。
    17. アクションがスクリプトステップを実行し、カスタムエラーメッセージをスローしたことを確認します。
      [アクションステータス] オブジェクトにより、3 行目にエラーがリストされ、カスタムエラーメッセージのテキストが表示されます。

      「エラーをスロー」テスト実行のアクション実行の詳細。

    18. アクション実行の詳細を閉じます。
    19. アクションのテストを停止するには、[キャンセル] を選択します。
    20. [公開] を選択して、カスタムアクションをフローで使用できるようにします。

    タスクの結果

    アクション入力 [エラーコード] を 1 に設定するとエラーをスローするカスタムアクションが作成されました。

    次のタスク

    このアクションをフローに追加して、[エラーハンドラー] セクションのコンテンツをテストします。