Skip to main content

Departments, to which users must be attached, are used by the different Lucca solutions for different purposes:

  • Define access scopes: for example to restrict the visibility of absences in the Lucca Absences schedule.
  • Filtering data in a report: our different reports generally allow to filter data according to the legal entity, the SSC, but also the department of the user.
  • Build the organization chart in Lucca Core HR. The departments are represented as a hierarchical tree with a parent/child relationship.

NB: You can have up to 9 levels of departments, and up to 99 departments under a single parent department. However, limiting the number of levels to 7 is recommended.

​
name
string
Minimum string length: 1
​
code
string

Unique code of this department.

Minimum string length: 1
​
description
null | string

Optional description of the department.

​
parentId
string

Hierarchy ID of the parent department. Null if this department is at root-level.

​
parentLuccaId
null | integer
​
hierarchy
string

A value that describes where a department sits in the organization tree. It encodes the department’s position and parent/child relationships, allowing the system to determine ancestors, descendants, and ordering within the hierarchy.

You may refer to the Microsoft documentation about hierarchyid for more information.

You should treat it as an opaque hierarchical path value—use it only for storage, comparison, and API calls, and do not attempt to parse or construct it yourself.

Example hierarchyId values:

  • '/1/'
    • '/1/1/'
      • '/1/1/2/'
      • '/1/1/2.5/'
      • '/1/1/3/'
    • '/1/3/'
​
isActive
boolean
default:true

When false, then the department should no longer be used.

​
headId
null | integer

ID of the employee at the head of this department.

​
sortOrderInSiblings
null | integer
Required range: 0 <= x <= 99