Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Feature

Description

Workday Integrations

You can use our Workday connector to push data to Workday. See this video for more information:

https://www.loom.com/share/bcf65ba46ef34ed4987f63e2adcea56b

Here are the list of actions available for pushing data to Workday using OnLink.

Update Worker Attributes

OnLink supports updating various fields in Workday. Here’s a sample mapping in the post function key-value config to get such updates working:
map:User_Name=customfield_10118 #update Workday account
map:Custom_ID=customfield_10119 #update a custom ID - needs next line too
map:Custom_ID_Type_ID=RefIDVal #Custom_ID_Type_ID is the reference ID of the custom ID type
map:Employee_Type=Contingent_Worker #set to Contingent_Worker or Employee, defaults to Employee

To update Workday attributes, OnLink needs the worker’s employee ID. Users can pass the Employee ID directly or they can configure OnLink to lookup the employee ID based on a lookup field. In order to configure lookup, add this line to post function key-values:

config:lookup_worker=true #employee id needs to be looked up

Then set the Workday Custom Report field in Workday Connection Settings. This custom report should return a single text field called “employee_id”. It should take a single filter prompt called “lookup_key.”

Generic Functions

Apart from the listed functions, OnLink can be used to call any Workday Web Service using the Generic Function process. Below is a screenshot of what the Post Function configuration looks like. Select API Name (see this reference for all supported Workday SOAP APIs). Construct the relevant XML body and use variable substitution to populate values from customfields. You can also setup a response field - for e.g. if you want the Requisition ID from a new Requisition that got created, you can configure the API Response Field and Response XML Path properties.

image-20240509-002309.png

Here’s the list of SOAP API’s you can select from. This covers the full list of supported Workday SOAP API.

image-20240509-002743.png

To make it easy to use this feature, we recommend first getting the API to work using tools like Postman or Soap UI. That helps you get the XML request body you need to make the call. Feel free to reach out to us for help - support@onwardb.com.

Changing Contact Info in Workday

Changing email address in Workday using Workday’s Generic Function:

Image Added

API Body to change Work Contact Email:

<bsvc:Change_Work_Contact_Information_Request bsvc:version="v40.1">

<bsvc:Business_Process_Parameters>

<bsvc:Auto_Complete>0</bsvc:Auto_Complete>

<bsvc:Run_Now>1</bsvc:Run_Now>

<bsvc:Comment_Data>

<bsvc:Comment>[OnRamp] Update work email</bsvc:Comment>

</bsvc:Comment_Data>

</bsvc:Business_Process_Parameters>

<bsvc:Change_Work_Contact_Information_Data>

<bsvc:Person_Reference>

<bsvc:ID bsvc:type="Employee_ID">{customfield_00000}</bsvc:ID>

</bsvc:Person_Reference>

<bsvc:Person_Contact_Information_Data>

<bsvc:Person_Email_Information_Data>

<bsvc:Email_Information_Data>

<bsvc:Email_Data>

<bsvc:Email_Address>{customfield_00000}</bsvc:Email_Address>

</bsvc:Email_Data>

<bsvc:Usage_Data bsvc:Public="1">

<bsvc:Type_Data bsvc:Primary="1">

<bsvc:Type_Reference>

<bsvc:ID bsvc:type="Communication_Usage_Type_ID">WORK</bsvc:ID>

</bsvc:Type_Reference>

</bsvc:Type_Data>

</bsvc:Usage_Data>

</bsvc:Email_Information_Data>

</bsvc:Person_Email_Information_Data>

</bsvc:Person_Contact_Information_Data>

</bsvc:Change_Work_Contact_Information_Data>

</bsvc:Change_Work_Contact_Information_Request>

v40.1 - set to same version as you use when configuring Workday connection

{customfield_00000} - replace with your customfield id’s

1 - change to 0 for setting public or primary to false

API Body to change Home Contact Email:

<bsvc:Change_Home_Contact_Information_Request bsvc:version="v40.1">

<bsvc:Business_Process_Parameters>

<bsvc:Auto_Complete>0</bsvc:Auto_Complete>

<bsvc:Run_Now>1</bsvc:Run_Now>

<bsvc:Comment_Data>

<bsvc:Comment>[OnRamp] Update work email</bsvc:Comment>

</bsvc:Comment_Data>

</bsvc:Business_Process_Parameters>

<bsvc:Change_Home_Contact_Information_Data>

<bsvc:Person_Reference>

<bsvc:ID bsvc:type="Employee_ID">21001</bsvc:ID>

</bsvc:Person_Reference>

<bsvc:Person_Contact_Information_Data>

<bsvc:Person_Email_Information_Data>

<bsvc:Email_Information_Data>

<bsvc:Email_Data>

<bsvc:Email_Address>gre22@gmail.com</bsvc:Email_Address>

</bsvc:Email_Data>

<bsvc:Usage_Data bsvc:Public="1">

<bsvc:Type_Data bsvc:Primary="1">

<bsvc:Type_Reference>

<bsvc:ID bsvc:type="Communication_Usage_Type_ID">HOME</bsvc:ID>

</bsvc:Type_Reference>

</bsvc:Type_Data>

</bsvc:Usage_Data>

</bsvc:Email_Information_Data>

</bsvc:Person_Email_Information_Data>

</bsvc:Person_Contact_Information_Data>

</bsvc:Change_Home_Contact_Information_Data>

</bsvc:Change_Home_Contact_Information_Request>