Reference Details Request — End-User Help
Overview
This page (ReferenceRequested.aspx) is the secure form referees use to provide contact details or full reference responses for a candidate.
The page is dynamic: the form fields are rendered into the placeholder phForms by the server. JavaScript is used for optional client validation and UX; the server performs final validation and persistence.
Quick start
- Confirm the candidate and role shown in the blue context block (PanelCandidate) match the request.
- Fill each reference block shown in the form. For every reference you must supply:
- Full Name (required), and
- at least one contact: Work Email OR Phone
- Click Submit Reference(s) (btnSubmit).
- On success you will see a confirmation message.
- Server errors appear in the error area (ErrorPanel / LabelErrorMessage) and ValidationSummary1.
What you see on the page
- Header: page title inside HeaderPanel
- Candidate context: PanelCandidate shows
lblCandidateName and lblRoleTitle (when available) - Requirements box (RequirementsPanel): minimum data required (Full Name, Work Email recommended, at least Email or Phone)
- Validation summary (ValidationSummary1): server-side validation errors shown as a bulleted list
- Dynamic form area: phForms contains one or more reference sections generated by the server
Each reference section includes inputs named like txtFullName_<n>, txtEmail_<n>, txtPhone_<n>, etc.
- Action buttons:
btnSubmit — Submit Reference(s) (server postback)btnClear — Clear form (no validation)
Client-side validation (optional)
There is an optional client validator script at the bottom of the page. By default it is disabled: the script sets ENABLE_CLIENT_VALIDATION = false.
If enabled by an administrator, it checks each reference before submit:
- Full Name is present
- at least Email or Phone is present
- email format using a simple regex
If checks fail it shows messages inside ErrorPanel (LabelErrorMessage) and prevents submit.
Server-side validation & messages
Final validation happens on the server.
Use ValidationSummary1 and ErrorPanel to see problems returned by the server (missing required fields, invalid email format, or other business rules). Correct the indicated fields and resubmit.
On success the page displays PanelOk (green message) or similar confirmation.
Important field rules & tips
- Full Name — required for each reference (
txtFullName_<n>) - Work Email — highly recommended and often required by organisational workflow; must be valid format if provided
- Phone — acceptable alternative when email is not available; include international code where possible (e.g., +44...)
- Company Website — suggested to speed verification
- Keep answers concise and factual; the page footnote clarifies data use
Accessibility & browser notes
- The form uses standard input controls and is keyboard accessible.
- JavaScript should be enabled if optional client validation or other client UX features are used.
The server still validates and can accept submissions without client JS (server validation still applies).
- Success/error messages use PanelOk / PanelErr and ValidationSummary1; screen readers will announce inline text.
Common tasks — step-by-step
Submit a single reference
- Complete Full Name and Work Email (or Phone).
- Click Submit Reference(s).
- If accepted, you will see confirmation; otherwise, correct errors and retry.
Clear the form
- Click Clear (btnClear) to reset values (no validation).
Troubleshooting
Submission blocked with “Please provide at least Email or Phone.”
Provide either a valid email or a phone number for that reference and resubmit.
Email appears valid but submission still fails
Check ValidationSummary1 and ErrorPanel for the exact server message. Copy the message when contacting support.
Nothing happens when clicking Submit
Ensure your browser allows JavaScript and the page is not blocked by extensions. If JavaScript is disabled, the server-side handler should still process the postback — reload and try again.
Page shows no form fields
The server populates phForms. If it’s empty, the request may be expired or invalid. Contact the organisation that sent the request and provide the request link or HiddenRequestId value.
Privacy & use of your data
The page shows a footnote: “Your details will be used only for the purpose of providing a reference.”
The information you provide will be used per the requesting organisation’s privacy policy. Do not include unrelated sensitive personal data.
If you need help
When contacting support provide:
- exact error text from ErrorPanel or ValidationSummary1
- candidate name and role shown (
lblCandidateName, lblRoleTitle) - request identifier if possible (HiddenRequestId)
- screenshot of the form and visible error messages
Short FAQ
Q: Can I submit without an email?
A: Yes — but you must supply a phone number. Email is recommended.
Q: My email looks valid but the page rejects it — why?
A: The server may apply stricter validation or business rules. Check ValidationSummary1 and retry with a corrected address.
Q: The form disappeared or link expired — what now?
A: Contact the requester (recruiter) and ask them to reissue the reference request link.