Custom Field Mapping for Positions

Summary

Custom field mapping provides the ability to link Position custom fields to each other so that selecting a value in a parent field will automatically populate child fields with pre-configured values.  A common example would be mapping a Country drop-down field to a State/Province drop-down field.  When a selection is made in the Country field, the State/Provide field will automatically be populated with values that are appropriate for the selected country.  Custom field mapping can be used to fill in vital position data quickly and efficiently, ensuring data is entered in a consistent manner.

Details

A new Custom Field Mapping page is available to administrators in the Recruiting Preferences section of the application. This page displays custom fields that have been mapped in a parent-child relationship.  Parent fields are displayed, as well as a count of child fields that have been mapped to each.  You can edit or delete an existing field mapping or create a new field mapping directly from this page.  

Note: Mapping custom fields is optional.  You may decide to have a mix of mapped custom fields, along with unmapped custom fields on your positions.

Figure: Custom Field Mapping page in Recruiting Preferences

Follow the steps below to create a custom field mapping.

1. Click the Mapping button. The field mapping configuration screen displays.
2. In the Parent field, select the appropriate parent custom field (always a drop-down list) from the available options.
3. Select one or more child fields to link to the parent field.

Figure: Create custom field mapping by selecting parent and child fields.

4. Click Next. The Edit Field Mapping Values screen displays.
5. Configure the custom field mapping.  You can designate the selection of a particular value in the parent drop-down field to automatically populate one or more child fields with predefined values.  Child fields can be drop-down lists, text fields or text area fields (which allow paragraphs of data).  You can enter the desired text for text and text area fields, as well as designate which values will be available to users in the child drop-down fields.  Child field values can be left empty if needed.

Figure: Designate which parent field values will populate child field values.

Mapped custom fields will be displayed in the Custom Fields section of the positions page.  If you have custom fields that are not mapped to each other, they will continue to display in this section in the normal manner.  Selecting a value in a mapped parent field will automatically fill in child fields with your pre-defined values.  If a text or text area child field has a mapped value that you want to overwrite, simply select that field and enter the desired value.

Figure: Mapped custom fields will be available on the Positions page.

Enhanced API Supports Bulk Updates for Positions and Candidates

Summary

Values for custom fields for a position or candidate can bow be updated in bulk via PATCH position/:id/custom-fields or PATCH candidate/:id/custom-fields. The request body needs to conform to JSON Patch format, providing a list of custom field IDs and their target values. See API documentation for details.

Position Reference ID on Job Descriptions

Summary

The Position Reference ID associated with a given position will now be displayed on the posted job.  Candidates can view this ID and use it as a reference in communications recruiting staff.

Pagination and Search for Custom Fields

Summary

Position custom fields that are drop-down fields or have radio button now have pagination and search controls.  These will be available when you edit a field that has a large number of values and will help you navigate long lists and find specific values you wish to change.