レコード更新アクティビティ

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

    • 指定したフィールド値を持つレコードを更新します。

    ロールと使用可用性

    • このアクティビティは共通アクティビティとして利用できます。admin、playbook.admin、pd_author、または pd_author を持つユーザーは、このアクティビティを プレイブック に追加できます。

    入力

    アクティビティのプロパティパネルを開き、次の入力の値を追加するようにアクティビティを設定します。入力値が異なる場合は、ピルピッカーを使用して値を取得する場所を示します。ピルピッカーの詳細については、「Dot-walking examples」を参照してください。
    入力 タイプ 説明
    ラベル 文字列 アクティビティおよびプレイブックカードとして表示するタイトル。
    説明 文字列 アクティビティの使用状況または結果について表示する情報。
    実行条件 条件ビルダー アクティビティまたはステージを実行するために満たす必要がある条件。前のアクティビティのデータを使用して、条件を作成できます。
    注:
    このフィールドを表示するには、[他のオプションを表示] を選択します。
    開始ルール 選択肢 [ スケジュール > 開始ルールで、ステージの実行を開始するタイミングに関する開始ルールを選択します。
    • プロセスの開始時期：プレイブックが開始されるとすぐにステージの実行が開始されます。
    • 特定のステージの後(After specific stages)：指定したステージの実行が終了した後にステージの実行が開始されます。
    [スケジュール] > [開始ルール] で、アクティビティの実行開始タイミングに関する開始ルールを選択します。
    • ステージ開始時 (When stage starts)：ステージの実行が開始されるとすぐにアクティビティの実行が開始されます。プレイブックがトリガーされるとステージの実行が開始されます。
    • 特定のアクティビティの後(After specific activities)：指定したアクティビティの実行が終了した後にアクティビティの実行が開始されます。
    遅延から開始 True/False アクティビティまたはステージを実行する前に一定時間待機するオプション。有効にすると、この入力には 遅延入力プロパティから開始 が表示されます。
    注:
    このフィールドを表示するには、[他のオプションを表示] を選択します。
    テーブル テーブル名 更新するレコードを含むテーブル。
    レコード 参照 更新するレコードへの参照。
    フィールド テンプレート値 レコードの更新中に変更するフィールド値。
    ユーザー入力待ち 選択肢 エンドユーザーが手動でアクティビティを完了するかスキップするまで、プレイブックを一時停止するオプション。このフィールドを編集できるのは、playbook.admin ロールを持つユーザーのみです。デフォルトでは、アクティビティは完了する前にユーザーのアクションまたはデータを待機します。

    詳細入力

    アクティビティの必要な入力を設定した後に、追加の入力を設定することもできます。サイドパネルで、[他のオプションを表示] を選択して、これらの詳細入力を表示します。詳細については、「アクティビティエクスペリエンス」を参照してください。
    入力 タイプ 説明
    アサイン先グループ Reference.Group [sys_user_group] アクティビティに関連付けられているタスクの完了を担当するグループ。
    注:
    このフィールドを表示するには、[他のオプションを表示] を選択します。
    アサイン先 Reference.User [sys_user] アクティビティに関連付けられているタスクの完了を担当するユーザー。
    注:
    このフィールドを表示するには、[他のオプションを表示] を選択します。
    更新後に表示するフィールド 文字列 更新されたレコードに表示するフィールドのカンマ区切りリスト。

    出力

    これらの出力は、プレイブック内の他のアクティビティにデータを提供できます。アクティビティを設定するときに、アクティビティ入力としてこのデータにアクセスできます。
    出力 タイプ 説明
    テーブル テーブル名 更新されたレコードを含むテーブル。
    レコード ドキュメント ID 更新されたレコードへの参照。

    デザインの検討

    プレイブックにレンダリングするアクティビティのフォームビューを作成する
    ユーザーがレコードを更新するために必要なフィールドのみを表示するには、フォームビューを使用します。ビューには、必須フィールドまたは他のビジネスロジックによって検証されるフィールドが表示されます。「ビューの管理」を参照してください。
    インタラクティブアクティビティの前に非インタラクティブアクティビティを実行する
    [レコードを更新] アクティビティはユーザーからデータをインタラクティブに収集しますが、プレイブックが依存アクティビティを開始できないようにします。たとえば、[レコードを更新] アクティビティは、他のステージにある可能性がある [前回の後] アクティビティが開始されないようにします。可能な場合は、非インタラクティブアクティビティが、それをブロックする可能性があるインタラクティブアクティビティの前に実行されるようにプレイブックを設計します。