ManagerSelector

XML Forms Guide

Version
R2024.1.1
ManagerSelector

The <ManagerSelector> tag allows you to directly assign a manager to an employee on workflow forms.

The control respects the Forms - Management Assignments access authorization in the Authorizations tab of System Admin > Roles. Assign the Can Read checkbox to display the current manager and method, and the Can Create checkbox to enable the full functionality of the control.

Copy
<ManagerSelector>
    <Row>n</Row>
    <Column>n</Column>
    <ColumnSpan>n</ColumnSpan>
    <RespectOrgSecurity>True/False</RespectOrgSecurity>
    <RestrictToManagerAuthority>True/False</RestrictToManagerAuthority>
    <RestrictToTargetEmployeeOrg>True/False</RestrictToTargetEmployeeOrg>
    <DisableDerivedManager>True/False</DisableDerivedManager>
    <IsRequired>True/False</IsRequired>
</ManagerSelector>

Specify an integer for the "n" values to configure the row and column appearance.

To mark the selector as a required control, set <IsRequired> to True.

The application examines the <DisableDerivedManager> section to determine the appropriate behavior

<DisableDerivedManager>

<IsRequired>

Behavior

True

True

The application requires that users select a direct manager.

False

True

If the org has a manager assigned: the application automatically populates the form with the manage assigned to the location and does not require users to select a direct manager.

If the org does not have a manager assigned: the application requires users to select a direct manager.

Define a "True" or "False" value for the following optional attributes:

  • RespectOrgSecurity. Determines if the manager selection is restricted to only those employees to which the user has access. If this attribute is not defined, the default value is "True."
  • RestrictToManagerAuthority. Determines if the manager control displays only those employees that have been assigned manager authority for the location specified on the form. If this attribute is not defined, the default value is "False."
  • RestrictToTargetEmployeeOrg. Determines if the manager control displays only those employees assigned to the location selected on the form. If this attribute is not defined, the default value is "False."
  • DisableDerivedManager. Determines if the manager section automatically displays the employee's derived manager when a job assignment and location are selected. If this attribute is not defined, the default value is "False."