状態ハンドラ

状態ハンドラは単にハンドラとも呼ばれ、エンドユーザーへのレスポンスを作成する、または現在のページを移行することで、会話を制御するために使用されます。会話ターンごとにハンドラが評価され、セッションに影響を与える可能性があります。 ハンドラには、次の 3 種類の一般的なデータがあります。

用語	定義
ハンドラの要件	ハンドラがセッションに影響を与えるためには、満たす必要がある要件が存在します。ハンドラは、要件を満たし、なんらかの方法でセッションに影響を与えると呼び出されたとみなされます。
ハンドラのフルフィルメント	ハンドラが呼び出されると、オプションのフルフィルメントを使用してエンドユーザーのレスポンスが作成されます。これらのレスポンスは、静的エージェント データで定義するか、Webhook サービスから動的に取得します。
ハンドラの遷移ターゲット	ハンドラが呼び出された場合は、オプションの遷移ターゲットを使用して現在のページが変更されます。 次のページは、フローのスタートページ、または現在アクティブなフロー内のページのみです。

ハンドラの要件が異なる次の 2 種類の状態ハンドラがあります。

用語	定義
ルート	ルートは、エンドユーザーの入力がセッション ステータスのインテントまたは一部の条件に一致した場合に呼び出されます。インテント要件のあるルートは、インテント ルートとも呼ばれます。条件のみを要件とするルートは条件ルートとも呼ばれます。
イベント ハンドラ	イベント ハンドラは、イベントが呼び出された場合に呼び出されます。 予期しないエンドユーザー入力を受け取ったとき、または Webhook エラーが発生したときに、一部の組み込みイベントがトリガーされます。会話の外で何かが発生したときに呼び出すカスタム イベントを定義することもできます。

状態ハンドラの処理は、次の 3 つのステップで行われます。

用語	定義
1. 範囲	セッションに影響を与えるには、ハンドラがスコープ内に存在する必要があります。スコープは、ハンドラがフロー、ページ、またはフォーム パラメータに適用されるかどうか、さらに関連付けられたフローがアクティブであるかどうか、関連付けられたページがアクティブであるかどうか、またはエージェントが現在関連付けられたフォーム パラメータを入力しようとしているかどうかによって決まります。
2. 評価	スコープ内の各ハンドラは、順に評価されます。ハンドラの要件を満たしている場合は、評価に合格します。
3. 発信	ハンドラはスコープ内にあり評価に合格すると、呼び出されます。関連付けられたフルフィルメントが呼び出され、関連付けられた遷移ターゲットがセッションに適用されます。

範囲

ハンドラが評価されるには、ハンドラがスコープ内に存在する必要があります。ハンドラのスコープは、会話を制御するうえで有用な重要かつ強力なツールです。ハンドラのスコープを制御することで、次の場合について制御できます。

X	項目
	インテントが一致した場合
	条件をチェックする必要がある場合
	特定のイベントを処理できる場合
	ページ遷移が発生する場合
	静的フルフィルメント レスポンスが提供された場合
	動的レスポンスに対して Webhook によるフルフィルメントが呼び出された場合

スコープは、ハンドラがフロー、ページ、またはフォーム パラメータに適用されるかどうか、さらに関連付けられたフローがアクティブであるかどうか、関連付けられたページがアクティブであるかどうか、またはエージェントが現在関連付けられたフォーム パラメータを入力しようとしているかどうかによって決まります。

スコープ ルールの詳細は以下の通りです。

• アクティブなフローに適用されるルート:
  • 現在のページがフローの開始ページである場合は、スコープに含まれます。
  • 現在のページがフローの開始ページでない場合は、インテントの要件がある場合にのみスコープに含まれます。
• 現在のページに適用されているルートはスコープに含まれます。
• アクティブなフローが適用されたイベント ハンドラはスコープに含まれます。
• 現在のページに適用されているイベント ハンドラはスコープに含まれます。
• エージェントが現在挿入しようとしているフォーム パラメータに適用されたイベント ハンドラはスコープに含まれます。

