フロー承認プロセスのフェーズエラーの処理
フロー承認プロセスのエラーを処理するように障害パスを設定します。各フェーズの障害パスを作成し、そのフェーズまたはそのステップでエラーが発生したときにトリガーする要素を追加します。このアプローチにより、フェーズエラーが原因で承認申請が失敗する可能性を最小限に抑えます。
必要なエディション
| フロー承認プロセスでサポートされるエディションを表示します。 |
| 必要なユーザー権限 | |
|---|---|
| Flow Builder でフロー承認プロセスを開く、編集する、または作成する | 「フローの管理」 |
フロー承認プロセスのエラー処理の値と戦略については、「フロー承認プロセスのエラー処理」を参照してください。
障害パスの追加
フロー承認プロセスのフェーズの障害パスを定義します。
少なくとも 1 つのフェーズを含むフロー承認プロセスが必要です。
- フロー承認プロセスのフェーズにマウスポインターを置きます。
-
[
] をクリックし、[障害パスを追加] を選択します。
- 作業内容を保存します。
障害パスに少なくとも 1 つの要素を追加します。
障害パスへの決定要素の追加
決定要素を使用して、障害パスで実行されるフェーズを制御する条件を作成します。
障害パスが定義されたフェーズを含むフロー承認プロセスが必要です。
決定要素を使用して、誰も承認作業項目を完了せずに承認申請を承認しないようにします。「フロー承認プロセスのエラー処理での障害パス自動承認の回避」を参照してください。
複数のステップを含むフェーズで障害パスが設定されている場合、決定要素を使用してエラーが発生したステップを判断します。
-
[障害パス] で、[
] をクリックし、[決定] を選択します。
- 表示ラベル、API 参照名、説明を入力します。
-
決定要素に使用する決定ロジックの種別を選択します。
- 従来のロジック式とフロー承認プロセスで明示的に定義されたデータに基づいて実行される結果を決定するには、[手動定義 (デフォルト)] を選択します。
- フロー承認プロセスのデータを評価している AI に基づいて実行される結果を動的に判別するには、[Define with AI (Advanced) (AI で定義 (詳細))] を選択します。
-
[手動で定義 (デフォルト)] を選択した場合は、要素の条件と結果を定義します。手動条件が含まれる決定要素の結果は、リストの順序で評価されます。そのため、結果を定義する順序は、親承認申請に関連付けられたオーケストレーションの実行の結果に影響する可能性があります。
- 表示ラベルと結果 API 参照名を入力します。結果の API 参照名は、フロー承認プロセス内で一意である必要があります。
-
最初の結果に使用する条件の要件を定義します。
オプション 決定結果の動作 すべての条件に一致 いずれかの条件が false の場合、フロー承認プロセスで次の結果の条件が評価されます。 いずれかの条件に一致 いずれかの条件が true の場合、フロー承認プロセスは直ちにこの結果のパスを使用します。 カスタム条件ロジックに一致 このオプションを選択する場合は、最大 1,000 文字を入力して条件ロジックを指定します。以下を使用します。
- 各条件を参照する数値
- どのような条件の組み合わせが true となる必要があるのかを識別する AND、OR、NOT
- 文字列の一部をグループ化するための括弧
AND を入力した場合は、[すべての条件に一致] を選択した場合と同じです。OR を入力した場合は、[いずれかの条件に一致] を選択した場合と同じです。その他のロジックを入力する場合は、各条件の番号を含めるようにします。
たとえば、1 AND NOT(2 OR 3) の場合、フローは最初の条件が
trueであることと、2 番目および 3 番目の条件の両方がtrueでないことを評価します。 -
最初の結果のロジック条件を定義します。
列ヘッダー 説明 リソース オプション:
- フェーズまたはステップから入力変数または自動出力を選択する
- 決定要素を選択する
- グローバル変数を選択する
演算子 使用可能な演算子は、[リソース] に選択されたデータ型によって異なります。「決定要素のフロー承認プロセス演算子」を参照してください。 値 同じ行の [リソース] と [値] のデータ型は、互換性がある必要があります。
オプション:
- フェーズまたはステップからの入力変数や自動出力などのフロー承認プロセスリソースを選択します。
- グローバル変数を選択する
- リテラル値を入力する。
日付値から数値を加算または減算すると、日付は時間単位ではなく日単位で調整されます。
- [AI で定義 (詳細)] を選択した場合は、要素の指示と結果を定義します。
-
(省略可能) 決定結果を決定要素に追加するには、[
] をクリックします。決定要素種別に適した手順を繰り返して、結果を設定します。手動条件については、ステップ 3b を参照してください。AI 条件については、ステップ 4b を参照してください。
-
(省略可能) [決定] 要素の決定結果を並び替えるには、[
] をクリックし、項目を新しい場所にドラッグします。デフォルトの結果は常に最後であるため、条件を含む決定結果をリストの最後の位置に移動することはできません。
-
(省略可能) 決定要素の読みやすさを向上させるには、デフォルトの結果の名前を変更します。
- [結果の順序] で、[デフォルトの結果] を選択します。
- 表示ラベルを入力します。
- 作業内容を保存します。
障害パスへのフェーズ要素の追加
フェーズ要素を使用して、障害パスで実行されるステップをグループ化します。
障害パスが定義されたフェーズを含むフロー承認プロセスが必要です。
-
障害パスで、[
] をクリックし、[フェーズ] を選択します。
- 表示ラベル、API 参照名、説明を入力します。
-
(省略可能) [フェーズを完了するタイミングを選択] で、条件を選択します。
- すべてのステップが完了したらフェーズを完了するには、[When all steps has been marked Completed, the stage is marked Completed (すべてのステップが完了とマークされたら、フェーズは完了とマークされます)] を選択します。
- フェーズを完了する前に満たすべき要件を最大 10 個指定するには、[指定した要件を満たしたら、フェーズは完了とマークされます] を選択します。次に、要件を設定します。
- 複雑な要件を使用してフェーズを完了できるタイミングを判断するには、[指定された評価フローが True を返したら、フェーズは完了とマークされます(When the specified evaluation flow returned True, the stage is marked Completed)] を選択します。次に、有効な評価フローを選択します。
- 作業内容を保存します。
ステップをフェーズに追加します。
フェーズへの承認ステップの追加
フロー承認プロセスフェーズに障害パスが設定されていて、関連付けられたオーケストレーション実行のフェーズでエラーが発生した場合、完了した承認作業項目なしで、関連付けられた承認申請を自動的に承認できます。障害パスのフェーズに承認ステップを追加して、承認作業項目をレビュー担当者に割り当てます。
フロー承認プロセスに関連付けられた承認申請の最終処理にエラーがどのように影響するかについては、「フロー承認プロセスのフェーズの障害パス」を参照してください。
承認ステップは、関連付けられているフローを実行せずに完了できます。承認作業項目に直接関連するアクションのみが含まれる承認ステップの画面フローを参照します。関連レコードの更新や関係者へのエラー通知の送信などの追加アクションを実行するには、バックグラウンドステップを使用します。
- フェーズ要素で、[+ ステップを追加] をクリックし、[承認ステップ] を選択します。
- 表示ラベル、API 参照名、説明を入力します。
-
(省略可能) [ステップを開始するタイミングを選択] で、条件を選択します。
- フェーズの開始時にステップを自動的に開始するには、[フェーズの開始時にステップを開始します] を選択します。
- 別のステップが完了した後にステップを開始するには、[別のステップが [完了] とマークされたら、ステップが開始します] を選択します。次に、最初に完了するステップの名前を入力します。
- ステップを開始する前に満たすべき要件を最大 10 個指定するには、[指定された要件が満たされたら、ステップを開始します] を選択します。次に、要件を設定します。
- 複雑な要件を使用してステップの開始時期を決定するには、[指定された評価フローが True を返した場合、ステップが開始します] を選択します。次に、有効な評価フローを選択します。
-
[実行するアクションを選択] で、ステップで実行する
approvalDecisionという名前のテキスト出力変数を含む有効な画面フローを選択します。選択したフローの必須入力の値またはリソースの API 参照名を指定します。「承認ステップで実行するアクションの選択」を参照してください。
ヒント 承認者は、関連付けられた画面フローを実行せずに承認作業項目を承認または却下できます。画面フローが実行されない可能性があるため、承認の決定に必要な情報のみを含めます。他のアクションを実行するには、承認ステップの後にバックグラウンドステップを使用します。 -
[承認者を選択] で、割り当て種別を選択します。
- ユーザーを指定するには、[ユーザー] を選択します。
- 通常の公開グループを指定するには、[グループ] を選択します。
- キューであるグループを指定するには、[キュー] を選択します。
- 承認申請に関連付けられたオーケストレーションの実行時にユーザーのユーザー名、グループの API 参照名、またはキューの API 参照名を含むリソースを指定するには、[リソース] を選択します。
-
割り当てられたユーザー、グループ、またはキューを指定します。
- [ユーザー] を選択した場合は、内部ユーザーまたはログイン情報のある Experience Cloud サイト訪問者の名前を検索し、リストから選択します。
- [グループ] を選択した場合は、グループの表示ラベルを検索してリストから選択します。
- [キュー] を選択した場合は、キューの表示ラベルを検索してリストから選択します。
- [リソース] を選択した場合は、承認申請に関連付けられたオーケストレーションの実行時に、割り当て先のユーザー名、グループの API 参照名、またはキューの API 参照名が含まれる変数の API 参照名を選択します。
重要 [リソース] で [$User] を選択しないでください。$User グローバル変数は、フロー承認プロセスがシステムコンテキストで実行されているときにシステムユーザーに評価されます。承認ステップをシステムユーザーに割り当てることはできません。 - (省略可能) このステップの承認作業項目が作成されたときに承認者とその代理人にカスタムメール通知を送信するには、[通知メールのカスタマイズ] を選択します。パーソナライズされたメールの件名と本文のテキストテンプレートを作成し、件名と本文の API 参照名を入力します。または、メールの件名と本文のテキストを入力します。
-
[アクションを完了する場所を選択] で、承認するレコードの ID が含まれる変数の API 参照名を選択します。
- 承認申請に関連付けられたオーケストレーションの実行が実行され、承認ステップが開始されたときにレビュー中のレコードをロックするには、[レコードをロック] を選択します。承認者またはその代理人が承認ステップを完了すると、レコードは自動的にロック解除されます。
- ロックされたときに承認者が確認中のレコードを更新できるようにするには、[Allow approvalr to edit the locked record] を選択します。
-
(省略可能) [ステップを完了するタイミングを選択] で、条件を選択します。
- 承認者またはその代理人が関連付けられた作業項目を完了したときにステップを完了するには、[割り当てられたユーザーが画面フローを完了したら、ステップは完了とマークされています] を選択します。
- ステップを完了する前に満たすべき要件を最大 10 個指定するには、[指定された要件が満たされたら、ステップは完了とマークされます] を選択します。次に、要件を設定します。
- 複雑な要件を使用してステップを完了する前に満たすには、[指定された評価フローが True を返すと、ステップは完了とマークされます] を選択します。次に、作成、テスト、有効化した評価フローを選択します。
フェーズへのバックグラウンドステップの追加
障害パスのフェーズにバックグラウンドステップを追加して、レコードの更新や関係者とのコミュニケーションなどのアクションを実行します。
承認申請に関連付けられたオーケストレーションの実行でエラーが発生した場合は、バックグラウンドステップを使用して、関連付けられたすべての承認作業項目が承認される前にオーケストレーションが承認されたかどうかを関係者に通知します。
- stage 要素で、[+ Add Step] をクリックし、[Background Step] を選択します。
- 表示ラベル、API 参照名、説明を入力します。
-
(省略可能) [ステップを開始するタイミングを選択] で、条件を選択します。
- フェーズの開始時にステップを自動的に開始するには、[フェーズの開始時にステップを開始します] を選択します。
- 別のステップが完了した後にステップを開始するには、[別のステップが [完了] とマークされたら、ステップが開始します] を選択します。次に、最初に完了するステップの名前を入力します。
- ステップを開始する前に満たすべき要件を最大 10 個指定するには、[指定された要件が満たされたら、ステップを開始します] を選択します。次に、要件を設定します。
- 複雑な要件を使用してステップの開始時期を決定するには、[指定された評価フローが True を返した場合、ステップが開始します] を選択します。次に、有効な評価フローを選択します。
- [実行するアクションを選択] で、有効な自動起動フローを選択します。
-
[アクションを実行するユーザーを選択] で、オプションを選択します。
- (デフォルト) 自動プロセスユーザーとしてステップを実行するには、[自動プロセスユーザー] を選択します。
- 特定のユーザーとしてステップを実行するには、[選択済みユーザー] を選択します。次に、ステップの実行ユーザーを選択します。
- 実行時に決定されるユーザーとしてステップを実行するには、[A User Specified by a Resource at Runtime (実行時にリソースが指定したユーザー)] を選択します。次に、実行時にステップを実行するユーザーのユーザー名が含まれるフロー承認プロセステキストリソースを選択します。
障害パスの実行後の処理の続行
デフォルトでは、障害パスは終了要素を含むフロー承認プロセスに追加されます。障害パスをフロー承認プロセスに戻すには、Go To コネクタを使用します。
フロー承認プロセスに最終アクションが含まれる場合、Go To コネクタを使用して、これらのアクションを管理する決定要素に障害パスを転送します。この方法により、フェーズエラーによって障害パスがトリガーされた場合でも、フロー承認プロセスに関連付けられたオーケストレーションの実行が意図したとおりに進行します。
-
障害パスで、コネクタを変更する終了要素の直前にある [
] をクリックします。
- [要素に接続] をクリックします。
-
接続先の要素の
をクリックします。
終了要素ではなく、障害パスに、指定された要素への点線接続が追加されました。
