Jobs List — End-User Help

Overview

This page (JobsList.aspx) shows all jobs (requisitions) and provides search, filtering, row actions and simple bulk operations.

Use it to find a job, create a new job, edit or delete jobs, and perform multi-select actions with confirmation. JavaScript must be enabled for selection helpers, confirm overlays and the toast.

Quick start

1. Search: type into TxtSearch and press Enter or click Search (BtnSearch).
2. Open/Edit: click the job Title (or Edit) to open the job editor (NewJob / edit URL generated by EditJobUrl).
3. Delete: click Delete on a row, or select rows and use the selection bar Delete icon. Confirm in the modal.

Top-level controls

• Search box: TxtSearch — placeholder “Search by title, location or type”. Focused on load.
• Search button: BtnSearch — runs server search (btnSearch_Click).
• Clear button: resets search input.
• Show filter: DropDownStatus — filter by All, Open, On Hold, Closed

(AutoPostBack → ddlStatus_SelectedIndexChanged)

• + New Job link — create a new job.

Grid columns & actions

• gvJobs grid columns:
• Title (JOBTITLE)
• Location
• Type (EMPLOYMENT_TYPE)
• Status
• Candidate count
• Created (date/time)
• Action column:
• Edit link (lnkView)
• per-row Delete (lnkDelete) which calls openDeleteJobConfirm(jobId) client-side to open a confirm card
• Sorting & paging: supported via server handlers gvJobs_Sorting and gvJobs_PageIndexChanging

Selection and bulk actions

Row selection

• Click a row to select.
• Shift + Click selects a range.
• Ctrl (Windows) / Cmd (macOS) + Click toggles individual rows.
• Selection is indicated with CSS class grid-row-selected.
• Selections persist across pages using hidden field HiddenSelectedJobs.
• Row click handler rowClick(row, evt) merges visible selection into the hidden store.

Selection bar

• Appears when one or more items are selected (selectionBar)
• Shows count (selectedCount) and provides:
• Edit (LinkButtonEdit) — visible when a single item is selected
• Delete (lnkDeleteSelected) — opens the confirm card
• Select All (selSelectAll) — selects all visible rows on the current page (selectAllVisible())
• clearAllSelections() clears both UI and hidden selection state

Delete confirm & workflow

Triggering delete

• Per-row: lnkDelete uses OnClientClick="event.stopPropagation(); return openDeleteJobConfirm('{JOBID}');"
• Bulk: lnkDeleteSelected calls openDeleteJobConfirm() then confirmDeleteJob() posts back to server (__doPostBack to lnkDeleteSelected.UniqueID)

Confirm card

• Overlay: overlayConfirmJob
• Confirm dialog: confirmDeleteJobCard
• Confirm closes the dialog and performs the server postback
• Server-side handler uses HiddenSelectedJobs to know which job(s) to delete

Cancel

• closeDeleteJobConfirmAndClear() hides the dialog and clears selection to avoid accidental repeat operations

Client helpers & APIs (for reference)

• updateSelectionBar() — updates bar visibility/count; toggles wrapper padding class has-selection-bar
• updateHiddenFromSelectedRows() / _rebuildHiddenFromSelection() — sync UI selection into HiddenSelectedJobs
• selectAllVisible() — selects all rows on current page and updates the hidden field
• clearAllSelections() — clears UI and hidden field
• openDeleteJobConfirm(jobId) / closeDeleteJobConfirm() / confirmDeleteJob() — confirm modal lifecycle
• showToast(message, ms) — slide-in success toast (top center)

Keyboard & accessibility

• Search: Enter in TxtSearch triggers BtnSearch (script on window.onload)
• Selection: Shift + Click (range), Ctrl/Cmd + Click (toggle)
• Dialogs: press Escape to close the confirm overlay
• Toast: uses aria-live="polite" for assistive tech announcements
• Interactive elements are keyboard focusable (buttons/links/server controls)

Behavior across pages

• Selections persist across pagination via HiddenSelectedJobs.
• After postback operations the page attempts to re-run updateSelectionBar() so UI state remains consistent.

Validation & common errors

Nothing happens on Delete

• Ensure JavaScript is enabled and not blocked.
• If confirm opens but server does nothing, check server-side lnkDeleteSelected handler for errors.

Selection count mismatches

• Confirm card counts HiddenSelectedJobs.
• If you changed visible selection but it did not sync, re-select or use selection helpers.

Sorting/Paging issues

• These are handled server-side by gvJobs_Sorting and gvJobs_PageIndexChanging; ensure postbacks complete.

Troubleshooting

• No results from search: try broader terms or clear filters (DropDownStatus)
• Selection lost after full reload: hidden field persists only within the session/page lifecycle — navigating away clears it
• Toast not displayed: page may redirect; confirm via grid updates or server messages

Examples & tips

• Delete a single job safely:
• select the row → click Delete → confirm message shows “1 selected job will be deleted” → confirm
• Delete many jobs across pages:
• select items on page 1 → go to page 2 and select more → open confirm card → count reflects accumulated selections

Support — what to provide

Provide:

• exact steps you took (which rows selected, which button clicked)
• screenshots of confirm dialog / selection bar
• browser/version and any script-blocking extensions active