ルート

ルートには 2 つの要件があり、いずれかまたは両方を指定する必要があります。両方の要件が指定されている場合、ルートを呼び出すには、両方を満たす必要があります。

用語	定義
インテントの要件	現在の会話ターンのエンドユーザー入力に一致させる必要があるインテント。 ルートにインテントの要件がある場合、そのルートはインテント ルートと呼ばれます。
条件の要件	満たす必要がある条件。ルートに条件の要件がある場合、そのルートは条件ルートと呼ばれます。

ルートは、フロー（フローレベルのルート）とページ（ページレベルのルート）に適用できます。たとえば、次のような状況でルートを使用できます。

X	項目
	エンドユーザー入力がインテントと一致すると、その一致によって静的フルフィルメントのレスポンスがトリガーされます。
	エンドユーザー入力がインテントと一致すると、その一致によって動的レスポンスの Webhook によるフルフィルメントがトリガーされます。
	エンドユーザーの入力によって最終的に必要なフォーム パラメータが指定されると、条件チェックによって別のページにセッション遷移がトリガーされます。
	エンドユーザーの入力によって特定のフォーム パラメータが指定されると、条件チェックによって静的フルフィルメント レスポンスがトリガーされます。
	条件チェックを true に設定すると、ページが強制的に遷移します。

インテントの伝播

通常、一致するインテントがあるためにルートが呼び出されると、インテントが消費されます。新しいエンドユーザーの入力によって新しいインテントの一致がトリガーされない限り、消費されたインテントが再び一致することはありません。ただし、次のシナリオでは、インテントの一致をあるフローから別のフローに伝播できます。

• flow F1 のルートには、要件として intent I1 が、遷移ターゲットとして flow F2 が指定されています。
• Flow F2 には、要件として intent I1 も指定されているルートがあります。

この場合、flow F1 のルートが呼び出されると、intent I1 は単一のエンドユーザー入力に対して 2 回一致し、両方のルートが呼び出されます。

インテントの伝播は、次の場合に便利です。

X	項目
	現在のページを別のフローの特定のページに変更する場合（遷移ターゲット フローのルートには特定の遷移ターゲット ページがあります）。
	フローのスタートページのエントリ メッセージを作成する場合（遷移ターゲット フローのルートにはフルフィルメントがあります）。

ルートグループ

エージェントを作成する際、多くのページで共通のルートのセットが使用されている場合があります。ルートを再利用可能にするには、ルートグループを定義します。これらのグループ リソースを作成し、フロー内またはエージェント全体で再利用できます。

たとえば、フローで「I want to add a topping to my pizza」や「I want to change a drink size」などのエンドユーザー入力を処理するとします。これらの入力は、フローの複数のページのいずれか 1 つがアクティブになったときに処理される必要があります。関連するすべてのページに対してこれらの入力を処理するインテントを使用して 2 つのルートを定義できますが、多くの重複した作業が生じます。代わりに、ルートグループを 1 回定義し、関連するすべてのページでグループへの参照を追加できます。

フローレベルのルートグループ

フローレベルのルートグループは、フローを親として作成されたルートグループ リソースです。フロー内で再利用できます。

エージェントレベルのルートグループ

エージェントレベルのルートグループは、エージェントを親として作成されたルートグループ リソースです。 エージェント全体で再利用できますが、ターゲットとして非シンボリック ページに移行するルートは禁止されています。

フローレベルのルート

フローレベルのルートは、フローのスタートページに追加することでフローに適用されるルートです。これらのタイプのハンドラには、次のようなユースケースがあります。

X	項目
	フローのスタートページを対象とするスコープにインテントまたは条件の要件を伴うハンドラ。
	フロー内のすべてのページを対象とするスコープにインテント要件を伴うハンドラ。

コンソールからフローレベルのルートを作成するには:

