Aggregation and Provisioning of Custom IDs

The Workday source supports the aggregation of Custom IDs along with the following features:

  • Updating and provisioning the pre-existing value of custom IDs.

  • Updating the Identification value/ section of custom IDs.

Note

  • Aggregation of custom IDs is supported for all Workday API versions. Provisioning of custom IDs is supported for all the Workday API versions 32.1 and later. Delta aggregation of the configured CUSTOM IDs is not applicable.
  • The Workday source supports updating custom ID (other ID) even if it is blank on the Workday managed system.

The PUT permission to change other IDs (Web Service) : change_other_id is required to provision custom IDs.

Perform the following configurations:

  1. The schema attribute must be added with the __CUSTID suffix (<underscore><underscore>CUSTID) for Custom ID.

    Note: __CUSTID is case sensitive.

    For example, if Applicant_ID is a custom ID, then Applicant_ID__CUSTID must be added in the schema.

  2. Add an XPATH entry for the custom ID schema attribute added in Step 1 in the Workday source XML.

    Add an entry in the XPATH schema mapping, as follows, where the value of the entry will be the XPATH required to fetch the required field:

    ns1:Worker_Data/ns1:Personal_Data/ns1:Identification_Data/ns1:Custom_ID/ns1:Custom_ID_Data[ns1:ID_Type_Reference/ns1:ID[@ns1:type='Custom_ID_Type_ID']='<Custom_ID_Type_ID>']/ns1:ID

Perform the following steps to obtain the required value of Custom_ID_Type_ID:

  1. Sign in to the Workday managed system.

  2. Search for View Custom ID Types and select an Identifier Type of the required custom ID.

  3. Go to Integration IDs > View IDs.

  4. Under Reference IDs, copy the ID value and place it at <Custom_ID_Type_ID> in XPATH.

  5. Ensure that the final XPATH is as follows:

    ns1:Worker_Data/ns1:Personal_Data/ns1:Identification_Data/ns1:Custom_ID/ns1:Custom_ID_Data[ns1:ID_Type_Reference/ns1:ID[@ns1:type='Custom_ID_Type_ID']='CUSTOM_ID_TYPE-6-11']/ns1:ID