フロー制御アクション

フロー制御とは、アクションとサブフローの実行順序を制御する行動のことです。 Power Automate では、フロー制御アクションを通じてフロー制御を実行できます。

Power Automate ポータルで利用可能な「セーフ ストップ」機能と連携して、デバッグ目的で、デスクトップ フローの実行詳細ページ、またはフロー デザイナー内で直接、セーフ ストップが要求された場合アクションをトリガーできます。 この操作により、実行中のフローを制御して終了させることができます。 詳細については、セーフ ストップを参照してください。

デスクトップ フローの実行中にユーザー定義のエラーを意図的に発生させるには、カスタム エラーをスローするアクションを使用できます。 この方法により、On block エラーのアクションでこれらのエラーを捕捉し、処理できるようになります。

デスクトップ フローの実行ポイントを変更する移動アクションの参照ポイントを作成するには、ラベルを使用できます。 以下の例では、一連のアクションを繰り返すために、フローはフローの前半にあるラベルに向けられています。

サブフローの実行 アクションは、それが配置されているサブフローを中断し、別のサブフローを実行します。 2 番目のサブフローが完了すると、フローは元のサブフローに戻されて実行を継続します。 次の例では、同じコードの繰り返しを避けるためにフローの実行中に複数回実行するように、サブフロー 割引の計算 が実行されています。

管理を容易にするためにアクションをグループに視覚的に整理するには、リージョンおよびエンド リージョン アクションの間にそれらを囲みます。リージョンに特徴のある名前を付けます。

これらのアクションには機能的な効果はありませんが、メンテナンスと読みやすさのためにアクションをグループ化して整理するのに役立ちます。 たとえば、リージョンを折りたたんだり展開したりして、必要な場所に注意を向けることができます。

リージョンとエンド リージョン アクションはペアとしてのみ使用でき、正しく連動するには同じスコープに属している必要があります。 2 つのアクションのいずれかが、ループや条件などの別のグループのアクションに属している場合、そのアクションは適切なリージョンを形成できません。

カスタム エラーのスロー アクションは、On block エラーアクションが処理できるカスタム エラーを定義するために使用されます。

注意

サブフローで複数のリージョンを作成する場合、特定のリージョンとエンド リージョン アクション間に事前定義されたマッピングはありません。 その代わりに、最後のリージョン アクションは、その直後に続く利用可能な最初のエンド リージョンアクションとペアを形成しようとします。

安全停止が要求済みかどうか

特定のフローに対して安全停止が要求されているかどうかを確認します。

入力パラメーター

引数	オプション	受入	既定の値	プロパティ
このフローを停止する	在庫切れ	ブール値	False	特定のアクションブロックの完了後にフローの実行を終了するか、それとも実行を継続するかを指定します。 実行を続行する場合は、フローを終了するためにフローの停止アクションを手動で追加する必要があることに注意してください。

生成される変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

コメント

ユーザー コメント。

入力パラメーター

引数	オプション	受入	既定の値	説明設定
Comment	はい	テキスト値		ユーザー コメント

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

末尾

ブロックの終わりを示します。

入力パラメーター

このアクションには入力は必要ありません。

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

エンド リージョン

アクションのグループの終了を示します。

入力パラメーター

このアクションには入力は必要ありません。

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

サブフローの終了

現在のサブフローを終了して、呼び出された位置に戻ります。

入力パラメーター

このアクションには入力は必要ありません。

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

最後のエラーを取得

フローで発生した最後のエラーを取得します。

入力パラメーター

引数	オプション	受入	既定の値	説明設定
エラーを削除する	在庫切れ	ブール値	False	アクションが変数にエラーを格納した後、そのエラーをクリアします。これにより、次にアクションがエラーを取得する際、同じエラー値が取得されることがなくなります

生成される変数

引数	Type	説明設定
LastError	エラー	フローで最後に発生したエラーの詳細

例外

このアクションには例外は含まれません。