1. フローのスタートページを開きます。
2. [ルート] 見出しで、追加ボタン（）をクリックします。
3. ルート編集パネルが開きます。
4. ルート フィールドを指定します。
5. [保存] をクリックします。

コンソールからフローレベルのルートを並べ替えるには:

1. フローのスタートページを開きます。
2. [ルート] 見出しをクリックします。
3. ルートリスト パネルが開きます。
4. 目的の順序にルートをドラッグします。または、オプション メニュー（）をクリックして、[移動] を選択します。

コンソールからフローレベルのルートを削除するには:

1. フローのスタートページを開きます。
2. [ルート] 見出しをクリックします。
3. ルートリスト パネルが開きます。
4. オプション メニュー（）をクリックします。
5. [削除] を選択します。

ページレベルのルート

ページレベルのルートはページに適用されるルートです。これらのタイプのハンドラには、次のようなユースケースがあります。

X	項目
	特定のページがアクティブな場合に、スコープ内のインテントまたは条件の要件を伴うハンドラ。

コンソールからページレベルのルートを作成するには:

1. （フローの開始ページではなく）ページを開きます。
2. [ルート] 見出しで、追加ボタン（）をクリックします。
3. ルート編集パネルが開きます。
4. ルート フィールドを指定します。
5. [保存] をクリックします。

コンソールからフローレベルのルートを並べ替えるには:

1. （フローの開始ページではなく）ページを開きます。
2. [ルート] 見出しをクリックします。
3. ルートリスト パネルが開きます。
4. 目的の順序にルートをドラッグします。または、オプション メニュー（）をクリックして、[移動] を選択します。

コンソールからページレベルのルートを削除するには:

1. （フローの開始ページではなく）ページを開きます。
2. [ルート] 見出しをクリックします。
3. ルートリスト パネルが開きます。
4. オプション メニュー（）をクリックします。
5. [削除] を選択します。

イベント ハンドラ

イベント ハンドラを呼び出す際には、次の 1 つの要件があります。

用語	定義
イベントの要件	呼び出す必要があるイベント。イベントは名前で識別されます。予期しないエンドユーザー入力を受信したとき、または Webhook エラーが発生したときに、一部の組み込みイベントが呼び出されます。会話の外で何かが発生したときに呼び出すカスタム イベントを定義することもできます。

イベントハンドラは、フロー（フローレベルのイベント ハンドラ）、ページ（ページレベルのイベント ハンドラ）、パラメータ（パラメータ レベルのイベント ハンドラ）に適用できます。たとえば、次のような場合にイベント ハンドラを使用できます。

X	項目
	エンドユーザー入力がどのインテントとも一致しない場合、一致しないイベント ハンドラは特定の静的フルフィルメント レスポンスを提供します。
	システムでタイマーが期限切れになった場合、特定の静的フルフィルメント レスポンスを使用してエンドユーザーにリマインダー情報を提供します。

フローレベルのイベント ハンドラ

フローレベルのイベント ハンドラは、フローに適用されるイベント ハンドラです。これらのタイプのハンドラには、次のようなユースケースがあります。

X	項目
	フロー スタートページを対象とするスコープ内にイベント要件を伴うハンドラ。
	フロー内のすべてのページを対象とするイベント要件を伴うハンドラ。
	フロー内のすべてのページによって共有される、予期しないエンドユーザー入力の処理。
	Webhook エラーの処理。フロー内のすべてのページで共有されます。
	システムによって呼び出されるカスタム イベントの処理。フロー内のすべてのページで共有されます。

各フローには、no-match と no-input の組み込みイベントのイベント ハンドラがあります。これらのイベント ハンドラは、フローの作成時に自動的に作成され、削除できません。

コンソールからパラメータ レベルのイベント ハンドラを作成するには:

1. フローのスタートページを開きます。
2. [イベント ハンドラ] 見出しにある追加ボタン（）をクリックします。
3. イベント ハンドラパネルが開きます。
4. イベント ハンドラのフィールドを指定します。
5. [保存] をクリックします。

