動的オブジェクトのデータ収集アクションの作成

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

    • 出力値を収集するアクションを作成します。次に、値を動的オブジェクトとして親アクションに渡します。

    始める前に

    必要なロール：action_designer または admin
    注:
    動的出力はベースシステムでは使用できません。ワークフロースタジオ で動的出力を使用するには、次のことを行う必要があります。 の要求 統合ハブ プラグイン.

    このタスクについて

    これらのステップにより、動的出力の汎用データ収集アクションを作成できます。動的出力のデータ収集アクションの実例については、「動的出力を開始するには」を参照してください。

    手順

    1. 次のように移動する。 All (すべて) > プロセス自動化 > Workflow Studio (ワークフロースタジオ).
    2. ホームページで、 [アクション] を選択します。
    3. 選択 新規 > 新しいアクション.
    4. [名前] フィールドにアクションの名前を入力し、適切な [アプリケーション] スコープを選択して、[送信] を選択します。
    5. [アクションアウトライン] で、[入力] の下にある新しいステップを追加アイコン (新しいステップを追加アイコン) を選択し、[REST] ステップを選択します。
      HTTP メソッドの GET に適用可能な任意のクエリパラメーターを使用して、適切なベース URL とリソースパスからデータを取得する REST ステップを設定します。統合ハブ で REST ステップを使用する方法の詳細については、「REST ステップ」および「統合ハブの REST」を参照してください。
    6. [アクションアウトライン] で、REST ステップの下にある新しいステップの追加アイコン (新しいステップの追加アイコン) を選択し、[スクリプト] ステップを選択します。
      このスクリプトステップでは、REST ステップの応答本文を親アクションに対する動的オブジェクト出力のスキーマを定義する形式に変換する必要があります。スクリプトステップは次の条件を満たしている必要があります。
      • JSON 出力変数を 1 つ含めること。スクリプトステップには他の出力変数を含めることができるが、含めることができる JSON タイプは 1 つのみである。
      • data という名前のプロパティが含まれるように JSON 出力変数を書式設定すること。複合オブジェクト出力の場合、data プロパティは次の例のような形式である必要がある。
        {
       data: {
           type: "object",              
           //Required

           children: [                  
           //Required - This is a collection of field definitions

               {
                   name: "Name 1",      
                   //Required - Unique name

                   label: "Label 1",    
                   //Required - Display name

                   type: "string"       
                   //Required - Supported field type (See the Note below)

               },

               {
                   name: "Name 2",
                   label: "Label 2",
                   type: "string"
               }
           ]
       }
   }
        複合オブジェクトアレイ出力の場合、data プロパティは次の例のような形式である必要がある。
        {
       data: {
           type: "object",                          
           //Required

           attributes: { child_type: "object" }     
           //Required - Indicates that the array's children are of type object

           children: [                              
           //Required - This is a collection of field definitions

               {
                   name: "Name 1",                  
                   //Required - Unique name

                   label: "Label 1",                
                   //Required - Display name

                   type: "string"                   
                   //Required - Supported field type (See the Note below)
               },

               {
                   name: "Name 2",
                   label: "Label 2",
                   type: "string"
               }
           ]
       }
   }
        注:
        type プロパティでサポートされているアクションデータタイプは次のとおりです。
        • 文字列
        • 整数
        • 日付と時刻
        • 選択
        • ブール
        • オブジェクト
        • array.string
        • array.integer
        • array.datetime
        • array.choice
        • array.boolean
        • array.object
    7. [アクションアウトライン] で、[出力] を選択します。
      1. タイプが [動的出力] の出力を作成します。
        注:
        データタイプのオプションとして [動的出力] が表示されない場合は、 統合ハブ サブスクリプションがありません。
      2. [動的オプション] の [アクション] オプションでデータ収集アクションを選択します。
        動的出力データ収集アクションの例については、「動的出力を開始するには」を参照してください。
      3. オプション: 必要に応じて、[他の入力に応じて (Depends On Another input)] オプションを設定し、入力を選択します。
      動的オブジェクトタイプの出力を作成します。
    8. [保存] を選択し、アクションをテストします。
      実行の詳細で、[出力] のランタイム値に data プロパティが適切な形式で含まれている場合、データ収集アクションは正常に実行されます。
    9. [公開] を選択し、同じアプリケーションスコープ内の他のフローやアクションでアクションを使用できるようにします。

      データ収集アクションを使用して動的オブジェクトに対するスキーマ値を設定します。

      データ収集アクションを使用して、親アクションの動的オブジェクトに対するスキーマ値を設定できるようになりました。