Getting started with HR Analytics
Path: Assisted Setup → Set up HR Analytics
This page explains how to switch the module on, from nothing to a Role Center full of live indicators, in a few minutes.
Prerequisites
- SMART Payroll is configured and contains data (employees, contracts, timesheets, and — for payroll indicators — a posted payroll ledger).
- The user running the setup has the
SMA_HRA_ADMINpermission set (see Permissions below).
Step 1 — Run the Assisted Setup wizard
Open Assisted Setup (search with Alt+Q for "Assisted Setup") and choose Set up HR Analytics. The wizard walks you through:
- Welcome — a short description of what the module does.
- Group selection — tick the analytics families you want (Workforce, Absence, Payroll, Working Time, Military Registration, Social & Medical, Composite, Anomalies). All are on by default except person-level analytics, which stay off for privacy.
- Common parameters — settings applied to every indicator the wizard creates:
- an optional Organizational-Unit filter to limit the whole module to part of the company,
- the Minimum Group Size used for anonymity (small groups are merged into an "Other" bucket),
- the recommended refresh frequencies (accept them unless you have a reason to change).
- Generation — the wizard creates one analytics instance per shipped indicator in the selected families, using each indicator's recommended defaults, enables them, and starts the background scheduler.
- Finish — links to the Setup list and the Overview, and offers Calculate all now.
The wizard is idempotent: running it again skips indicators that already exist, so it is safe to re-run after upgrades.
You can achieve the same result without the wizard: on the HR Analytics Setup list use the action Create recommended setup….
Step 2 — Let the indicators calculate
A background Job Queue entry (category HRANALYTIC) runs on a 15-minute heartbeat and recomputes each indicator when it is due, according to its refresh frequency (Hourly / Daily / Weekly / Monthly / On Period Close). You do not have to wait for it:
- Calculate all now on the wizard's Finish step, or
- Recalculate Now on the Setup list / Overview for a single indicator.
Until an indicator has been calculated for the first time it has no result to show. After that, the Overview always shows the last successful snapshot — even while a fresh calculation is running, and even if a calculation fails (stale-but-visible is preferred over empty).
Step 3 — Read the results
- Open HR Analytics Overview for the full readable list.
- Open the HR Manager or Payroll Administrator Role Center for Headlines, cue tiles and charts.
See Reading the results for how to interpret what you see.
Permissions and privacy
The module ships three permission sets (in addition to the normal SMART Payroll sets):
| Permission set | Grants |
|---|---|
SMA_HRA_VIEW |
Read indicators: Overview, Headlines, cues, charts. |
SMA_HRA_PERSON |
Additionally read indicators that can identify a single person (person-level analytics). |
SMA_HRA_ADMIN |
Configure indicators, recalculate, run the scheduler and the wizard. |
Two further rules protect sensitive data automatically:
- Payroll-amount gating — indicators that expose salary amounts are hidden (everywhere: headlines, cues, charts, Overview) from users who cannot read the payroll ledger. This is checked dynamically, so it also applies to any future role centers.
- Person-level privacy — indicators that could single out a person ship disabled; group breakdowns merge groups smaller than the Minimum Group Size into an "Other" bucket so individuals cannot be re-identified.