---
sourceDocument: Yokohama ビルドのワークフロー
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/build-workflows

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama ビルドのワークフロー

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

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

# 動的選択肢のデータ収集アクションの作成 {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

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

## 始める前に

* 必要なロール：action_designer または admin
* REST エンドポイントの認証情報と接続を作成する

{#create-data-gathering-action-dynamic-choice__ul_bzg_l2q_mxb}  
注:  
動的入力はベースシステムでは使用できません。ワークフロースタジオ で動的入力を使用するには、次のことを行う必要があります [要求 統合ハブ プラグイン](https://www.servicenow.com/docs/access?context=request-integrationhub&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).

## 手順

1. 移動先 すべてプロセスの自動化フローデザイナー.
2. 選択 新規作成アクション.
3. \[名前\] フィールドにアクションの名前を入力し、適切な \[アプリケーション\] スコープを選択して、\[送信\] を選択します。
4. \[アクションアウトライン\] で、\[入力\] の下にある \[新しいステップを追加\] アイコン (![\[新しいステップを追加\] アイコン]()) を選択し、\[REST\] ステップを選択します。  
   HTTP メソッドの <kbd class="ph userinput">GET</kbd> に適用可能な任意のクエリパラメーターを使用して、適切なベース URL とリソースパスからデータを取得する REST ステップを設定します。統合ハブ で REST ステップを使用する方法の詳細については、「[REST ステップ](https://servicenow-prod.fluidtopics.net/un~5NcIHMtrqnwY~m7IPyA "送信 REST Web サービス要求を外部システムに送信します。")」および「[統合ハブの REST](https://developer.servicenow.com/app.do#!/training/article/app_store_learnv2_rest_paris_rest_in_integrationhub/app_store_learnv2_rest_paris_rest_in_integrationhub_objectives?v=paris)」を参照してください。
5. \[アクションアウトライン\] の \[REST ステップ\] で、\[新しいステップを追加\] アイコン (![\[新しいステップを追加\] アイコン]()) をクリックし、\[スクリプト\] ステップを選択します。
   1. \[入力変数\] から \[変数の作成\] を選択します。  
      この入力変数には REST 応答の本文が格納されます。  
      たとえば、入力変数 \[名前\] には「<kbd class="ph userinput">payload</kbd>」と入力します。
   2. 入力変数 \[値\] で、REST ステップの応答の本文の出力のデータピルを選択します。
   3. \[スクリプト\] に、入力変数から JSON 出力を作成するスクリプトを入力します。  
      入力するスクリプトでは、次のタスクを実行する必要があります。

      入力変数を JSON として解析する
      :   [JSON - Global](https://www.servicenow.com/docs/access?context=c_JSONAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US) 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 である必要があります。
   {#create-data-gathering-action-dynamic-choice__substeps_ymx_zp3_mxb}
6. \[アクションアウトライン\] で、\[出力\] を選択します。
   1. \[出力の作成\] を選択します。
   2. 出力のラベルと名前に「<kbd class="ph userinput">output</kbd>」を設定します。
   3. 出力タイプを「JSON」に設定します。  
      注:  
      アクションには複数の出力を含めることができますが、含めることができる JSON タイプは 1 つのみです。
   4. \[編集モードを終了\] を選択します。
   5. \[値\] フィールドの横にあるデータピルピッカー (![データピルピッカー]()) を選択し、選択リストのオプションを格納するために作成した \[スクリプトステップ\] の出力変数を選択します。
   {#create-data-gathering-action-dynamic-choice__substeps_dd5_yw3_mxb}
7. \[保存\] を選択し、[アクションをテスト](https://servicenow-prod.fluidtopics.net/ml3DNlm7PNi~Eo68_M4AhA "他のユーザーに公開する前に、アクションをテストします。")します。  
   `出力`のランタイム値は、`data` プロパティと選択リストオプションのアレイを持つ JSON オブジェクトである必要があります。  
8. \[公開\] を選択し、同じアプリケーションスコープ内の他のフローやアクションでアクションを使用できるようにします。
{#create-data-gathering-action-dynamic-choice__steps_bfz_nlf_mjb}

## タスクの結果

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

* [動的入力を開始するには](https://servicenow-prod.fluidtopics.net/fwAbNd4fptruI_WSO2nV4w#getting-started-dynamic-input "フローで使用可能なすべてのタイプの動的入力を使用する方法を示すアクションのサンプルを作成します。")
* [動的テンプレートのデータ収集アクションの作成](https://servicenow-prod.fluidtopics.net/Zbzss6LOZnv~JmLXyA1mMQ "動的テンプレート入力のレコードフィールド値を収集するデータ収集アクションを作成します。")
* [動的入力タイプの入力のためのデータ収集アクションの作成](https://servicenow-prod.fluidtopics.net/e38WSeth8yA~f7BWtJE7QQ "動的入力タイプの入力を使用して任意のアクション入力を作成するためのデータ収集アクションを作成します。")  
**関連資料**   

* [動的入力構成オプション](https://servicenow-prod.fluidtopics.net/Ozfy71wWNvJlwYCFhQbQ5A "ここで説明するオプションを使用して動的入力を構成します。")