---
id: SCR-PFM-DJE-008
title: Reading the selected records
route: Dialog over saved query results when every matching record is chosen
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
purpose: >-
  Collect a bounded selection from saved-query pages before opening the chosen
  bulk action.
supports:
  - JNY-PFM-DJE-002
  - CAP-PFM-DJE-009
permission: the record kind's bulk key (as for the action chosen)
entry_from:
  - SCR-PFM-DJE-005 (saved-query all-matches selection)
exits_to:
  - SCR-PFM-DJE-006
  - SCR-PFM-DJE-007
  - SCR-PFM-DJE-003
displays:
  - field: Records matched and records read so far
    source: 'the saved query''s results, read a page at a time'
  - field: 'The 10,000-record limit notice'
    source: the console's selection limit
actions:
  - label: Cancel
    operation_id: 'none: stops reading'
    permission: none
    confirm: false
  - label: Try again
    operation_id: 'none: reads the query pages again'
    permission: none
    confirm: false
states:
  - loading
  - error
validation:
  - BR-CAP-PFM-DJE-009-05
  - BR-CAP-PFM-DJE-009-06
patterns:
  - Shared dialog header band and collection progress indicator
  - Read-failure alert with retry
component: components/data-management/data-jobs/bulk/collect-selection-dialog.tsx
evidence:
  - >-
    react-console at baf6dae3:
    components/data-management/data-jobs/bulk/collect-selection-dialog.tsx,
    data-job-bulk-actions.tsx; lib/api/data-jobs/selection.ts;
    acceptance/data-jobs/playwright/journeys/dialogs/DJE-ACC-0101.spec.ts,
    DJE-ACC-0114.spec.ts.
controls: [TC-AVL-001, TC-AVL-004, TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-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-MON-002, 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]
---

# Reading The Selected Records

## Purpose and Behavior

The dialog reads pages sequentially, removes duplicate identifiers and reports collection progress. It limits collection to 10,000 records and also bounds page traversal. Cancel stops collection; Try again starts a fresh read after failure. Once collected, the identifiers are handed to the dialog or wizard for the chosen action.

## States and Refusals

A failed page produces an error with retry. Collected identifiers become fixed input after collection, but separate page reads do not establish a common point-in-time snapshot of the query results.

## Console Patterns

The implementation uses the shared dialog header band, progress bar and error alert.