コンソールからパラメータ レベルのイベント ハンドラを削除するには:

1. フローのスタートページを開きます。
2. [イベント ハンドラ] 見出しをクリックします。
3. イベント ハンドラのリストパネルが開きます。
4. イベント ハンドラにカーソルを合わせ、削除ボタン（）をクリックします。

ページレベルのイベント ハンドラ

ページレベルのイベント ハンドラは、ページに適用されるイベント ハンドラです。これらのタイプのハンドラには、次のようなユースケースがあります。

X	項目
	特定のページがアクティブな場合に、スコープ内のイベント要件を伴うハンドラ。
	ページに固有の予期しないエンドユーザー入力の処理。
	ページ固有の Webhook エラーの処理。
	ページ固有のカスタム イベントの処理。

コンソールからページレベルのイベント ハンドラを作成するには:

1. （フローの開始ページではなく）ページを開きます。
2. [イベント ハンドラ] 見出しがない場合は、[状態ハンドラを追加] をクリックして、[イベント ハンドラ] を選択し、[適用] をクリックします。
3. [イベント ハンドラ] 見出しにある追加ボタン（）をクリックします。
4. イベント ハンドラパネルが開きます。
5. イベント ハンドラのフィールドを指定します。
6. [保存] をクリックします。

コンソールからページレベルのイベント ハンドラを削除するには:

1. （フローの開始ページではなく）ページを開きます。
2. [イベント ハンドラ] 見出しをクリックします。
3. イベント ハンドラのリストパネルが開きます。
4. イベント ハンドラにカーソルを合わせ、削除ボタン（）をクリックします。

パラメータ レベルのイベント ハンドラ

パラメータ レベルのイベント ハンドラは、フォーム パラメータに適用されるイベント ハンドラです。リプロンプト ハンドラとも呼ばれます。これらのイベント ハンドラは、フォーム入力時の無効なエンドユーザー入力を処理することを目的としているため、カスタム イベントは使用できません。

これらのタイプのハンドラには、次のようなユースケースがあります。

X	項目
	エンドユーザーがフォームのパラメータを入力する際に有効な入力を行わなかった場合。

コンソールからパラメータ レベルのイベント ハンドラを作成するには:

1. フォーム パラメータを含むページを開きます。
2. パラメータをクリックします。
3. パラメータ パネルが開きます。
4. [リプロンプト イベント ハンドラ] セクションまでスクロールし、[イベント ハンドラを追加] をクリックします。
5. イベント ハンドラパネルが開きます。
6. イベント ハンドラのフィールドを指定します。
7. [保存] をクリックします。

コンソールからパラメータ レベルのイベント ハンドラを削除するには:

1. フォーム パラメータを含むページを開きます。
2. パラメータをクリックします。
3. パラメータ パネルが開きます。
4. [リプロンプト イベント ハンドラ] セクションまでスクロールします。
5. イベント ハンドラにカーソルを合わせ、削除ボタン（）をクリックします。

組み込みイベント

注: エージェント設計のベスト プラクティス ガイドには、組み込みエラー イベントに関する重要なベスト プラクティスの説明があります。

次のイベントは組み込まれており、Dialogflow によって呼び出されます。一部のイベントは特定のレベルに制限されています。

