Data Import Workflow
A data import workflow checks an uploaded file, matches its columns, previews changes, and reports every import result.
Another example
An admin maps a CSV email column, finds two bad rows, and imports the other 98 rows as one background job.
Main parts
- 01Source file
- 02Field mapping
- 03Validation rules
- 04Change preview
- 05Background job
- 06Row-by-row result
Use it when
Use it when people need to move many records from a file into an app safely and visibly.
Do not use it when
Do not import before showing the mapping and result counts. A retry must not create the same successful rows twice.
Name used in code
upload → map → validate → preview → background import → row results Before you ship
Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states.
Outcome: Use Data Import Workflow to solve this user need without losing the current context. User context: An admin maps a CSV email column, finds two bad rows, and imports the other 98 rows as one background job. Recommended pattern: Data Import Workflow. Why it fits: Use it when people need to move many records from a file into an app safely and visibly. Do not use it when: Do not import before showing the mapping and result counts. A retry must not create the same successful rows twice. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): No single official standard controls the whole term. Its meaning may change across teams, platforms, or frameworks. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Check this request
Review the current use of Data Import Workflow. Definition: A data import workflow checks an uploaded file, matches its columns, previews changes, and reports every import result. Release checks: Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.