--- 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) 所要時間：5分 動的テンプレート入力のレコードフィールド値を収集するデータ収集アクションを作成します。 ## 始める前に * 必要なロール：action_designer または admin * REST エンドポイントの認証情報と接続を作成する {#create-data-gathering-action-dynamic-template__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 ステップにテーブル名または動的 URL パスを提供するための入力を作成する必要があります。 たとえば、テーブル名を格納する文字列入力を作成するなどです。手順については、「[フィールド名を取得するためのデータ収集アクションの作成](https://servicenow-prod.fluidtopics.net/fwAbNd4fptruI_WSO2nV4w#create-data-gathering-action-to-get-field-names "テーブルからフィールドのリストを取得するデータ収集アクションを作成します。")」を参照してください。 5. \[アクションアウトライン\] の \[入力\] の下で、\[新しいステップを追加\] アイコン (![\[新しいステップを追加\] アイコン]()) を選択し、\[REST\] ステップを選択します。 1. \[接続の詳細\] から、接続エイリアスを選択するか、接続をインラインで定義します。 接続エイリアスを選択すると、アクションを編集せずに接続の詳細を更新できます。 たとえば、ローカルインスタンスへの接続エイリアスを選択するなどです。 2. \[要求の詳細\] で、要求をビルドするメソッドを選択し、リソースパスを指定し、HTTP メソッドを選択して、任意のクエリパラメーターを指定します。 データ収集アクションでは、通常、GET HTTP メソッドを使用して REST エンドポイントからデータを要求します。統合ハブ で REST ステップを使用する方法の詳細については、「[REST ステップ](https://servicenow-prod.fluidtopics.net/un~5NcIHMtrqnwY~m7IPyA "送信 REST Web サービス要求を外部システムに送信します。")」および「[IntegrationHub の REST (REST in IntegrationHub)](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)」を参照してください。 {#create-data-gathering-action-dynamic-template__substeps_nck_f2q_mxb} 6. \[アクションアウトライン\] の \[REST ステップ\] で、\[新しいステップを追加\] アイコン (![\[新しいステップを追加\] アイコン]()) をクリックし、\[スクリプト\] ステップを選択します。 1. \[入力変数\] から \[変数の作成\]を選択し、REST 応答の本文を格納する入力変数を作成します。 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` プロパティ、および空の `value` プロパティが必要です。label プロパティは、テンプレート値のオプションがアクション内でどのように表示されるかを決定します。name プロパティは、テンプレート値のオプションがシステム内でどのように格納され、参照されるかを決定します。アクションの設定時に値を動的に設定できるよう、value プロパティは空になっています。 たとえば、この JSON オブジェクトは、インシデントテーブルのテンプレート値のアレイを定義します。 { "data": [ { "name": "parent", "label": "Parent", "value": "" }, { "name": "number", "label": "Number", "value": "" }, { "name": "state", "label": "State", "value": "" }, { "name": "active", "label": "Active", "value": "" }, { "name": "priority", "label": "Priority", "value": "" }, { "name": "caller_id", "label": "Caller id", "value": "" }, { "name": "short_description", "label": "Short description", "value": "" }, { "name": "description", "label": "Description", "value": "" }, { "name": "sys_id", "label": "Sys id", "value": "" }, { "name": "urgency", "label": "Urgency", "value": "" }, { "name": "assigned_to", "label": "Assigned to", "value": "" }, { "name": "severity", "label": "Severity", "value": "" }, { "name": "category", "label": "Category", "value": "" } ] } 注: 動的テンプレート入力では、最大 5,000 個のフィールドテンプレート値しか表示できません。5,000 を超えるフィールドテンプレート値を返す JSON オブジェクトは、レンダリング時に切り捨てられます。 出力オブジェクトを設定する : 動的テンプレートの JSON オブジェクトを返すように出力オブジェクトを設定します。 4. \[出力変数\] から \[変数の作成\] を選択します。 この出力変数には、スクリプトが作成するテンプレート値が保存されます。 5. 出力変数タイプには、\[JSON\] を選択します。 スクリプト出力変数タイプは JSON である必要があります。 {#create-data-gathering-action-dynamic-template__substeps_ymx_zp3_mxb} 7. \[アクションアウトライン\] で、\[出力\] を選択します。 1. \[出力の作成\] を選択します。 2. 出力のラベルと名前に「output」を設定します。 3. 出力タイプを「JSON」に設定します。 注: アクションには複数の出力を含めることができますが、含めることができる JSON タイプは 1 つのみです。 4. \[編集モードを終了\] を選択します。 5. \[値\] フィールドの横にあるデータピルピッカー (![データピルピッカー]()) を選択し、テンプレート値を格納するために作成したスクリプトステップの出力変数を選択します。 {#create-data-gathering-action-dynamic-template__substeps_dd5_yw3_mxb} 8. \[保存\] をクリックし、[アクションをテスト](https://servicenow-prod.fluidtopics.net/ml3DNlm7PNi~Eo68_M4AhA "他のユーザーに公開する前に、アクションをテストします。")します。 実行の詳細で、`[出力]` のランタイム値に `data` プロパティが適切な形式で含まれている場合、データ収集アクションは正常に実行されます。 9. \[公開\] をクリックし、同じアプリケーションスコープ内の他のフローやアクションでアクションを使用できるようにします。 {#create-data-gathering-action-dynamic-template__steps_bfz_nlf_mjb} ## タスクの結果 データ収集アクションを使用して、親アクションの動的テンプレート入力に表示されるオプションを設定できるようになりました。 **関連タスク** * [動的入力を開始するには](https://servicenow-prod.fluidtopics.net/fwAbNd4fptruI_WSO2nV4w#getting-started-dynamic-input "フローで使用可能なすべてのタイプの動的入力を使用する方法を示すアクションのサンプルを作成します。") * [動的選択肢のデータ収集アクションの作成](https://servicenow-prod.fluidtopics.net/GUK9PJjCPiBM2yg3xVwoeA "動的選択肢入力の選択オプションのリストを生成するデータ収集アクションを作成します。") * [動的入力タイプの入力のためのデータ収集アクションの作成](https://servicenow-prod.fluidtopics.net/e38WSeth8yA~f7BWtJE7QQ "動的入力タイプの入力を使用して任意のアクション入力を作成するためのデータ収集アクションを作成します。") **関連資料** * [動的入力構成オプション](https://servicenow-prod.fluidtopics.net/Ozfy71wWNvJlwYCFhQbQ5A "ここで説明するオプションを使用して動的入力を構成します。")