Candidate List — End-User Help

Overview

The CandidateList.aspx page shows all candidates in the system and provides search, filtering, quick actions and bulk operations.

Use it to find a candidate, open their details, add a new candidate, or perform bulk actions (activate, archive, delete). The page includes single-row actions (Edit, Delete), a selection bar for multi-select tasks, confirmation dialogs and short success toasts.

Quick start (3 steps)

1. Search: Type into the search box and press Enter or click Search. You can search by candidate code, name or job.
2. Open a record: Click the candidate name in the list to view details. (Use Edit to go to the edit page.)
3. Bulk work: Use click, Ctrl/Cmd + click or Shift + click to select rows; then use the selection bar to Edit (single), Activate, Archive or Delete the selected candidates.

Top-level controls

• Search box (TxtSearch) — placeholder: “Search by code, name or job”. Press Enter to search or click Search.
• Clear button — resets the search input and filters.
• Show dropdown (DropDownStatus) — filters by All, Active, or Archived. Changing this value refreshes the list automatically.
• + New Candidate link — opens the create candidate page (AddCandidate).

Grid columns and what they mean

• Code — system candidate code/reference
• Name — candidate display name; click the link to view candidate details
• Job Applied — job or requisition the candidate applied to (free text or linked job)
• References — number of references recorded
• In Progress — number of reference checks currently in progress
• Verified — number of completed/verified references
• Stage — candidate pipeline stage
• Status — Active or Archived
• Created — date the candidate record was created
• Actions (per-row):
• Edit — open candidate edit screen
• Delete — prompts a confirmation to delete that candidate

Selecting rows (single and multi)

• Click a row to select it. Use:
• Shift + Click to select a range between the last selected and the clicked row
• Ctrl (Windows) / Cmd (macOS) + Click to toggle selection for individual rows
• Selected rows are highlighted.
• The page remembers selections across pages and keeps them in a hidden field (HiddenSelectedJobs) so you can select across pagination.
• To select all visible rows use the Select All link in the selection bar (selSelectAll).

Selection bar (bulk actions)

• Appears when one or more candidates are selected.
• Shows count (e.g., “3 selected”) and provides:
• Edit (only when exactly one candidate selected)
• Delete
• Activate
• Archive
• Tip shown in the selection bar: “Hold Ctrl/Cmd to toggle selection.”

Confirm dialogs & irreversible actions

• Delete, Archive and Activate actions show a confirmation card/modal to prevent accidental changes.
• Confirmations clearly state that deletes are permanent. Use the card buttons to proceed or cancel.
• Single-row Delete uses openDeleteJobConfirm(...) to populate the confirm dialog for that single ID.

Toasts, feedback and errors

• Short success messages appear as a slide-in toast (saveToast) in the top center: showToast(message, ms).
• Server-side errors are shown in the page error panel (ErrorPanel) or inline messages.

Use the close button (×) on the error panel to hide it.

Keyboard & accessibility tips

• Focus: The search box is focused when the page loads. Press Enter to run a search.
• Selection: Use keyboard modifiers for range and toggling selection (Shift and Ctrl/Cmd).
• Dialogs: Press Escape to close a confirm dialog or modal overlay.
• Screen readers: Toasts use aria-live="polite" so success notifications are announced.

Common tasks — step-by-step

Find a candidate by name

1. Type the name in the search box.
2. Press Enter or click Search.
3. Click the candidate Name to open details.

Add a candidate

1. Click + New Candidate
2. Complete the form on the add page and save.

Edit one candidate

• Click Edit for that row, or
• Select the row then click Edit in the selection bar (only shown for a single selection).

Delete one or several candidates

1. Select rows (click/Ctrl+click/Shift+click) or use the row Delete.
2. Click the selection bar Delete icon or confirm the per-row delete.
3. Confirm in the modal. Deletion is irreversible.

Archive/Activate candidates

1. Select the candidates.
2. Click the Archive (folder_off) or Activate (folder) icon in the selection bar.
3. Confirm in the card that appears.

Behavior across pages

• Selections persist across pages using HiddenSelectedJobs.
• After a postback or bulk action the selection state is preserved where possible and the page attempts to restore your active view.

Troubleshooting

Nothing happens when clicking a button

• Ensure JavaScript is enabled and not blocked by extensions.
• If the page posts back but the list does not update, check for a server-side error in ErrorPanel.

Selection disappears after paging

• Selections are stored in HiddenSelectedJobs. If selections look lost, ensure you didn’t clear them with Clear or change filters.

Bulk action affects more records than expected

• Before confirming, check the confirm card — it shows the number of selected candidates. Cancel if unexpected.

Toast not visible

• Toasts are client-side notifications; server redirects may prevent them. Confirm action success via list updates or server messages.

Best practices & tips

• Use Show filters to reduce list size before bulk operations.
• For destructive operations (Delete), double-check confirm dialog counts and selected items.
• Prefer Archive instead of Delete if you want to retain history but hide the candidate from active lists.

Privacy & data handling

• Candidate deletion is permanent and will remove the candidate and associated data. Use Archive if you need to retain data for compliance or audit.
• Make sure you have permission and lawful basis before deleting personal data.

Support & what to provide when asking for help

Provide:

• the exact search terms and filters used
• steps to reproduce (which buttons you clicked)
• any error text from ErrorPanel
• browser name/version and any script-blocking extensions

Short FAQ

Q: How can I select many candidates across pages?

A: Select rows on each page — selections are stored in HiddenSelectedJobs so you can accumulate selections across pages before acting.

Q: I archived someone by mistake — can I undo it?

A: Set Show to Archived, select the candidate and use Activate to make them Active again.

Q: Why does Delete sometimes remove all data?

A: Delete is permanent by design. Use Archive if you want to keep records but remove from active work lists.