アクティビティ定義

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:6分
  • アクティビティ定義は、プレイブック内のアクティビティがプレイブックの実行時に必要なデータを取得する方法を記述します。

    アクティビティ定義は、プレイブックがトリガーされたときにアクティビティを適切に実行できるように、アクティビティのデフォルトの設定と値を提供します。各アクティビティ定義には、基本的な構成の詳細に加えて、自動化プランとアクティビティエクスペリエンスが含まれています。

    アクティビティ定義 [sys_pd_activity_definition] テーブルには、ワークフロースタジオプレイブックに追加できるアクティビティの定義がリストされています。これらのアクティビティ定義にアクセスするには、 プロセス自動化 > プロセス自動化管理 > アクティビティ定義.

    フィールド

    各アクティビティ定義レコードには、次の基本フィールドがあります。
    フィールド 説明
    ラベル ワークフロースタジオ でユーザーに表示するアクティビティの名前。
    テーブル アクティビティが入力としてアクセスできるレコードを含むテーブル の名前。通常、このテーブルはタスク [task] テーブルまたはグローバル [global] テーブルのいずれかです。
    アプリケーション アクティビティを実行できるアプリケーションスコープ。
    アクセス可能 次のオプションが含まれます。
    • すべてのアプリケーションスコープ - ユーザーは、任意のアプリケーションスコープからこのアクティビティにアクセスできます。
    • このアプリケーションスコープのみ - ユーザーは、[アプリケーション] フィールドで指定したアプリケーションスコープからのみこのアクティビティにアクセスできます。
    説明 アクティビティのオプションの説明。
    必要なロール このアクティビティ定義を使用するアクティビティへのアクセスが許可されているユーザーロールのリスト。

    自動化プラン

    各アクティビティ定義には自動化プランがあります。アクティビティ定義の自動化プランでは、次の項目を指定します。
    • アクティビティの自動化を推進する ワークフロースタジオ フローまたはアクション
    • アクティビティの入力 (アクティビティがプレイブックを実行するために必要なデータ)

    アクティビティデザイナーは、各アクティビティ入力の可視化を設定できます。

    標準のモーダルに含める (Include in standard modal)
    プロパティパネルからの入力を非表示にします。プレイブック設計者は、[詳細プロパティを表示 (Show advanced properties)] オプションを選択した場合にのみ、標準モーダルからの入力を表示できます。
    標準のモーダルおよび構成パネルに含める (Include in standard modal and configuration panel)
    プロパティパネルの入力を表示します。プレイブック設計者は、[詳細プロパティを表示 (Show advanced properties)] オプションを選択した場合にも、標準モーダルからの入力を表示できます。
    アドミニストレーターにのみ表示
    admin または playbook.admin ロールを持たないユーザーからの入力を非表示にします。

    アクティビティエクスペリエンス

    各アクティビティには、オプションのアクティビティエクスペリエンスもあります。アクティビティエクスペリエンスは、エクスペリエンスタイプ、関連付けられたレコード、アクティビティの関連付けられたプレイブックカードにレンダリングするデータの詳細を指定します。アクティビティエクスペリエンスの構成は、プレイブックユーザーエクスペリエンスが関連付けられているプレイブックに追加するアクティビティにのみ適用されます。詳細については、「プレイブックエクスペリエンスの設定」を参照してください。
    エクスペリエンスタイプ
    エクスペリエンスタイプは、アクティビティが実行時にプレイブックカードとしてどのようにレンダリングされるかを記述するデータまたはプロパティを定義します。たとえば、レコードエクスペリエンスタイプは、アクティブ化されたプレイブックの実行時に、アクティビティがプレイブックカードのタイトル、タグライン、説明、フッター、サービスレベルアグリーメント (SLA) 情報を表示できることをシステムに通知します。詳細については、「UI レイアウト」を参照してください。
    関連レコード
    「関連コード」は、実行時にプレイブックカード内でレンダリングできるデータのレコードを定義します。関連レコードは動的です。つまり、プレイブックが進むにつれて頻繁に変更されます。この動的な性質のため、データピルピッカー (データピルピッカー) を使用して、関連レコードを自動化プランで指定された基になるサブフローまたはアクション内の出力レコードデータにマッピングできます。
    プレイブックカードにレンダリングするデータ
    プレイブックカードにレンダリングするデータは、[関連レコード (Associated Record)] セクションの下のセクションで指定できます。このユーザー向けビューでレンダリングされるフィールドに動的データを追加するには、データフィールドの隣にあるデータピルピッカー ( データピルピッカー) を使用して、適切なデータピルに移動またはドット連結します。データピルは、アクティビティ定義の自動化プランで指定されたサブフローまたはアクション内のデータを指す必要があります。
    注:
    アクティビティエクスペリエンスには、プレイブックカード内に表示するデータを指定できる多くのセクションが含まれています。これらのセクションは、選択したエクスペリエンスタイプによって異なります。たとえば、レコードエクスペリエンスタイプには [詳細]、[フォーム]、[添付ファイル]、[機能] セクションがあり、ナレッジエクスペリエンスタイプには [ナレッジ]、[詳細]、[機能] セクションがあります。詳細については、「UI レイアウト」を参照してください。
    プレイブックカードにレンダリングするアクション

    [プレイブックエクスペリエンスアクション割り当てマップ] 関連リストを使用して、アクティビティの プレイブックカードにレンダリングするプレイブックアクションを指定できます。プレイブックアクションは、プレイブックカードのフッターにボタンとして表示されます。プレイブックアクションは、サーバースクリプトの実行、クライアントアクションのディスパッチ、または UI コンポーネントのレンダリングを行うことができます。詳細については、「カスタムプレイブックアクション」を参照してください。

    プレイブックアクションをアクティビティ定義に追加するには、[プレイブックエクスペリエンスアクション割り当てマップ] 関連リストで [新規] を選択します。次に、[アクションのアサイン] リストからプレイブックアクションを選択します。次に、[プレイブックエクスペリエンス] リストからプレイブックアクションを表示するプレイブックユーザーエクスペリエンスを選択し、[送信] をクリックします。

    デザインの検討

    アクティビティ定義を操作するときは、次の設計上の考慮事項を参照してください。
    アクティビティの自動化プランでトリガーされた ワークフロースタジオ フローを呼び出さないようにする
    プレイブック 外で意図せずフローを実行しないようにするため、アクティビティ自動化プランではサブフローまたはアクションのみを使用できます。または、フローのトリガーを、まだ実行されていない場合にのみ実行するように設定することもできます。詳細については、「ワークフロースタジオ フロートリガータイプ」を参照してください。
    アクティビティ定義でデフォルトの入力値を指定する
    アクティビティ定義のデフォルトの入力値を事前設定することで、プレイブックオーナーがプレイブックを作成するために必要な時間と複雑さが軽減されます。