イベント名	フローレベル	ページレベル	パラメータレベル	呼び出される時点
sys.no-match-default	✔	✔	✔	フローレベルまたはページレベルの場合: ユーザー入力は、スコープ内のハンドラのインテントと一致しません。 パラメータ レベルの場合: ユーザー入力がフォーム パラメータを満たしていません。
sys.no-match-[1-6]	✔	✔	✔	これらのいずれかの数値順に並べられたイベントのハンドラを指定すると、sys.no-match-default の代わりに、sys.no-match-1、sys.no-match-2、...の順に呼び出されます。
sys.no-input-default	✔	✔	✔	エンドユーザー入力を受信しなかったとき。これは、次の場合に呼び出される可能性があります。 Dialogflow は、空のエンドユーザー テキスト入力を受け取ります。 Dialogflow は空のエンドユーザー音声入力を受け取るか、入力に認識された音声が含まれていません。 エンドユーザーの音声入力に認識された音声が含まれる前に音声なしタイムアウトが発生します。
sys.no-input-[1-6]	✔	✔	✔	これらのいずれかの数値順に並べられたイベントのハンドラを指定すると、sys.no-input-default の代わりに、sys.no-input-1、sys.no-input-2、...の順に呼び出されます。
sys.invalid-parameter			✔	WebhookResponse.pageInfo.formInfo.parameterInfo.state を INVALID に設定して Webhook レスポンスでパラメータが無効になったときに呼び出されます。
sys.long-utterance	✔	✔	✔	エンドユーザー入力は、非生成インテントまたはパラメータによって照合される最大許容長（256 文字）を超えています。指定しない場合、Dialogflow はユーザーの長い発話を no-match として扱います。ストリーミング音声入力の場合、クライアントが音声ストリームを閉じた後にのみこのイベントがトリガーされます。
webhook.error	✔	✔		Webhook 呼び出しがエラーを返したとき。 このイベントは、1) ウェブフックのエラーコードに一致する詳細なウェブフック イベントハンドラ (例: webhook.error.timeout) がない場合、2) 失敗したウェブフックを持つ履行を呼び出した元のルートに、遷移先の設定がない場合にのみ呼び出されます。詳しくは、評価順序セクションをご覧ください。
webhook.error.timeout	✔	✔		Webhook 呼び出しがタイムアウトしたとき。 Webhook イベントは、失敗した Webhook でフルフィルメントを呼び出した元のルートに遷移ターゲットの設定がない場合にのみ呼び出されます。詳しくは、評価順序セクションをご覧ください。
webhook.error.bad-request	✔	✔		Webhook が 400 不正なリクエストを返しました。Webhook イベントは、失敗した Webhook でフルフィルメントを呼び出した元のルートに遷移ターゲットの設定がない場合にのみ呼び出されます。詳しくは、評価順序セクションをご覧ください。
webhook.error.rejected	✔	✔		Webhook が 401 未認証または 403 禁止を返しました。Webhook イベントは、失敗した Webhook でフルフィルメントを呼び出した元のルートに遷移ターゲットの設定がない場合にのみ呼び出されます。詳しくは、評価順序セクションをご覧ください。
webhook.error.unavailable	✔	✔		Webhook から 503 サービス利用不可が返されました。Webhook イベントは、失敗した Webhook でフルフィルメントを呼び出した元のルートに遷移ターゲットの設定がない場合にのみ呼び出されます。詳しくは、評価順序セクションをご覧ください。
webhook.error.not-found	✔	✔		Webhook URL に到達できなかったため、Webhook 呼び出しが失敗しました。Webhook イベントは、失敗した Webhook でフルフィルメントを呼び出した元のルートに遷移ターゲットの設定がない場合にのみ呼び出されます。詳しくは、評価順序セクションをご覧ください。
flow-cancelled	✔	✔		エンドユーザーがフローのキャンセルをリクエストしました。このイベントは、[キャンセルによる終了フロー] ページによってトリガーされます。END_FLOW_WITH_CANCELLATION 遷移のシンボリック ターゲットをご覧ください。
flow-failed	✔	✔		このフローは指定されたタスクを完了できませんでした。このイベントは、[エラーによる終了フロー] ページによってトリガーされます。END_FLOW_WITH_FAILURE 遷移のシンボリック ターゲットをご覧ください。
flow-failed-human-escalation	✔	✔		エンドユーザーが人間のエージェントと会話するようリクエストしました。このイベントは、[人間のエスカレーションによる終了フロー] ページによってトリガーされます。END_FLOW_WITH_HUMAN_ESCALATION シンボリック遷移ターゲットをご覧ください。

