--- sourceDocument: Yokohama ビルドのワークフロー sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/build-workflows Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama ビルドのワークフロー ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # アクティビティ定義 # アクティビティ定義 {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分 アクティビティ定義は、プレイブック内のアクティビティがプレイブックの実行時に必要なデータを取得する方法を記述します。 アクティビティ定義は、プレイブックがトリガーされたときにアクティビティを適切に実行できるように、アクティビティのデフォルトの設定と値を提供します。各アクティビティ定義には、基本的な構成の詳細に加えて、自動化プランとアクティビティエクスペリエンスが含まれています。 アクティビティ定義 \[sys_pd_activity_definition\] テーブルには、ワークフロースタジオのプレイブックに追加できるアクティビティの定義がリストされています。これらのアクティビティ定義にアクセスするには、 プロセスの自動化プロセス自動化管理アクティビティ定義. ## フィールド {#activity-definitions__section_v2r_24p_rlb} 各アクティビティ定義レコードには、次の基本フィールドがあります。{#activity-definitions__table_ezy_jn4_rlb__entry__2} | フィールド | 説明 | |-|-| | ラベル | ワークフロースタジオ でユーザーに表示するアクティビティの名前。 | | テーブル | アクティビティが入力としてアクセスできるレコードを含むテーブル の名前。通常、このテーブルはタスク \[task\] テーブルまたはグローバル \[global\] テーブルのいずれかです。 | | アプリケーション | アクティビティを実行できるアプリケーションスコープ。 | | アクセス可能 | 次のオプションが含まれます。 * すべてのアプリケーションスコープ - ユーザーは、任意のアプリケーションスコープからこのアクティビティにアクセスできます。 * このアプリケーションスコープのみ - ユーザーは、\[アプリケーション\] フィールドで指定したアプリケーションスコープからのみこのアクティビティにアクセスできます。 {#activity-definitions__ul_k1n_4hb_zlb} | | 説明 | アクティビティのオプションの説明。 | | 必要なロール | このアクティビティ定義を使用するアクティビティへのアクセスが許可されているユーザーロールのリスト。 | [ ] {#activity-definitions__table_ezy_jn4_rlb} ## 自動化プラン {#activity-definitions__section_fbd_jr4_plb} 各アクティビティ定義には自動化プランがあります。アクティビティ定義の自動化プランでは、次の項目を指定します。 * アクティビティの自動化を推進する ワークフロースタジオ フローまたはアクション * アクティビティの入力 (アクティビティがプレイブックを実行するために必要なデータ) {#activity-definitions__ul_mlg_qfp_rlb} アクティビティデザイナーは、各アクティビティ入力の可視化を設定できます。 標準のモーダルに含める (Include in standard modal) : プロパティパネルからの入力を非表示にします。プレイブック設計者は、\[詳細プロパティを表示 (Show advanced properties)\] オプションを選択した場合にのみ、標準モーダルからの入力を表示できます。 標準のモーダルおよび構成パネルに含める (Include in standard modal and configuration panel) : プロパティパネルの入力を表示します。プレイブック設計者は、\[詳細プロパティを表示 (Show advanced properties)\] オプションを選択した場合にも、標準モーダルからの入力を表示できます。 アドミニストレーターにのみ表示 : admin または playbook.admin ロールを持たないユーザーからの入力を非表示にします。 ## アクティビティエクスペリエンス {#activity-definitions__activity-experience} 各アクティビティには、オプションのアクティビティエクスペリエンスもあります。アクティビティエクスペリエンスは、エクスペリエンスタイプ、関連付けられたレコード、アクティビティの関連付けられたプレイブックカードにレンダリングするデータの詳細を指定します。アクティビティエクスペリエンスの構成は、プレイブックユーザーエクスペリエンスが関連付けられているプレイブックに追加するアクティビティにのみ適用されます。詳細については、「プレイブックエクスペリエンスの設定」を参照してください。 エクスペリエンスタイプ : エクスペリエンスタイプは、アクティビティが実行時にプレイブックカードとしてどのようにレンダリングされるかを記述するデータまたはプロパティを定義します。たとえば、レコードエクスペリエンスタイプは、アクティブ化されたプレイブックの実行時に、アクティビティがプレイブックカードのタイトル、タグライン、説明、フッター、サービスレベルアグリーメント (SLA) 情報を表示できることをシステムに通知します。詳細については、「[UI レイアウト](https://servicenow-prod.fluidtopics.net/zAJkI8XBt~O51SpaQ_4vjg "UI レイアウトは、プレイブックエクスペリエンス でアクティビティをカードとしてレンダリングするときに使用するプロパティとコンポーネントを示します。")」を参照してください。 関連レコード : 「関連コード」は、実行時にプレイブックカード内でレンダリングできるデータのレコードを定義します。関連レコードは動的です。つまり、プレイブックが進むにつれて頻繁に変更されます。この動的な性質のため、データピルピッカー (![データピルピッカー]()) を使用して、関連レコードを自動化プランで指定された基になるサブフローまたはアクション内の出力レコードデータにマッピングできます。 プレイブックカードにレンダリングするデータ : プレイブックカードにレンダリングするデータは、\[関連レコード (Associated Record)\] セクションの下のセクションで指定できます。このユーザー向けビューでレンダリングされるフィールドに動的データを追加するには、データフィールドの隣にあるデータピルピッカー ( ![データピルピッカー]()) を使用して、適切なデータピルに移動またはドット連結します。データピルは、アクティビティ定義の自動化プランで指定されたサブフローまたはアクション内のデータを指す必要があります。 注: アクティビティエクスペリエンスには、プレイブックカード内に表示するデータを指定できる多くのセクションが含まれています。これらのセクションは、選択したエクスペリエンスタイプによって異なります。たとえば、レコードエクスペリエンスタイプには \[詳細\]、\[フォーム\]、\[添付ファイル\]、\[機能\] セクションがあり、ナレッジエクスペリエンスタイプには \[ナレッジ\]、\[詳細\]、\[機能\] セクションがあります。詳細については、「[UI レイアウト](https://servicenow-prod.fluidtopics.net/zAJkI8XBt~O51SpaQ_4vjg "UI レイアウトは、プレイブックエクスペリエンス でアクティビティをカードとしてレンダリングするときに使用するプロパティとコンポーネントを示します。")」を参照してください。 プレイブックカードにレンダリングするアクション : \[プレイブックエクスペリエンスアクション割り当てマップ\] 関連リストを使用して、アクティビティの プレイブックカードにレンダリングするプレイブックアクションを指定できます。プレイブックアクションは、プレイブックカードのフッターにボタンとして表示されます。プレイブックアクションは、サーバースクリプトの実行、クライアントアクションのディスパッチ、または UI コンポーネントのレンダリングを行うことができます。詳細については、「カスタムプレイブックアクション」を参照してください。 プレイブックアクションをアクティビティ定義に追加するには、\[プレイブックエクスペリエンスアクション割り当てマップ\] 関連リストで \[新規\] を選択します。次に、\[アクションのアサイン\] リストからプレイブックアクションを選択します。次に、\[プレイブックエクスペリエンス\] リストからプレイブックアクションを表示するプレイブックユーザーエクスペリエンスを選択し、\[送信\] をクリックします。 ## デザインの検討 {#activity-definitions__section_hc4_5mm_tlb} アクティビティ定義を操作するときは、次の設計上の考慮事項を参照してください。 アクティビティの自動化プランでトリガーされた ワークフロースタジオ フローを呼び出さないようにする : プレイブック 外で意図せずフローを実行しないようにするため、アクティビティ自動化プランではサブフローまたはアクションのみを使用できます。または、フローのトリガーを、まだ実行されていない場合にのみ実行するように設定することもできます。詳細については、「[ワークフロースタジオ フロートリガータイプ](https://servicenow-prod.fluidtopics.net/dW2tZUl9YaNaAqDCiJ4eFg "各トリガータイプで、フローを開始するタイミングと利用可能な初期データを定義します。トリガーには、レコード操作、日付、およびアプリケーション操作に対するものがあります。​")」を参照してください。 アクティビティ定義でデフォルトの入力値を指定する : アクティビティ定義のデフォルトの入力値を事前設定することで、プレイブックオーナーがプレイブックを作成するために必要な時間と複雑さが軽減されます。 * **[アクティビティ定義の作成](https://servicenow-prod.fluidtopics.net/Du1W97PeUMcAPr6OSCW_BQ)** アクティビティを実行するアクションまたはサブフローを指定します。アクティビティをプレイブックに追加するときにプレイブックデザイナーに設定させる入力を構成します。アクティビティの実行時にエンドユーザーに提供するエクスペリエンスを選択します。 * **[アクティビティ自動化プランとしてアクションを作成する](https://servicenow-prod.fluidtopics.net/_SEYPtkQoGBocS10LlN06Q)** プレイブック からアクティビティとして設定して実行するアクションの例を作成します。 * **[UI レイアウト](https://servicenow-prod.fluidtopics.net/zAJkI8XBt~O51SpaQ_4vjg)** UI レイアウトは、プレイブックエクスペリエンス でアクティビティをカードとしてレンダリングするときに使用するプロパティとコンポーネントを示します。 **関連概念** * [自動化資産](https://servicenow-prod.fluidtopics.net/RDnoGz_A5ExY67LKkIQtrw "アクティビティピッカーにすべての自動化資産を含めて、アクティビティ定義を作成しなくても、サブフロー、フロー、またはアクションを直接プレイブックに追加します。") * [オプションのアクティビティ](https://servicenow-prod.fluidtopics.net/axxIYptEtn9rZNH0mBbG8Q#optional-activities "エージェントと履行者がプレイブックを使用するときにアクティビティを追加できるようにします。") **関連タスク** * [プレイブックでのステージの追加と構成](https://servicenow-prod.fluidtopics.net/dAnrTj8q8H9HcZYrQaxMig "プレイブックでステージを追加および構成します。") * [プレイブックでのアクティビティの追加と構成](https://servicenow-prod.fluidtopics.net/8yfbumH~oimPUDJLoAhCMg "プレイブックでアクティビティを追加および構成します。") * [意思決定アクティビティ](https://servicenow-prod.fluidtopics.net/Uk5dTobttCRfl7Yj6LtIQg "エージェントがプレイブックでたどることができるさまざまなパスに対して、さまざまな条件で分岐を作成および定義します。") * [並列分岐](https://servicenow-prod.fluidtopics.net/Q5P72KdUAkgDGAbrRv6PHQ "アクティビティおよびステージの別の分岐と並行して実行される、アクティビティおよびステージの分岐を追加します。") * [アクティビティへの動的入力の追加](https://servicenow-prod.fluidtopics.net/M5mk~ve176C1DdFVJ45AGA "選択したカタログアイテム、選択したディシジョンテーブル、REST API 応答など、別の入力の値に基づいて特定のフィールドのセットを表示するようにアクティビティを設定します。") **関連資料** * [遅延入力プロパティから開始](https://servicenow-prod.fluidtopics.net/cAWaTT2JHyUN3C8NRs~XBw "開始ルールと条件が満たされたアクティビティまたはステージを実行するまでの待機時間を指定します。自動プレイブック中にアクションを実行する時間をユーザーに提供します。アクションを完了するために特定の日時を待つ時間をユーザーに提供します。") * [アンケートアクティビティ](https://servicenow-prod.fluidtopics.net/yS73qAuVx3xjYdLZ51QYag "プレイブックの実行中にユーザーからの入力を収集し、後でプレイブックで使用します。")