Enable a RaaS-based custom options sync with Workday integrations

A custom options sync with Workday integrations will synchronize the list of custom options in Greenhouse Recruiting with the corresponding fields in Workday. The steps below outline how to enable and run this sync with a Greenhouse field using a Workday RaaS. 

In order to complete the sync below, the following steps must be complete:

Configure the sync

Click Configure Configured_Icon.png > Dev Center > Workday Administration.

Select Enter credentials at access Workday Tenants or reports. A new page will display.

Screen_Shot_2018-02-26_at_3.38.46_PM.png

Enter the username and password for your RaaS in this form. In Workday, these usernames are usually in a <username>@<tenant> format.

Select Sync a Greenhouse custom field with a Workday Report-as-a-service.

Screen_Shot_2018-02-21_at_8.34.47_AM.png

Fill out all configuration fields below and click Save

  • Select custom field: The Greenhouse custom field that you want to sync with Workday.
  • Select credentials: The credentials for the Workday tenant that you entered to log in.
  • New/Existing Endpoint for RaaS URL: Select or enter a RaaS URL. This URL can be provided by your Workday consultant or developer.
  • Fields containing Workday Internal ID: The name of the element that contains the Workday Internal ID. Make sure to remove "wd:" from the option. This information will not be displayed in Greenhouse Recruiting and will only be used to communicate with data exports.
    • For example, if your field is workday is Supervisory_Organization_ID and the field in your external report ends with _ID Greenhouse Recruiting will automatically detect this and pre-fill this field.
  • Fields containing human-readable name: A field name that will be read by a user. When text is entered in this field, this name will actually be displayed in Greenhouse Recruiting.
    • For example, for the Workday field Supervisory_Organization_ID, you could enter Supervisory_Organization in this field so it can be read by users.

Screen_Shot_2018-02-21_at_9.05.54_AM.png

Once saved, Greenhouse Recruiting will attempt to sync the field immediately, and check the report every 30 minutes for updates.

For information on checking the status of a sync, click here.

Expected Report Format

Greenhouse Recruiting expects the Report-as-a-service to be in SimpleXML format. The elements in the report can have any name, as long as the report is in this general format.

For instance, the elements of the report are not required to be “Supervisory_Organization” and “Supervisory_Organization_ID” -- they can be anything as long as they are in this xml format.

Sample format

<wd:Report_Data>

   <wd:Report_Entry>

      <wd:Supervisory_Organization>Org Title 1</wd:Supervisory_Organization>

      <wd:Supervisory_Organization_ID>ORG1</wd:Supervisory_Organization_ID>

   </wd:Report_Entry>

   <wd:Report_Entry>

     <wd:Supervisory_Organization>Org Title 2</wd:Supervisory_Organization>

     <wd:Supervisory_Organization_ID>ORG2</wd:Supervisory_Organization_ID>

   </wd:Report_Entry>

   <wd:Report_Entry>

     <wd:Supervisory_Organization>Org Title 3</wd:Supervisory_Organization>

     <wd:Supervisory_Organization_ID>ORG3</wd:Supervisory_Organization_ID>

   </wd:Report_Entry>

</wd:Report_Data>