Spark ERP Docs

Appearance

Holiday Calendar (HCM) ​

This page documents the shipped Holiday Calendar screen (hcm-foundation) — where HR sets up one or more holiday calendars (e.g. one per country or office location) and the holidays on them. Not for plugin developers.

Who this is for: HR staff setting up and maintaining company holidays.

Getting there ​

Under Core HR / Administration in the HCM menu.

What you see ​

  • KPI cards at the top with real counts for your tenant.
  • A month calendar grid, with each holiday shown as a colored event by type.
  • A Holiday Summary donut chart.
  • Upcoming Holidays and Calendar List panels.

On mobile, KPI cards go to 2-across (4-across on tablet/desktop) and the calendar/summary and upcoming/list panels stack full-width instead of sitting side by side. It's the same underlying data on web, Studio, and the mobile app — not a cut-down mobile version.

Adding holidays ​

  • Add Holiday — add one holiday by hand: name, date, type, and which calendar it belongs to.
  • Create New Calendar — set up a new calendar (e.g. for a new country or office).
  • Import Holidays — upload a real Excel file. It's saved into your tenant's document storage (a "HR Imports" folder, created automatically the first time you use this) and then read on the server to create real holiday entries — this isn't a preview or a template, it actually adds the holidays from your file.

Exporting ​

A real Export button downloads the calendar as an Excel file you can open, print, or share.

Use the month grid's own built-in Previous/Next/Today controls (there's no separate toolbar for this — just the calendar itself).

Known gaps ​

  • No Location or Status filter in the toolbar — only Calendar and Type filters are wired up.
  • Holidays can't yet be scoped to a specific employee group — a holiday applies calendar-wide, not to a subset of employees.
  • "Calendar List" has no separate management screen — you can see the list of calendars here, but there's no dedicated page yet to edit or organize them beyond what Create New Calendar and Add Holiday already cover.
  • Imported files always land in a fixed "HR Imports" folder — you can't choose a different destination.