Перейти к основному содержимому

E-mail digests & alerts

Path: HR Analytics Subscriptions, Organizational Unit card → HR Analytics FactBox

Beyond the on-screen indicators, HR Analytics can push results to people by e-mail: scheduled digests and immediate alerts. This keeps managers informed without opening Business Central.

Subscriptions​

A subscription says who receives what and how often. Manage them on the HR Analytics Subscriptions page (admins see all; each user sees a "My subscriptions" view). There are three types:

TypeWho gets itContent
User DigestA named userThe indicators flagged Include in Digest, in their configured order — the same composition as the Monthly Digest indicator.
Unit Manager DigestThe manager of an organizational unitThat unit's Department Report Card, including rolled-up child units (sent for the units that have a card — see the Org. Unit Group Level note in Composite analytics). The recipient is resolved at send time from the unit's Manager No., so changing the manager is picked up automatically.
Critical AlertA named userA consolidated message when indicators cross into a chosen severity.

Each subscription carries:

  • Frequency (digests) — On Period Close, Weekly, or Monthly.
  • Minimum Severity (alerts) — send when an indicator reaches at least this severity (default Critical).
  • Recipient E-Mail Override — an explicit address, otherwise resolved from the user/employee record.
  • Language Code — the digest is rendered in the recipient's language.
  • Include Payroll Amounts — admin-editable only. Because background sending cannot check the recipient's permissions the way a screen can, including salary amounts in e-mail is an explicit, per-subscription decision. By default salary indicators are excluded from e-mails.
  • Include AI Summary — prepends an AI-generated narrative to the digest.

Handy actions: Subscribe all unit managers (creates a Unit Manager Digest for every unit that has a manager — idempotent), Preview e-mail (shows the e-mail the selected subscription would receive now, rendered as the recipient sees it, with the recipient address — nothing is sent) and Send test e-mail (sends it immediately). For a Critical Alert subscription, the preview and the test e-mail list every current result at or above its Min. Severity, as if they had all just crossed it; a test alert does not change which real alerts are sent later.

How delivery works​

  • User & Unit Manager digests are composed and mailed by the background job on their schedule (or when a payroll period is closed, for On Period Close). Each line shows the indicator, a trend arrow and a severity colour. Person-level indicators are never e-mailed; salary indicators are skipped unless Include Payroll Amounts is on.
  • Critical alerts fire when an indicator's severity transitions into the chosen level after a calculation — you get one consolidated e-mail per run, not one per indicator. Severities that stay the same or improve are silent.
  • Sending uses the standard Business Central Email setup — the same SMTP account selection as the rest of SMART Payroll's employee mailing. No separate mail configuration is needed.
  • Delivery is error-isolated per recipient: one bad address cannot stop the batch. Failures are recorded on the subscription's Last Send Status and in telemetry.

What the e-mail looks like​

Digests and alerts share one layout that reads well in Outlook and on phones: a header band with the company name and the e-mail title (blue for digests, red for critical alerts), a greeting, then one row per indicator with a coloured bar for its severity and a trend arrow (▲ up, ▼ down, ● no comparison). A unit manager's report card is shown as a title row with the unit's score followed by one row per figure. The AI summary, when enabled, appears above the indicators with its headings and highlighted phrases formatted. The footer states the as-of date. A custom body template that places %[KpiLines] gets the same indicator rows.

Customizing the e-mail text​

The subject and the wrapper text of digest and alert e-mails can be tailored without code. Open Communication setup from the Subscriptions page (admins only). It has two parts:

  • AI Prompts — optional overrides of the prompt used to generate the AI digest narrative and HR Insights Q&A. Leave blank to use the shipped prompt. Keep the %1/%2 placeholders (company name and language) so they are still inserted. A single prompt serves every language — the model is always told to answer in the recipient's language.
  • E-Mail Templates — per-language overrides of the e-mail. Add a row for an E-Mail kind (Digest or Alert) and a Language, then open it to set a custom Subject and design the Body in a rich-text editor (bold, colours, lists, links, a logo). The override is used when the e-mail is rendered in that language; with no row — or with an empty field — the shipped default (already translated into every supported language) is used. The same Digest override applies to both User and Unit Manager digests.

When you design a custom Body, you control the whole layout, so tell us where the generated content goes by typing these placeholders (paste them as plain text so formatting does not split them):

PlaceholderMeaning
%[KpiLines]The indicator lines — the gated, formatted content. Include this or the body shows no indicators.
%[AISummary]The AI narrative block (digest only; empty when AI is off or for a manager digest).
%[CompanyName]The company name.
%[AsOfDate] / %[PeriodEnd]The "as of" date of the digest.
%[RecipientName]The recipient's display name (the unit manager for a manager digest).
%[UnitName]The organizational unit name (manager digest).
%[AlertCount]Number of indicators in a critical alert.

The Available placeholders action (on the template list and card) shows the list above with a description of each, filtered to the e-mail you are editing — so you don't have to remember them. The indicator lines themselves stay gated and formatted by the module — you style the wrapper, not the protected indicator content. E-mail clients (especially Outlook) support only a subset of HTML/CSS, so keep the design simple and use Send test e-mail to check it. A logo is best linked by URL rather than embedded, to keep the message small.

Organizational Unit FactBox​

The Organizational Unit card (and list) shows an HR Analytics FactBox that renders the unit's Department Report Card: the score, then one line per figure — the analytic's name and the unit's value with its trend arrow and change against a quarter ago, coloured by the unit's severity for that analytic — with a grey line below it comparing the figure with the company (the company value, or the unit's share of the company total), then a recommendation and the "as of" date. If the module is not set up yet, the FactBox prompts you to set up HR Analytics. Drill-down on the score opens the Overview filtered to that unit.

See Also​

© 2008 - 2026 SMART business