In order to setup your Workday Integration, you will need to enter the following Credentials on RippleMatch. The credentials required for the integration are as follows:

  • ISU Username

  • ISU Password

  • Workday Tenant Id

  • WSDL Url

  • Applicant Source Reference ID

The steps below will walk you through the process necessary to generate these credentials and enter them into the 'Integrations' modal on RippleMatch!

Step 1: Create a Workday Integration System User (ISU)

Start by creating an ISU. When logged in to your Workday Account, navigate to the search bar and search "Create Integration System User". Then, select the Create Integration System User task.

To create the new user, enter 'RippleMatch_ISU' or something similar in the 'User Name' box. Next, create a password that you will remember and don't mind potentially sharing with the RippleMatch team if necessary.

Keep the Session Timeout Minutes default value of 0 to prevent session expiration. An expired session can cause the integration to time out before it successfully completes. Click OK. Then Click Done. Write down the name of the ISU username and password that you created so that you can enter it in RippleMatch later and use it for the rest of the integration set up.

Next, to avoid integration errors caused by expired passwords, Workday recommends that you prevent Workday user passwords from expiring. Search for the Maintain Password Rules task and click into it.

Then, scroll down to the Session Timeout section and add the newly created Integration System User (ISU) to the System Users exempt from password expiration field. Do this by clicking into the box and typing the name of the ISU exactly as you created it.

The new Integration System User should appear in the box field with the other ISUs. Click OK. Then click Done.

Step 2. Create an Integration System Security Group (ISSG)

Type "create security group" in the Workday searcb bar and click the Create Security Group task.

From the In the Type of Tenanted Security Group drop­down menu select Integration System Security Group (Unconstrained).

Then, give the group a name like “RippleMatchISSG". Click OK.

On the next screen, under Integration System Users, search and select the ISU (e.g. "RippleMatch_ISU") you created in step 1 to the list.

Click OK, and then Done. Write down the name of the ISSU somewhere separate so that you can access it during the rest of the integration set up.

Step 3. Grant Domain access to the newly created Integration System Security Group (ISSG)

Next, you'll grant different domain access to the new RippleMatch ISSG. To do that, follow sub-steps 1-4 below.

  1. Search the View Domain report and click into the report.

  2. Search and select one of the Domains from the list below. Click OK.

  3. As a related action on the domain that you've selected, click the three dots next to the domain title. From the pop-up menu, select Domain > Edit Security Policy Permissions

  4. Scroll down to the Integration Permissions section and search for and add the Security Group that you created in the previous step. Based on the domain list and details below, select either or both GET and PUT to the right of the newly added ISSG for the respective domain that you are viewing. Click OK. Click Done.

Repeat sub-steps 1-4 above for all of the below Domains. Adding each domain one by one is critical to the integration working properly.

Domain Security Policy

Operation

Candidate Data: Job Application

Get and Put

Job Requisitions for Recruiting

Get and Put

Set Up: Recruiting

Get and Put

Invite to Apply

Get and Put

Candidate Data: Attachments

Get and Put

Candidate Data: Interview Schedule

Get and Put

Job Postings: External

Get and Put

Job Postings: Internal

Get and Put

Manage: Evergreen Requisitions

Get and Put

Candidate Data: Other Information

Get Only

Candidate Data: Other Jobs

Get Only

Candidate Data: Quick Stats

Get Only

Candidate Data: Background Check History

Get Only

Staffing Actions: Job Requisition Assessments

Get Only

Candidate Data: Bundle Resumes

Get Only

Candidate Data: Eligibility Results

Get Only

Job Requisition Data

Get Only

Candidate Data: Interview Feedback Results

Get Only

Candidate Data: Interview Feedback Comments

Get Only

Candidate Reporting

Get Only

Candidate Data: Assessment Results

Get Only

Candidate Data: Offer Details

Get Only

Evergreen Reporting

Get Only

Move Candidate

Get Only

Once you have followed this process for each required Domain, you're done creating the ISU and have the proper user enabled with the right permissions. Make sure that you write down the username and password of the ISU, as that will be the info you need to input on RippleMatch.

Step 5. Obtain Tenant ID

Tenant ID

Next, you'll identify your Tenant ID — One of the other required credentials to set up your integration. Finding your Workday Tenant ID is easy. Your Workday Tenant ID is found in the URL when you’re logged into Workday. The Tenant ID will be the letters that immediately follow ".com/". For example, if the URL is https://impl.workday.com/example/d/home.html, your Tenant ID is “example”. If you're having trouble, feel free to send us the whole URL, and we can help you identify the Tenant ID. Once you have the Tenant ID, write it down so that you can enter it in RippleMatch later.

Step 6. Obtain WSDL URL

WSDL URL

Next, you'll obtain your WSDL URL — One of the other credentials required to set up your integration.

To find your WSDL URL, type “Public Web Services” in the Workday search bar and select the Public Web Services report.

From the Public Web Services list, select the Recruiting (Public) web service listed and then click the ellipsis icon near the words 'Recruiting (Public)' to reveal a drop-down menu. Select Web Service > View WSDL, which displays the full WSDL in a separate window.

Scroll to the bottom of that page to find the WSDL URL.

The WSDL URL is the part of this line that reads https://wd2-impl-services1.workday.com/ccx/service/bnb_dpt1/Recruiting/v37.0. If you're unfamiliar with the WDSL, you can use Command + F to search the doc for "soapbind:address" which should locate the WSDL URL for you. Once you have the WSDL URL, write it down so that you can enter it in RippleMatch later.

Step 7. Create a new Recruiting Source ID for applicants.

Finally, you need to create a source ID for all of the RippleMatch candidates that will be uploaded into Workday. To do this, search "Maintain recruiting sources" in the search bar and select the task.

Then add a new source for RippleMatch by clicking the "+" button in the top left-hand corner. In the Recruiting Source Category Name field, add in a title that feels most relevant to you. We used External. Then, click the "+" sign to the right of the Name field. Then, enter "RippleMatch" in the Source field. Click OK. Click Done.

Now you're ready to find the newly created ID (your last credential!). To get the newly created id, search Integration IDs report and click into the report.

Type "Applicant Source" into the Business Object field. Select Applicant Source and click OK.

Then find the new Applicant Source titled RippleMatch that you just created. In the far right column you'll see a Reference ID that is written in this format: Applicant_Source_ID. Once you have this Applicant Source Reference ID, write it down so that you can send it to your point of contact at RippleMatch.

Step 8. Share the following information with your RippleMatch team!

Once you've followed the steps above, send all of the information over to your point of contact at RippleMatch. As a reminder, that should include:

  • Username for the ISU you created

  • Password for the ISU you created

  • Your Workday Tenant ID

  • Your WSDL URL

  • Applicant Source Reference ID

Then, we'll be able to get your integration fully functional! As always, reach out to our team if you need help.

Did this answer your question?