Skip to content

Positions (HCM) ​

This page documents the shipped Positions screen (hcm-employee) — managing job positions (as distinct from the people who fill them). Not for plugin developers.

Getting there ​

Under Organization / Job Architecture in the HCM menu ("Positions" and "Job Positions" both point to the same screen).

What you see ​

  • KPI cards: Total, Occupied, Vacant, Frozen — all real, live counts. "Occupied" means at least one active employee currently holds that position; it doesn't require the position's own status to say so.
  • Search and filter by Department, Status, Employment Type.
  • Bulk actions: Change Department, Change Status.
  • A grid with status chips and per-row quick actions.

Creating and editing a position ​

Add/Edit Position covers the position's department, job structure (designation, grade), reporting structure (who this position reports to), and workforce details. You can also set a Position Type (Regular, Temporary, Contract, Project, Seasonal, Internship, Apprentice, Consultant, Other).

Freezing a position ​

Freeze Position — and other status changes (on hold, cancelled, back to draft) — goes through an approval gate rather than applying immediately: changing status creates a pending request, not an instant change.

Position detail ​

Click a position to open a read-only detail view (separate from the Edit dialog) with four sections: Organization/Job Structure, Reporting, Workforce, and:

  • View Employee — jumps to the profile of whoever currently holds this position (hidden if it's vacant).
  • View History — shows every tracked change to this position (freezes, transfers, reclassifications, closures, manager changes), each with who requested it and its current status.
  • Edit Position / Freeze Position as above.

Known gaps ​

  • No Location field on positions — even though Location is tracked elsewhere in HCM, it's not yet a field on Position itself.
  • No budget tracking — there's no "is this position budgeted" flag or budget-approval integration with Finance.
  • Occupancy is shown as a simple vacant/occupied split, not a three-way "fully staffed / partially staffed / vacant" for positions that allow more than one headcount.
  • View History shows a summary, not a full itemized log — the latest change and a count, not a scrollable list of every past change.