New Job — End-User Help

Overview

The New Job page (NewJob.aspx) lets you create a job/requisition record used when collecting candidates and linking references.

Use the form to capture the job title, description, location, salary guidance, employment type, status and any admin notes. JavaScript is used only for the slide-in toast; saving and validation are handled server-side.

Quick start (30–60 seconds)

1. Enter a clear job title in txtJobTitle (required).
2. Fill txtDescription, txtLocation and txtSalaryRange as appropriate.
3. Choose ddlEmploymentType and ddlStatus.
4. Click Save (btnSave) — on success a short toast appears; on failure the ErrorPanel displays details. Use Clear Form (btnCancel) to reset the page.

Field reference

• Job Title (txtJobTitle) — Required. Short, searchable title (max 100 characters). Use consistent naming so recruiters can find it easily.
• Description (txtDescription) — Multi-line job description, responsibilities and required skills. Use paragraphs or bullet lines for readability.
• Location (txtLocation) — City, region or “Remote”. Example: London, UK or Remote (UK).
• Salary Range (txtSalaryRange) — Human readable guidance (e.g., £45,000–£55,000 or Competitive). Informational — use consistent format across jobs.
• Employment Type (ddlEmploymentType) — Select one (Full-time, Part-time, Contract, Temporary, Internship). Helps filtering and expectation setting.
• Status (ddlStatus) — Job lifecycle:
• Open (actively recruiting)
• On Hold (paused)
• Closed (filled/removed)
• Notes (txtNotes) — Private admin notes, internal instructions or interview scheduling hints.

Buttons / UI behavior

• Save (btnSave) — server postback to btnSave_OnClick.
• On success: a slide-in toast appears (saveToast); the server may redirect or show a success panel.
• On error: ErrorPanel (LabelErrorMessage) shows validation/save errors.
• Clear Form (btnCancel) — runs btnCancel_OnClick and clears the form (no validation).
• Error panel (ErrorPanel) — visible when server-side validation or save errors occur.
• Toast (saveToast) — brief visual confirmation; uses aria-live="polite".

Validation & expected errors

• Required: txtJobTitle must be populated.
• Length limits: follow field MaxLength values (title 100, location 200, salary 100).
• Server-side validation may enforce additional business rules (e.g., unique job code or required internal metadata). If you see an error, read LabelErrorMessage and correct the input.

Best practices & content tips

• Job Title: concise and searchable — include level and function (e.g., “Senior .NET Developer — Backend”).
• Description: 2–3 summary lines, then key responsibilities and must-have skills (plain text).
• Location: if remote, include timezone/country (e.g., “Remote — UK time zone”).
• Salary Range: consistent currency and formatting; avoid ambiguous abbreviations.
• Employment Type & Status: keep accurate so lists and reports stay correct.

Accessibility & keyboard tips

• Standard form controls support keyboard navigation (Tab / Shift+Tab).
• Toast uses aria-live="polite" so screen readers announce success.
• Labels are present for each control to support assistive technologies.

Examples

• Title: Senior Software Engineer (C#/.NET)
• Description:
• Backend engineer for our payments platform.
• Design scalable APIs; own feature delivery; mentor junior engineers.
• Location: Manchester, UK or Remote (GMT)
• Salary Range: £60,000–£75,000

Troubleshooting

Save fails with ErrorPanel message

Read the exact message in LabelErrorMessage, correct the fields indicated, then Save again.

If unclear, copy the message and contact support.

Toast does not appear after save

The save may have redirected or returned a different UI. Confirm the job was created by checking the Jobs list. JavaScript must be enabled for toast animation, but save itself is server-driven.

Job not visible in lists after save

Check Status (e.g., Closed or On Hold) and list filters. Refresh the Jobs list page.

Privacy & governance

• Do not put sensitive personal data in job descriptions or notes.
• Follow your organisation’s policies for publishing salary and job location.

Support & what to provide

Provide:

• steps you took and values entered
• any error text from ErrorPanel
• browser name/version and any script-blocking extensions

Quick FAQ

Q: How do I cancel without saving?

A: Click Clear Form (btnCancel) — it clears current entries.

Q: Can I enter HTML in the description?

A: No — use plain text and line breaks. HTML will typically be stored/displayed as text.

Q: How do I mark a job as not currently recruiting?

A: Set Status to On Hold or Closed.