Azure Logic Apps のワークフローでアクションを繰り返すループを追加する

適用対象: Azure Logic Apps (従量課金 + Standard)

ロジック アプリ ワークフローでアクションを繰り返すために、Azure Logic Apps では、このタスクのワークフローへのループ アクションの追加がサポートされています。

ユース ケースに基づいて、次の種類のループ アクションから選択できます。

• 配列またはコレクション内の項目に対して 1 つ以上のアクションを繰り返すには、 For each アクション をワークフローに追加します。

  または、配列を受け取るトリガーがあり、各配列項目の反復を実行する場合は、SplitOn トリガー プロパティを使用してその配列をバッチ解除できます。

• 条件が満たされるか、特定の状態が変更されるまで 1 つ以上のアクションを繰り返すには、 Until アクション をワークフローに追加します。

  ワークフローでは、まずループ内部のすべてのアクションが実行されてから、条件や状態がチェックされます。 条件が満たされると、ループが停止します。 そうでない場合は、ループが繰り返されます。 ワークフローで処理できる Until ループの回数の既定値と上限値については、「コンカレンシー、ループ、および分割処理の制限」を参照してください。

前提条件

• Azure アカウントとサブスクリプション。 サブスクリプションをお持ちでない場合には、無料の Azure アカウントにサインアップしてください。

• ロジック アプリ ワークフローに関する基本的な知識

For each

For each アクションは、配列でのみ動作し、配列内の各項目に対して 1 つ以上のアクションを繰り返します。 次の一覧には、For each アクションを使用する場合のいくつかの考慮事項が含まれています:

• For each アクションは、制限された数の配列項目を処理できます。 この制限については、「コンカレンシー、ループ、および分割処理の制限」を参照してください。

• 既定では、For each アクションのサイクルまたは反復は同時に並列で実行されます。

  この動作は、Power Automate の Apply to each ループとは異なっています。このループ内では、イテレーションは一度に 1 つずつ、つまり順番に実行されます。 ただし、For each の反復を順番に設定することもできます。 たとえば、For each アクション内の次の反復を遅延アクションを使用して一時停止するには、各反復が順番に実行されるように設定する必要があります。

  この既定の動作の例外として、入れ子になった For each アクションの反復は、常に、並列ではなく順番に実行されます。 入れ子になったループ内の項目に対して並列で操作を実行するには、子ロジック アプリ ワークフローを作成して呼び出します。

• 各反復中の変数に対する操作の予測可能な結果を取得するには、これらの反復を順番に実行します。 たとえば、同時実行の反復が終了すると、増分変数、減分変数、変数に追加操作で予測可能な結果が返されます。 ただし、同時実行ループでの各イテレーション中に、これらの操作で予期しない結果が返される可能性があります。

• For each ループのアクションは、item() 関数の式を使用して、配列内の各項目を参照して処理します。 配列にないデータを指定すると、ワークフローが失敗します。

次のワークフローの例では、Web サイト RSS フィードの日次サマリーを送信します。 ワークフローは For each アクションを使用して、新しい項目ごとにメールを送信します。

従量課金と Standard のどちらのワークフローを使用しているかに基づいて、対応する手順に従ってください。

For each アクションの定義 (JSON)

コード ビューで操作している場合、次の例のように、ワークフローの JSON 定義で For_each アクションを定義できます:

