Understand workforce rota recipient resolution

Understand exactly how v1.3.0 builds recipient lists for normal, amendment, cancellation and RTW-completion events.

What you need before you start

• Access to Admin Area → Human Resources → Workforce Rota & Notifications → Settings / Delivery Log.
• The Human Resource Management: View capability or administrator access.
• The correct employee, record, period or authorised evidence.

How to do it

1. Review configured recipient lists.
2. Confirm whether employee notifications are enabled.
3. Publish, amend or cancel a controlled test rota.
4. Review recipient email/type and status in Delivery Log.

What the module checks

• Published/weekly/ad-hoc events use standard rota recipients.
• Amendment/cancelled events use amendment recipients, falling back to standard list.
• Affected employee emails are added only when notify_employees is enabled.
• Employee work_email is preferred over personal email.
• Emails are lowercased/deduplicated during settings parsing.

What happens next

The module saves the permitted change and records the resulting status, version, delivery or synchronisation evidence. Reopen the relevant register and verify it.

Troubleshooting

• If the control is missing, confirm the required HRM permission and module version 1.3.0.
• If saving fails, correct the exact field or state named in the validation message.
• If an email/automation is missing, review the module delivery/audit log and host cron/mail settings.

Related guides