プレイブックアクティビティステータスマッピング

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:5分
  • プレイブックアクティビティステータスマッピングを使用して、プレイブックカードのステータスを上書きします。

    概要

    プレイブックカードのステータスは、デフォルトではアクティビティステータスから取得されます。アクティビティ状況は、アクティビティを強化するサブフローまたはフローアクションから取得されます。

    アクティビティ定義作成者は、プレイブックカードに表示されるステータスを提供するレコードを指定できます。このレコードは、 エクスペリエンスステータスレコードと呼ばれます。これは、アクティビティ定義のエクスペリエンスプロパティ内で指定されます。[エクスペリエンスステータスレコード] タブ

    任意のテーブルの任意のレコードをエクスペリエンスステータスレコードとして使用できます。デフォルトのアクティビティ定義では 、sys_flow_data レコードをエクスペリエンスステータスレコードとして使用します。

    図 : 1. カードビューに表示されるアクティビティ状況
    カードビューに表示されるプレイブックアクティビティのステータス

    デフォルトのアクティビティ状況

    表 : 1. sys_flow_dataレコードのすぐに利用可能なデフォルトのアクティビティ状況
    ステータス フロー状態
    保留 フローが開始されていません
    進行中 フローが実行中です
    完了 フローが終了しました
    スキップ 条件により、フローがスキップされました
    エラー フローでエラーが発生しました
    アクティビティ状況は、以下で使用されます。
    • 宣言アクションの条件
    • アクティビティ上書き条件
    • アニメーション
    • カードのビジュアルエクスペリエンス

    例外

    ビジネスロジックは、必ずしもフローと 1 対 1 で一致しているとは限りません。例外の例を次に示します。
    • エージェントが説明カードで [スキップ ] をクリックします。フローは完了として表示されますが、ビジネスロジックはスキップされます。
    • エージェントは、完了した説明カードで [再起動 ] をクリックします。フローはフローを再開しません。 フローデータ レコードを更新するだけです。
    • タスクがエージェントからの入力を待機してループを再開すると、フローが完了しないことがあります。関連するタスクは、このステータスで実質的に完了しています。

    プレイブックアクティビティのステータスマッピングルール

    アクティビティステータスマッピングルールを使用して、特定のエクスペリエンスステータスレコードのカードに表示されるアクティビティステータスを制御します。

    アクティビティステータスマッピングルールは、エクスペリエンスステータステーブルごとに必要です。これらのルールは、プレイブックユーザーがアクティビティの完了などアクティビティのステータスを更新したときに、エクスペリエンスステータスレコードを更新する方法を決定します。

    すぐに利用可能なグローバルプレイブックエクスペリエンスには、 sys_flow_data テーブルのデフォルトルールセットが含まれています。ほとんどのプレイブックアクティビティにはこのルールセットで十分ですが、必要に応じてカスタムテーブルに追加のルールを作成することもできます。

    特定のエクスペリエンスステータステーブルのアクティビティステータスマッピングルールはプレイブックエクスペリエンスごとに一意であり、[ ステータスマッピング] をクリックして関連タブからアクセスできます。
    図 : 2. [ステータスマッピング] タブ
    [プレイブックエクスペリエンスステータスマッピング] タブ

    エクスペリエンスステータスマッピングレコード

    各エクスペリエンスステータスマッピングレコードは、 エクスペリエンスステータステーブルの どのフィールドに エクスペリエンスステータス値を含めるかを指定します。エクスペリエンスステータスマッピングレコードには、次の関連リストもあります。
    • エクスペリエンスステータスからアクティビティステータスルールへ
    • アクティビティステータスからエクスペリエンスステータスルールへ
    図 : 3. エクスペリエンスステータスマッピングレコード関連リスト
    エクスペリエンスステータステーブル関連リスト
    [エクスペリエンスステータスからアクティビティステータスへ (Experience Status to Activity State)] フォームは、特定のエクスペリエンスステータスレコード値のどのアクティビティステータスをカードに表示するかを制御します。フォームにより、[ エクスペリエンスステータスレコード値 ] リストに [エクスペリエンスステータス] フィールドの選択値が入力されます。
    図 : 4. プレイブックエクスペリエンスステータスからアクティビティステータスへのマップ
    プレイブックエクスペリエンスステータスレコード値リスト
    [アクティビティステータスからエクスペリエンスステータスへ (Activity State to Experience Status )] フォームは、プレイブックユーザーがアクティビティをスキップするなど、アクティビティステータスを更新したときにエクスペリエンスステータスレコードを更新する方法を制御します。フォームの [ エクスペリエンスステータスレコード値 ] リストに [ エクスペリエンスステータスフィールド] の選択値が入力されます。
    図 : 5. プレイブックエクスペリエンスアクティビティステータスからエクスペリエンスステータスマップへ

    プレイブックアクティビティのステータスマッピング権限

    エージェントがアクティビティステータスマッピングを使用してプレイブックのアクティビティを完了、スキップ、または再起動できるようにするには、ユーザー権限がアサインされている必要があります。

    完了可能スキップ可能および再起動可能 の権限は、アクティビティがフェッチされるたびに次の条件に基づいて決定されます。
    • エクスペリエンスステータスレコード を定義する必要があります
    • ユーザーにはエクスペリエンスステータスレコードへの書き込みアクセス権が必要です
    • エクスペリエンスステータステーブルにアクティビティステータスマッピングルールセットが存在する必要があります
    • ユーザーには 、そのテーブルのエクスペリエンスステータスフィールド への書き込みアクセス権が必要です
    • 対応する操作には、アクティビティステータスからエクスペリエンスステータスへのマッピングルールが存在する必要があります:
      プレイブックアクティビティ アクティビティステータス
      完了可能 完了
      スキップ スキップ
      再開する 進行中
    権限が有効でない場合、ユーザーはその操作を実行できません。[ 完了可能]、[ スキップ可能]、および [再起動可能 ] クライアント条件を使用する対応する宣言アクションは表示されません。
    注:
    ユーザーがエクスペリエンスステータスレコード[エクスペリエンスステータス] フィールドに対する読み取りアクセス権を持っていない場合は、代わりにデフォルトのアクティビティステータスが使用されます。デフォルトのアクティビティ状況は、アクティビティを強化するフローの状況です。