動的選択肢のデータ収集アクションの作成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：3分

    • 動的選択肢入力の選択オプションのリストを生成するデータ収集アクションを作成します。

    始める前に

    • 必要なロール：action_designer または admin
    • REST エンドポイントの認証情報と接続を作成する
    注:
    動的入力はベースシステムでは使用できません。ワークフロースタジオで動的入力を使用するには、次のことを行う必要があります。 の要求 統合ハブ プラグイン.

    手順

    1. 移動先 すべて > プロセス自動化 > フローデザイナー.
    2. 選択 新規作成 > アクション.
    3. [名前] フィールドにアクションの名前を入力し、適切な [アプリケーション] スコープを選択して、[送信] を選択します。
    4. [アクションアウトライン] で、[入力] の下にある [新しいステップを追加] アイコン ([新しいステップを追加] アイコン) を選択し、[REST] ステップを選択します。
      HTTP メソッドの GET に適用可能な任意のクエリパラメーターを使用して、適切なベース URL とリソースパスからデータを取得する REST ステップを設定します。統合ハブ で REST ステップを使用する方法の詳細については、「REST ステップ」および「統合ハブの REST」を参照してください。
    5. [アクションアウトライン] の [REST ステップ] で、[新しいステップを追加] アイコン ([新しいステップを追加] アイコン) をクリックし、[スクリプト] ステップを選択します。
      1. [入力変数] から [変数の作成] を選択します。
        この入力変数には REST 応答の本文が格納されます。
        たとえば、入力変数 [名前] には「payload」と入力します。
      2. 入力変数 [値] で、REST ステップの応答の本文の出力のデータピルを選択します。
      3. [スクリプト] に、入力変数から JSON 出力を作成するスクリプトを入力します。
        入力するスクリプトでは、次のタスクを実行する必要があります。
        入力変数を JSON として解析する
        JSON - Global API を使用して、入力変数を文字列から JSON オブジェクトに変換できます。
        動的選択肢用にフォーマットされた新しい JSON オブジェクトを作成する
        応答の値を選択リストのオプションにマッピングするには、REST 応答のデータ構造を把握している必要があります。スクリプトで data という名前のプロパティを持つ動的選択肢の JSON オブジェクトを作成する必要があります。data プロパティの値は、選択リストのオプションのアレイである必要があります。選択リストの各オプションには、label と name のプロパティが文字列値に設定されている必要があります。label プロパティは、選択リスト内でオプションがどのように表示されるかを決定します。name プロパティは、オプションがシステム内でどのように格納され、参照されるかを決定します。

        たとえば、次に示す JSON オブジェクトでは、3 つの選択リストオプションを持つアレイを定義します。

        {
    data: [
        {
            label: "Choice Option 1",
            name: "choice_option_1"
            
        }, 
        {
            label: "Choice Option 2",
            name: "choice_option_2"
        }, 
        {	
            label: "Choice Option 3",
            name: "choice_option_3"
        }
    ]
}
        注:
        動的選択入力では、最大 5,000 個の選択リストオプションしか表示できません。5,000 を超える選択リストオプションを返す JSON オブジェクトは、レンダリング時に切り捨てられます。
        出力オブジェクトを設定する
        動的選択肢の JSON オブジェクトを返すように出力オブジェクトを設定します。
      4. [出力変数] から [変数の作成] を選択します。
        この出力変数には、スクリプトが作成する選択リストのオプションが保存されます。
      5. 出力変数タイプには、[JSON] を選択します。
        スクリプト出力変数タイプは JSON である必要があります。
    6. [アクションアウトライン] で、[出力] を選択します。
      1. [出力の作成] を選択します。
      2. 出力のラベルと名前に「output」を設定します。
      3. 出力タイプを「JSON」に設定します。
        注:
        アクションには複数の出力を含めることができますが、含めることができる JSON タイプは 1 つのみです。
      4. [編集モードを終了] を選択します。
      5. [値] フィールドの横にあるデータピルピッカー (データピルピッカー) を選択し、選択リストのオプションを格納するために作成した [スクリプトステップ] の出力変数を選択します。
    7. [保存] を選択し、アクションをテストします。
      出力のランタイム値は、data プロパティと選択リストオプションのアレイを持つ JSON オブジェクトである必要があります。
      テストアクションの出力例
    8. [公開] を選択し、同じアプリケーションスコープ内の他のフローやアクションでアクションを使用できるようにします。

    タスクの結果

    データ収集アクションを使用して、親アクションの動的選択肢入力に表示されるオプションを設定できるようになりました。データ収集アクションを使用して動的選択肢のオプションを設定します。