に移動

実行フローをラベルで示される別のポイントに転送します。

入力パラメーター

引数	オプション	受入	既定の値	説明設定
ラベルに移動	いいえ	テキスト値		フロー内のラベル

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

Label

'go to' ステートメントの移動先として機能します。

バージョン 2.46 以降では、エラーブロック、ループ、およびその他のサブフローを除き、ラベルを対応する移動アクションとは異なるスコープ (条件分岐ブロック内など) で使用できるようになりました。

入力パラメーター

引数	オプション	受入	既定の値	説明設定
ラベル名	いいえ	テキスト値		プログラム内のラベル

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

カスタム エラーのスロー

指定されたエラー名とメッセージを使用して、ユーザー定義のエラーを発生させます。 このアクションを使用することで、フローは実行時に意図的にカスタム例外を発生させることができます。 このアクションは、On block エラーのアクション内に配置する必要があります。そこで、対応するカスタム エラー エントリの構成と処理を行います。

入力パラメーター

引数	オプション	受入	既定の値	プロパティ
エラー名	いいえ	テキスト値	なし	カスタムエラーの名前。
エラー メッセージ	いいえ	テキスト値	なし	カスタム エラーの説明。

生成される変数

このアクションは変数を生成しません。

ブロック エラー発生時

アクションのエラーを処理するブロックの先頭をマークします。

カスタム エラーをスローするアクションによって発生したカスタム エラーを処理する

On block エラーアクションのプロパティにあるエラー処理セクションで、+ カスタム エラーボタンを選択し、カスタム エラーをスローアクションで定義されたエラー名に対応する新しいエントリを追加します。 希望する処理ルール (変数の設定、サブフローの実行、フローの実行の継続、または実行の中止) を指定してください。 このブロックは、カスタム エラーのエントリを上から下へと評価し、発生したカスタム エラーの名前と一致する最初のルールを実行します。 カスタムエントリのいずれも一致しない場合、このブロックはフォールバックのエラー処理ロジックとしてすべてのエラー (既定) を適用します。

入力パラメーター

引数	オプション	受入	既定の値	Description
Name	いいえ	テキスト値		視覚化のためにのみ使用する例外ブロックの名前。
再試行ポリシー	在庫切れ	なし、固定、指数	なし	再試行が行われる際のルール。 遅延は秒単位で見積もられます。
フロー終了エラーの処理	在庫切れ	ブール値	False	エラー処理の範囲を拡大し、数値をゼロで割ろうとした場合や、範囲外の位置にある品目にアクセスしようとした場合など、処理フローにおける論理的なエラーも捕捉します。

生成される変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

Region

アクションのグループの開始を示します。

入力パラメーター

引数	オプション	受入	既定の値	Description
件名	はい	テキスト値		リージョンの名前。

生成される変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

サブフローの実行

サブフローを実行して、必要な引数を指定します。

サブフローの実行アクションのコンテキスト メニューにある「サブフローに移動」オプションを使用すると、フローデザイナー上で選択したサブフローのタブにすばやく移動できます。

入力パラメーター

引数	オプション	受入	既定の値	説明設定
サブフロー名	いいえ	サブフロー		呼び出すサブフローの名前
式として入力する	在庫切れ	ブール値	False	入力を式として処理するかどうかを定義します。 有効にすると、実行時に変数や式を使用してサブフローを動的に決定します。

生成される変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

フローを停止する

フローを終了します。

入力パラメーター

引数	オプション	受入	既定の値	説明設定
フローの終了	いいえ	正常に、エラーメッセージ付き	成功	フローの実行は正常に終了するか、エラーで終了します
エラー メッセージ	いいえ	テキスト値		終了時にフローの呼び出し元に返すエラー メッセージ

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

遅延

指定された秒数だけフローの実行を中断します。

入力パラメーター

引数	オプション	受入	既定の値	説明設定
長さ	いいえ	数値		期間 (秒単位)

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。