Choosing which details are sent to iTrent
How to review, edit and reset the field mappings that decide what Recruit sends to iTrent for each new starter.
How to review, edit and reset the field mappings that decide what Recruit sends to iTrent for each new starter.
This is for System Admins, who open the page from the iTrent card. HR and System Admin users can save changes on it. The iTrent connection must already be configured: see "Setting up the iTrent integration".
Open the Field Mappings page
Recruit sends one group of details at a time. Each group is called a map, and each map lists the iTrent field names it fills. There are two ways in:
- In the Configure iTrent dialog, select Configure Field Mappings in the Field Mappings section. Save the dialog first, because the button leaves it.
- On the iTrent card, select Manage.
The page is titled Field Mappings.
The default maps and what Recruit supplies
The defaults are ten maps, each named with the prefix "Hireroad - ": People, Email Address, Mobile Number, Attach to Structure, Salary, Basis, Category, Cont Hours, Location and Type. They are sent in that order. If every field in a map comes out empty for a candidate, Recruit skips that map.
The details Recruit supplies for a candidate are first name, last name, email address, phone number, start date, and the salary, salary period and currency from their offer. The start date and salary come from the most recent offer on the application being sent. With no offer, the start date is the day you send and no salary goes across.
Edit a map
- Maps lists every map with its field count and an Enabled or Disabled badge. Select one to edit it on the right.
- Change the Map Name, or use the Enabled switch to stop a map being sent. Turn off any map your iTrent set up does not use.
- Each row has an iTrent Field name, a Source, a Source Value and a Transform.
- Add Field adds a row and the bin icon removes one. Add Map creates a map, and Delete Map removes the selected one after you confirm.
Sources and transforms
Source says where the value for that iTrent field comes from:
- Standard Field: a Recruit detail chosen from a list.
- Custom Field: one of your own custom fields.
- Static Value: text sent exactly as typed, the same for every candidate.
Transform can be Uppercase, Lowercase or Title from Gender. Rows that already use Value Mapping, Date Format or Concatenate Fields keep them, so leave the Transform on those rows alone.
Save, reset and limits
Select Save when you are done. It is available once something has changed, and "You have unsaved changes" shows until you save. Reset to Defaults replaces every mapping with the defaults after a confirmation, so any edits you made are lost.
A map holds up to 200 fields and you can have up to 50 maps. If the page cannot read the saved mappings it shows "Field mappings data is malformed". Contact support if you see it.
To send a candidate once the mappings are right, see "Sending a candidate to iTrent and fixing sync problems".