FindManager¶

Retrieves the manager position associated with a given identity, if one exists.

$Membership.FindManager(identity: ( string | Identity ), position: ( string | Identity )):Array<Identity>

Parameters¶

( string | Identity ) identity
The identity for whom the manager is being sought.

( string | Identity ) position
The current position of the identity. This parameter is optional.

Returns¶

The manager position of the specified identity, or null if no manager position is found.

Remarks¶

This method's behavior varies based on the type of the provided identity:
- User Identity: The method determines the manager position for the specified user. If the initial manager position is vacant, the method iteratively searches up the organizational hierarchy until a valid position is located. If no position is found after traversing the hierarchy, the method returns null.
- Organization Unit Identity: The method identifies the common manager across all existing positions within the specified organization unit. If multiple managers are found, an error is thrown, indicating ambiguity. If the organization unit contains no positions, the method returns null.

Finding a manager using form data:¶

$Membership.FindManager( $Xml.Evaluate('PersonnelInformation/Owner') );

Finding a manager using form data and a position identifier:¶

$Membership.FindManager( $Xml.Evaluate('PersonnelInformation/Owner'), $Xml.Evaluate('PersonnelInformation/Position') );

Finding the manager of the user who completed the current work item:¶

$Membership.FindManager( $WorkItem.CompletedBy );

Finding the manager of an organization unit:¶

$Membership.FindManager( $Xml.Evaluate('Department') );