カスタム イベント

カスタム イベントとイベント ハンドラを作成できます。カスタム イベントは、エンドユーザーとの会話の以外で発生した事象の処理に使用されます。たとえば、エンドユーザーがボタンをクリックしたとき、一定の時間が経過したとき、会話中に使用可能な在庫が変更されたときなどです。

イベントは名前で識別されます。組み込みイベントと競合しないように、sys. または webhook. で始まるイベント名は使用しないでください。

API でイベントを呼び出すには、Session タイプの detectIntent メソッドの queryInput.event フィールドをご覧ください。Session API リファレンスに移動

セッション リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	セッション リソース	セッション リソース
RPC	セッション インターフェース	セッション インターフェース
C++	SessionsClient	利用できません
C#	SessionsClient	利用できません
Go	SessionsClient	利用できません
Java	SessionsClient	SessionsClient
Node.js	SessionsClient	SessionsClient
PHP	提供なし	利用できません
Python	SessionsClient	SessionsClient
Ruby	提供なし	利用できません

終了

評価順序

ハンドラは、特定の順序で評価されます。次の一般的なルールが適用されます。

1. スコープ内のハンドラのみが評価されます。
2. 要件を満たすハンドラのみを呼び出すことができます。
3. 遷移ターゲットのないハンドラが呼び出された場合、ハンドラのリストの評価は続行されます。このルールにより、複数のフルフィルメントでレスポンス キューに複数のメッセージを追加できます。
4. 遷移ターゲットを含むハンドラが呼び出されると、ハンドラのリストの評価は終了します。
5. フルフィルメントを含むハンドラが呼び出され、フルフィルメントが Webhook エラーの場合は次のようになります。
   • ハンドラに遷移ターゲットが定義されている場合、Webhook は通知なしに失敗します。
   • イベント ハンドラがイベントのスコープ内にある場合は、イベントを処理し、ハンドラのリストの評価を終了します。
   • イベント ハンドラがイベントのスコープ内にない場合、Webhook は通知なく失敗します。
6. インテントの要件が満たされると、インテントが消費されるため、そのインテントで最初に検出されたルートハンドラのみを呼び出すことができます（例外については、インテントの伝播を参照）。
7. 条件についての要件が満たされると条件は消費されないため、条件を持つ複数のルートを呼び出すことができます。
8. イベント要件が満たされると、イベントは消費されるため、最初に検出されたイベント ハンドラのみを呼び出すことができます。
9. ハンドラ呼び出しスタックは、評価順序に影響を与える可能性があります。

評価には次の 3 つのフェーズがあります。

1. インテント要件を伴うルートは、次の順序で評価されます。
   1. ページレベル: 指定された順序で、現在のページに適用される個別のルート。
   2. ページレベルのグループ: 指定された順序で、現在のページに適用されるルートグループ。
   3. フローレベル: 指定された順序で、アクティブなフローに適用されるルート。
   4. フローレベルのグループ: 指定された順序で、アクティブなフローに適用されるルートグループ。
2. 条件の要件のみを伴うルートは、次の順序で評価されます。
   1. ページレベル: 指定された順序で、現在のページに適用される個別のルート。
   2. ページレベルのグループ: 指定された順序で、現在のページに適用されるルートグループ。
   3. フローレベル（現在のページがフロー開始ページの場合のみ）: 指定した順序でアクティブ フローに適用されるルート。
   4. フローレベルのグループ（現在のページがフローの開始ページの場合のみ）: アクティブなグループに適用されるルートグループ。
3. イベント ハンドラは次の順序で評価されます。
   1. パラメータ レベル: 指定された順序で、エージェントが現在挿入しようとしている現在のページのフォーム パラメータに適用されるイベント ハンドラ（リプロンプト ハンドラ）。
   2. ページレベル: 指定された順序で、現在のページに適用されるイベント ハンドラ。
   3. フローレベル: 指定された順序で、アクティブなフローに適用されるイベント ハンドラ。

