RCA Dashboard — End-User Help

Overview

The RCADashboard.aspx page is the central reference-check dashboard.

It shows high-level KPIs (pending requests, reminders, sent today, failed sends) and provides quick navigation cards to the main workflow areas: jobs, candidates, reference checks, custom forms, branding and retention settings.

The page is responsive and works on desktop and mobile browsers. JavaScript is used for cross-tab sign-out propagation and for client UX; server navigation and data come from the backend.

> RCA = Reference Check App

Quick start

• Read the KPIs at the top to see system status:
• LblPending — Pending requests
• LblReminders — Reminders scheduled in the next 7 days
• LblSentToday — Sent today
• LblFailed — Failed sends (last 24h)
• Click a card to jump to the area you need:
• New Job → NewJob
• Jobs List → JobsList
• New Candidate → AddCandidate
• Candidates List → CandidateList
• New Reference Check → SendReferenceRequests
• Reference Checks List → VerificationsList
• New Reference Check Form → NewVerificationForm
• Reference Check Forms → VerificationForms
• Custom Branding → CustomBranding
• Data Retention Policy → RetentionPolicies

KPI tiles — what they mean

• Pending requests (LblPending): number of verification requests awaiting completion or action
• Reminders (next 7d) (LblReminders): requests with reminders scheduled within the coming week
• Sent today (LblSentToday): messages successfully sent in the current day
• Failed sends (24h) (LblFailed): messages that failed delivery within the last 24 hours — check mail queue/logs or retry workflows if high

Navigation cards (app cards)

• Each card is an anchor element styled as an interactive tile (.app-card). Click anywhere on the tile to navigate.
• Cards are grouped by area:
• Manage Jobs & Candidates
• Reference Checks & Forms
• Branding & Data Retention
• Locked or permissioned cards may show a lock-icon overlay (.lock-icon).

If you see a lock, you likely lack permission — contact your administrator.

Layout & responsiveness

• Desktop grid: 4 columns (.dashboard-row)
• Tablet: 2 columns at widths ≤ 768px
• Mobile: single column at widths ≤ 480px
• The page header, KPI row and cards scale to available screen width.

Cross-tab sign-out behavior

• The page listens for a cross-tab message channel named app-role-change (via BroadcastChannel) and a localStorage fallback key app_signout.
• If a signout message is received (e.g., role change or session invalidation), a prompt alerts you and the page redirects to:
• https://hub.knewte.com/Account/SignIn
• Global helper: window.broadcastSignOut(reason) can be called by other pages to notify open tabs.

Accessibility & keyboard

• Card anchors are focusable links — use Tab to navigate and Enter to activate.
• Cards include visible focus states via browser default outlines.
• Responsive layout keeps content readable on small screens.

Common tasks — step-by-step

• Open the Jobs list: Click the Jobs List card.
• Start a new reference check: Click New Reference Check.
• Create a custom form: Click New Reference Check Form.
• Change branding: Click Custom Branding to update banner and button colours.

Troubleshooting

KPI values look wrong or stale

Refresh the page to fetch current counts. If still incorrect, report the time and the KPI name.

A card click does nothing

Confirm JavaScript is enabled and no script blocker prevents navigation. Try right-click → Open in new tab.

Pages show a lock or “access denied”

You need higher privileges — contact your administrator with your username and the blocked card name.

Unexpected sign out across tabs

Another tab broadcast a signout (role/session change). If unexpected, contact admin/security and provide the timestamp.

Support — what to provide

Provide:

• which KPI or card is affected
• screenshot or exact text shown
• browser/version and any extensions (ad-blockers, privacy tools)
• if sign-out related: approximate time and behavior observed

Short FAQ

Q: Why does the page redirect me to sign-in in another tab?

A: The app broadcasts a sign-out (role/session change) to all open tabs so you must re-authenticate.

Q: Where do the KPI numbers come from?

A: They are populated server-side when the page renders; refresh to update them.

Q: How do I open a card in a new tab?

A: Right-click the card and choose “Open link in new tab”, or focus it and use Ctrl/Cmd+Enter.