Skip to main content

Departments

A Department is a node in the organization hierarchy. Nodes are typed as Department, Section, or Unit and form a tree used across the platform.

Path: Sidebar ← Organization ← Department
Pages: /Entities/ORG/Department · /Entities/ORG/Department/{id}

What a Department does for your business​

  • Models the org chart as Department → Section → Unit
  • Assigns a manager and optional cost / profit centers
  • Shows child structure and linked employees on the tree and record screens
  • Supports Insights, Activities, Attachments, and Logs on the record page

Views​

ViewDefault?Purpose
TreeYesHierarchy with level chips (department / section / unit)
ListNoFlat table with filters
Record (Id)—Full details for one node

List columns​

ColumnMeaning
NameNode name
ManagerManager user
EntityTypeDepartment / Section / Unit (and related type)
ParentParent node
ActionsRow actions

List filters​

FilterUse
NameSearch by name
EntityTypeIdFilter by type
EntityStatusIdFilter by status
ParentIdFilter by parent

Tree form fields​

Primary create/edit UX is the tree form.

FieldRequiredUse
Name (name)YesDisplay name
Arabic name (nameAr)NoArabic display name
DescriptionsNoOptional text
ManagerUsrIdNoManager user
ParentIdNoParent node (empty for top-level)
EntityTypeIdNo on tree form*Entity type
EntityStatusIdNo on tree form*Entity status
CostCenterIdNoCost center link
ProfitCenterIdNoProfit center link

*On SaveDetails, EntityTypeId and EntityStatusId are required.

Tree tabs​

TabPurpose
DetailsIdentity and links for the selected node
StructureChild nodes
EmployeesEmployees linked to this node

Record page (Id)​

Page: /Entities/ORG/Department/{id}

AreaPurpose
DetailsNode fields
ActivitiesActivity stream
AttachmentsFiles
LogsChange history
InsightsInsights panel

Actions​

ActionMeaning
Create top-levelAdds a root department
Add childAdds a section or unit under the selected parent
EditUpdates the selected node
DeleteRemoves a node only if it has no children
Cannot delete with children

If the node has children, delete is blocked and the UI shows a toast. Remove or re-parent children first.

Usage​

  1. Open Departments from Organization
  2. Prefer the Tree view for hierarchy work
  3. Create a top-level department, or select a parent and add a child
  4. Fill Name; add Arabic name, manager, type, status, and finance links as needed
  5. On SaveDetails flows, ensure EntityTypeId and EntityStatusId are set
  6. Use Structure and Employees tabs on the tree; open {id} for Activities, Attachments, Logs, and Insights
  7. Switch to List when you need filters by type, status, or parent

Best Practices​

Name the level clearly

Use EntityType so Department, Section, and Unit stay distinct in the tree and list.

Plan deletes from the leaves

Delete leaf nodes first. A parent with children cannot be deleted.

Finance links are optional

CostCenterId and ProfitCenterId are optional; fill them only when your finance model uses them.