Playbook アクティビティステータスのマッピング

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む5読むのに数分
  • Playbook アクティビティステータスマッピングを使用して、Playbook カードのステータスを上書きします。

    概要

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

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

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

    図 : 1. カードビューに表示されるアクティビティステータス
    カードビューに表示される Playbook アクティビティのステータス

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

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

    例外

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

    Playbook アクティビティステータスマッピングルール

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

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

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

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

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

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

    Playbook アクティビティステータスマッピングの権限

    エージェントがアクティビティステータスマッピングを使用して Playbook のアクティビティを完了、スキップ、または再開できるようにするには、ユーザー権限を割り当てる必要があります。

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