[DESCENDANTS] - Dynamically Selecting Users from an Organizational Unit and its Sub-units

The [DESCENDANTS] function is used to retrieve an attribute for all objects within a specific level of an organizational hierarchy, including all its sub-levels.

This function is dynamic; if sub-units are added to or removed from the hierarchy, the list of users returned by the rule will update automatically to reflect the change. This is useful for tasks such as granting access to all users belonging to a specific business area and its underlying departments.

Syntax

The syntax is:

[DESCENDANTS:RootObjectId:AttributeToReturn1:AttributeToReturn2:...]

• RootObjectId: The internal ID of the top-level organizational unit where the search begins.

• AttributeToReturn: The name of the field whose value should be returned by the function. You can list multiple attributes separated by colons.

For instance, the expression [DESCENDANTS:228714:OrgUnitnr:SourceId:ParentDepartmentNumber] returns the department numbers for unit 228714 and all units beneath it.

Note: While this expression can be written manually, the Rule Set Wizard in eADM can build it for you with a few clicks.

Rule example

This rule finds all users who have a position in the "Unit for Business and Urban Development" (ID 228714) or any of its sub-units, regardless of whether it is their primary position.