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

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

    概要

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

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

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

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

    デフォルトのアクティビティステータス

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

    例外

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

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

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

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

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

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

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

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

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

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

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