"actions": {
   "For_each": {
      "actions": {
         "Send_an_email_(V2)": {
            "type": "ApiConnection",
            "inputs": {
               "body": {
                  "Body": "@{item()}",
                  "Subject": "New CNN post @{triggerBody()?['publishDate']}",
                  "To": "me@contoso.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/v2/Mail"
            },
            "runAfter": {}
         }
      },
      "foreach": "@triggerBody()?['links']",
      "runAfter": {},
      "type": "Foreach"
   }
},

For each: 順番に実行する

既定では、For each ループの反復は同時に並列で実行されます。 ただし、予測可能な結果が予想されるループ内に入れ子になったループまたは変数がある場合は、それらのループを一度に 1 つずつ、または順番に実行する必要があります。

For each アクションの定義 (JSON): 順番に実行する

ワークフローの JSON 定義で For_each アクションにコード ビューを使用している場合、operationOptions パラメータを追加することにより Sequential オプションを使用できます。たとえば次のようになります:

"actions": {
   "For_each": {
      "actions": {
         "Send_an_email_(V2)": { }
      },
      "foreach": "@triggerBody()?['links']",
      "runAfter": {},
      "type": "Foreach",
      "operationOptions": "Sequential"
   }
}

Until

Until アクションは、必要な指定された条件が満たされるまで、1 つ以上のアクションを実行して繰り返します。 条件が満たされると、ループが停止します。 そうでない場合は、ループが繰り返されます。 ワークフローで処理できる Until アクションの回数の既定値と上限値については、「コンカレンシー、ループ、およびデバッチの制限」を参照してください。

次の一覧には、Until アクションを使用できる一般的なシナリオがいくつか含まれています:

• 必要なレスポンスを受け取るまでエンドポイントを呼び出す。

• データベース内にレコードを作成する。 そのレコード内の特定のフィールドが承認されるまで待機します。 処理し続けます。

既定では、 Until ループは次の方法で成功または失敗します。

• Until ループは、ループ内のすべてのアクションが成功した場合、および動作後の実行に基づいてループの制限に達した場合に成功します。

• Until ループの最後のイテレーションのすべてのアクションが成功した場合、Until ループ全体が成功としてマークされます。

• Until ループの最後のイテレーションで何らかのアクションが失敗した場合、Until ループ全体が Failed としてマークされます。

• 最後のイテレーション以外のイテレーションで何らかのアクションが失敗した場合、次のイテレーションは引き続き実行され、 Until ループ全体は 失敗としてマークされません。

  代わりにループを失敗させるために、 operationOptionsという名前のパラメーターを追加し、値を FailWhenLimitsReached に設定することで、ループの JSON 定義の既定の動作を変更できます。次に例を示します。

  "Until": {
     "actions": {
       "Execute_stored_procedure": {
         <...>
         }
       },
       "expression": "@equals(variables('myUntilStop'), true)",
       "limit": {
         "count": 5,
         "timeout": "PT1H"
       },
       "operationOptions": "FailWhenLimitsReached",
       "runAfter": {
       "Initialize_variable_8": [
         "Succeeded"
       ]
     },
  "type": "Until"
  }
  

次のワークフローの例では、毎日午前 8:00 時から、Until アクションが変数の値が 10 になるまで変数を増分させます。 その後、このワークフローは現在の値を確認する電子メールを送信します。 この例では Office 365 Outlook を使用していますが、 Azure Logic Apps でサポートされている任意の電子メール プロバイダーを使用できます。 別の電子メール アカウントを使用する場合、おおよその手順は変わりませんが、UI の表示がやや異なることがあります。

ワークフローをテストする

ロジック アプリ ワークフローを手動でテストするには、従量課金ロジック アプリ ワークフローと Standard ロジック アプリ ワークフローのどちらを使用しているかに応じて、手順に従います。

ワークフローの実行が開始された後に、指定した内容のメールを受け取ります:

無限ループを防ぐ

Until アクションは、次のプロパティに基づいて実行を停止します。このプロパティは、アクションで [制限の変更] を選んで表示できます。 これらのプロパティ値は、適宜設定してください:

"Until" 定義 (JSON)

コード ビューで操作している場合、次の例のように、ワークフローの JSON 定義で Until アクションを定義できます:

"actions": {
   "Initialize_variable": {
      // Definition for initialize variable action
   },
   "Send_an_email": {
      // Definition for send email action
   },
   "Until": {
      "type": "Until",
      "actions": {
         "Increment_variable": {
            "type": "IncrementVariable",
            "inputs": {
               "name": "Limit",
               "value": 1
            },
            "runAfter": {}
         }
      },
      "expression": "@equals(variables('Limit'), 10)",
      // To prevent endless loops, an "Until" loop 
      // includes these default limits that stop the loop. 
      "limit": { 
         "count": 60,
         "timeout": "PT1H"
      },
      "runAfter": {
         "Initialize_variable": [
            "Succeeded"
         ]
      }
   }
}

この Until ループ例では、リソースを作成する HTTP エンドポイントを呼び出します。 HTTP 応答の本文で Completed ステータスが返されると、ループは停止します。 無限ループを防ぐために、このループは次の条件のいずれかが発生する場合でも中止されます:

• ループが 10 回実行された。これは count 属性で指定されています。 既定値は 60 回です。

• ループが 2 時間実行した。これは timeout 属性で ISO 8601 形式で指定されています。 既定値は 1 時間です。

"actions": {
   "myUntilLoopName": {
      "type": "Until",
      "actions": {
         "Create_new_resource": {
            "type": "Http",
            "inputs": {
               "body": {
                  "resourceId": "@triggerBody()"
               },
               "url": "https://domain.com/provisionResource/create-resource"
            },
            "runAfter": {},
            "type": "ApiConnection"
         }
      },
      "expression": "@equals(body('Create_new_resource'), 'Completed')",
      "limit": {
         "count": 10,
         "timeout": "PT2H"
      },
      "runAfter": {}
   }
}

次のステップ

• 条件に基づいてステップを実行する (条件アクション)
• さまざまな値に基づいてステップを実行する (スイッチ アクション)
• 並列ステップを実行または結合する (分岐)
• グループ化されたアクションの状態に基づいてステップを実行する (スコープ)