Location Access in Custom Job Requisition Forms

Recruiting Guide

Version
R2025.2.1
ft:lastEdition
2025-12-01
Location Access in Custom Job Requisition Forms

In Workflow Administration > Form Builder, you can configure customized versions of the Job Requisition form that allow managers to approve job requisitions outside of the location access defined in their work assignment.

Default Behavior

By default, if approving managers don’t have access to the location that a job requisition is for, then the Location field of the job requisition workflow form in Message Center is cleared, and they cannot select the location from the drop-down list. This prevents them from approving job requisitions for locations they don’t have access to.

This functionality is controlled by the <SecureLocationByUser>True</SecureLocationByUser> element, which is displayed below the <PositionLocationSelectorV2> element in the XML of the system Job Requisition form in Workflow Administration > Form Builder:

Highlighted SecureLocationByUser element.

Turn Off Location Security for Custom Forms

If needed, you can turn off the default location security for the Location field in custom Job Requisition forms.

To do this, add the <SecureLocationByUser>False</SecureLocationByUser> element below the existing <PositionLocationSelectorV2> element in the XML code of a custom Job Requisition form in Workflow Administration > Form Builder:

Highlighted SecureLocationByUser element.

After you add this element, the requisition's location is successfully populated in the Location field of the custom job requisition workflow form, even if the manager isn’t assigned to the location in their work assignment.

Important: When location security is turned off for the Location field of a custom Job Requisition form, all users that have access to the form can select any location in their organization from the Location drop-down list, both when submitting a new form or during any stage in the workflow approval process. Therefore, you should turn off location security for the Location field only when a form is associated with a workflow that has at least one stage of approval, so that approving managers can verify that the submitted job requisition is correct.

Turn Location Security Back On

In addition, you can turn the location control back on for the Location field of the custom form by changing "False" in the <SecureLocationByUser>False</SecureLocationByUser> element to "True", so that it's <SecureLocationByUser>True</SecureLocationByUser>.

Note: If you delete the <SecureLocationByUser>False</SecureLocationByUser> element from the custom job requisition workflow form, then location security turns back on (that is, the default behavior is restored). Therefore, setting this element to "True" has the same effect as deleting the element from the form altogether.

Configuration Note

Adding the <SecureLocationByUser>True</SecureLocationByUser> element to custom Job Requisition forms is optional. If the element isn’t added, the form continues to enforce location security for the Location field by default. As such, this element is intended for administrators that want to be able to turn location security off. No action is required with this update for administrators that want to keep location security on (that is, keep the existing behavior).

Location Security Cannot Be Turned Off for Candidate Hire Forms

The ability to override location security isn’t available for the Candidate Hire or Internal Candidate Hire workflow forms submitted through the Recruiting module.