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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む3読むのに数分

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

    始める前に

    必要なロール：action_designer または admin

    手順

    1. 移動先 すべて > プロセス自動化 > Flow Designer.
    2. 選択 新規 > 新しいアクション.
    3. [名前] フィールドにアクションの名前を入力し、適切な [アプリケーション] スコープを選択して、[送信] をクリックします。
    4. [アクションアウトライン] で、[入力] の下にある新しいステップの追加アイコン (新しいステップの追加アイコン) をクリックし、[REST] ステップを選択します。
      HTTP メソッドの GET に適用可能な任意のクエリパラメーターを使用して、適切なベース URL とリソースパスからデータを取得する REST ステップを設定します。統合ハブ で REST ステップを使用する方法の詳細については、「REST ステップ」および「IntegrationHub の REST (REST in IntegrationHub)」を参照してください。
    5. [アクションアウトライン] で、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
    6. [アクションアウトライン] で、[出力] をクリックします。
      タイプ JSON の output という名前の出力を作成します。次に、データピルピッカー (データピルピッカー) を使用して、スクリプトステップからの JSON 出力変数に対するデータピルをアクション出力の [値] フィールドにアサインします。
      注:
      アクションには複数の出力を含めることができますが、含めることができる JSON タイプは 1 つのみです。
    7. [保存] をクリックし、アクションをテストします。
      実行の詳細で、[出力] のランタイム値に data プロパティが適切な形式で含まれている場合、データ収集アクションは正常に実行されます。
    8. [公開] をクリックし、同じアプリケーションスコープ内の他のフローやアクションでアクションを使用できるようにします。
      データ収集アクションを使用して、親アクションの動的オブジェクトに対するスキーマ値を設定できるようになりました。データ収集アクションを使用して動的オブジェクトに対するスキーマ値を設定します。