---
id: SCR-PFM-DJE-006
title: Mass update dialog
route: 'Dialog over a record list (Update Fields, Activate, Deactivate)'
surface: console
product_area: platform
module: data-job-engine
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-crm: a8d1364f1dd44b723bb5f9acba12f983e9ec8d69
purpose: Preview and apply one field change across a selection of at most 500 records.
supports:
  - JNY-PFM-DJE-002
  - JNY-PFM-DJE-003
  - CAP-PFM-DJE-009
  - CAP-PFM-DJE-010
  - CAP-PFM-DJE-002
  - CAP-PFM-DJE-006
permission: >-
  the hosting list checks the record kind's bulk key; the service separately
  checks action permissions
entry_from:
  - SCR-PFM-DJE-005
exits_to:
  - SCR-PFM-DJE-004 (Open job)
  - The list it was opened from
displays:
  - field: Eligible metadata fields and their shared input controls
    source: >-
      the record kind's description from metadata and the operation's editable
      fields
  - field: Fixed change (Activate or Deactivate)
    source: the configuration list's preset
  - field: 'Preview counts for changes, unchanged records, blocks and conflicts'
    source: DOM-PFM-DJE-001 impact; getContactDataJob
  - field: 'Results (applied, unchanged, conflicts, rejections)'
    source: DOM-PFM-DJE-001 counters
actions:
  - label: Validate
    operation_id: submitContactDataJob
    permission: >-
      record kind bulk key (console gate); action authorization is enforced by
      the service
    confirm: false
  - label: Apply
    operation_id: applyContactDataJob
    permission: >-
      record kind bulk key (console gate); action authorization is enforced by
      the service
    confirm: false
  - label: Revalidate conflicts
    operation_id: revalidateContactDataJobConflicts
    permission: >-
      record kind bulk key (console gate); action authorization is enforced by
      the service
    confirm: false
  - label: Open job
    operation_id: 'none: opens SCR-PFM-DJE-004'
    permission: data.jobs.view
    confirm: false
states:
  - loading
  - error
  - read-only
validation:
  - BR-CAP-PFM-DJE-001-03
  - BR-CAP-PFM-DJE-002-02
  - BR-CAP-PFM-DJE-006-01
  - BR-CAP-PFM-DJE-006-03
  - BR-CAP-PFM-DJE-009-03
  - BR-CAP-PFM-DJE-009-04
  - BR-CAP-PFM-DJE-009-07
  - BR-CAP-PFM-DJE-009-08
  - BR-CAP-PFM-DJE-010-04
patterns:
  - Shared dialog header band
  - Set-fields editor and the wizard’s shared value controls
  - 'Shared validation, preview, execution and outcome panels'
component: components/data-management/data-jobs/dialogs/mass-update-dialog.tsx
evidence:
  - >-
    react-console at baf6dae3:
    components/data-management/data-jobs/dialogs/mass-update-dialog.tsx,
    dialog-parts.tsx, use-dialog-run.ts;
    components/data-management/data-jobs/new/set-fields-editor.tsx;
    acceptance/data-jobs/playwright/journeys/dialogs/**.
controls: [TC-AVL-001, TC-AVL-004, TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-CRY-001, TC-CRY-002, TC-CRY-003, TC-CRY-004, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-DAT-004, TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-PI-001, TC-PI-002, TC-PI-003, TC-PI-004, TC-PI-005, TC-PRV-001, TC-PRV-002, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---

# Mass Update Dialog

## Purpose and Behavior

The field editor uses record metadata and shared value inputs, including eligible custom fields. Configuration status actions provide a fixed change. Validation submits a job and displays its impact. Apply approves that preview; the results summarize changes, unchanged records, conflicts and refusals. Conflicting records can be revalidated. Open job navigates to the full detail. Closing the dialog does not cancel submitted work.

## States and Refusals

Validation and application show loading panels. Refusals retain an explanation, and stale approvals require another validation. The results panel remains readable after execution. Service permission checks remain authoritative even when the hosting menu offered the action.

## Console Patterns

The dialog uses the shared header band, field editor and validation, preview, execution and results panels.