遷移のシンボリック ターゲット

ハンドラの遷移ターゲットを入力する際は、特定のフローやページを入力できますが、遷移のシンボリック ターゲットを入力することもできます。

遷移のシンボリック ターゲット	説明
START_PAGE	同名のアクティブなフローのスタートページに遷移します。
END_FLOW	現在アクティブなフローを終了し、現在のフローに遷移したページに戻ります。ハンドラのコールスタックとフロースタックの上限もご覧ください。
END_FLOW_WITH_CANCELLATION	現在アクティブなフローを終了し、現在のフローに遷移したページに戻ります。呼び出しページは、flow-cancelled 組み込みイベントを使用して、この遷移を処理できます。ハンドラのコールスタックとフロースタックの上限もご覧ください。
END_FLOW_WITH_FAILURE	現在アクティブなフローを終了し、現在のフローに遷移したページに戻ります。呼び出しページは、flow-failed 組み込みイベントを使用して、この遷移を処理できます。ハンドラのコールスタックとフロースタックの上限もご覧ください。
END_FLOW_WITH_HUMAN_ESCALATION	現在アクティブなフローを終了し、現在のフローに遷移したページに戻ります。呼び出しページは、flow-failed-human-escalation 組み込みイベントを使用して、この遷移を処理できます。ハンドラのコールスタックとフロースタックの上限もご覧ください。
END_SESSION	現在のセッションを消去して、END_SESSION という名前の特別なページに遷移します。次のユーザー入力は、デフォルトの開始フローのスタートページでセッションを再起動します。
PREVIOUS_PAGE	現在のページに遷移した前のページに遷移します。遷移後に前のページのページ状態が復元されます。
CURRENT_PAGE	現在のページに再び遷移します。エージェントで何かを繰り返す必要がある場合に利用できます。

ハンドラのコールスタックとフロースタックの上限

セッションが特定の遷移ターゲットを指定してフロー間を遷移すると、各フローはフロースタックに push されます。

ハンドラ コールスタック

セッションが END_FLOW に遷移すると、完了フローに戻る原因となった呼び出しページに戻ります。このような状況では、ハンドラの呼び出しスタックが保持されます。以前に呼び出しページから評価されたすべてのハンドラがスキップされ、残りのハンドラは順番に評価されます。

次に例を示します。

1. ページ P には、H1、H2、H3 の順序で 3 つのハンドラが存在します。
2. H1 は評価されますが、移行は行われません。
3. H2 が評価され、フロー F への遷移が発生します。
4. フロー F のページが END_FLOW に移行します。
5. セッションはページ P に戻り、保持された状態で再びアクティブになります。
6. ページ P のハンドラの評価は、保持されているステータスから続行され、その結果、H3 が評価されます。

フロースタックの上限

フロースタックの最大上限は 25 です。最大スタック上限を超えると、スタックからフローがポップされ、END_FLOW 遷移を使用する際の予期しない動作が発生する可能性があります。このような潜在的な問題を回避するには、END_FLOW 遷移に先立ってフロー間の遷移の数を最小限に抑えます。

フロースタックが空の場合、END_FLOW 遷移はセッションを終了します。

条件の設定

コンソールで条件を設定するには、次の 3 つの論理オプションのいずれかを使用して、条件ルールを指定します。

• 1 つのルールに一致（または）
• すべてのルールに一致（かつ）
• 式のカスタマイズ

便宜上、パラメータ値に対する単純な条件や複合条件を作成するために AND / OR オプションを使用できます。

システム関数やブール定数などすべての種類の条件に対して、自由形式の [式のカスタマイズ] オプションを使用できます。

たとえば、合格評価が 10% となる条件を設定するには、[式のカスタマイズ] オプションを選択し、[条件] フィールドに $sys.func.rand() < 0.1 を入力します。