Workday Report-as-a-Service (RaaS) is a feature that exposes reports as web services. Torii syncs the list of users from your Workday configured report.
Setup your Workday integration
Step 1: Log in to the Workday tenant using an administrator account.
Step 2: Create an Integration System User (ISU).
In the Search field, type “Create Integration System User”.
Select the Create Integration System User task.
Complete the Create Integration System User task by supplying, in the Account Information section, a User Name and Password for a new Integration System User.
Make sure that you leave the Require New Password at Next Sign unchecked and leave the Session Timeout Minutes with its default value of 0.
Step 3: Create a Security Group and assign the Security Group to the ISU.
In the Search field, type “Create Security Group”, and then click Create Security Group task.
On the Create Security Group page, from the Type of Tenanted Security Group dropdown menu, select Integration System Security Group (Unconstrained).
In the Name field, enter a name:
After the Security Group successfully created, you will see the Edit Integration System Security Group (Unconstrained) page, where you can assign members to the Security Group.
In Group Criteria section, add the new ISU, created in step 2, to the Integration System Users list of this security group.
Step 4: Configuring domain security policy permissions.
List of domains:
Worker Data Public Worker Reports
Person Data Work Contact Information
Worker Data Current Staffing Information
Worker Data All Positions
Worker Data Business Title on Worker Profile
In the Search field, type and select “Domain Security Configuration”.
In the Domain field, search the Domain from the table, select the result and select OK.
Select the 3-dots symbol (...) next to the Domain name and select Actions > Domain > Edit Security Policy Permissions
On this page, under Integrated Permissions, add the Security Group created in the previous step (
torii-security-group) and select the checkbox in the Get permission column.
Select OK, then Done on the next screen to complete the configuration.
Repeat steps 1-5 for all the domains in the list above and for any other domains whose fields you want to import from Workday to Torii.
If an alert to Activate Pending Security Policy Changes is displayed, do this after all domains have been updated for the security changes to take effect immediately (see step 5).
(picture for illustration)
Step 5: Activate security policy changes.
In the Search field, type “Activate Pending Security Policy Changes”, and click that task.
For auditing purposes, you will be asked to enter a comment. Enter
Activating security policy changes for Workday integration with Torii, and then click OK.
On the next screen, check the Confirm checkbox and click OK.
Step 6: Create Custom Report.
In the Search field, type “Create Custom Report”.
On the Create Custom Report page, type in the Report Name:
Select Report type to be
Mark the Enabled As Web Service check box and Optimized for Performance check box.
Select as a Data Source:
All Active and Terminated Workers.
In the Additional Info section, click on Columns.
Click + to add a column tab. Each column tab is a report field in the custom report. The report should include the information as described below.
Please enter in the Field and in the Column Heading override XML Alias columns, the same (XML) value, for example:
The report should include the following information. Note that fields must have the exact field name as shown in the following table:
Type & Example
Worker's (work) email address
String containing a valid email address.
Attribute identifying whether the Worker is active
Worker's first name
Worker's last name
Worker's (personal) email address
String containing a valid email address
Attribute identifying whether the Worker is currently retired
Most recent hire date for the Worker
Date (ISO 8601)
Worker's end of employment date
Date (ISO 8601)
Worker's manager primary email address
String containing a valid email address
Worker's preferred name
Worker's worker type
Worker's employee type
Step 7: Add an authorized user.
In the Search field, type “View Custom Report”.
In the View Custom Report field, enter the name of the created custom report.
Select the report from the search results and click OK.
On the report summary screen, click Action > Custom Report > Edit.
In the Additional Info section, click Share.
In the Report Definition Sharing Options section, select the Share with specific authorized groups and users option.
In the Authorized Users field, enter the username of the Integration System User (ISR) that was created on step 2.
Click Enter and OK.
Step 8: Get the report URL.
In the Search field, type “View custom report”.
On the View Custom Report page, click My Reports.
torii-reportreport and click OK.
On the View Custom Report page, click Actions > Web Service > View URLs.
On the View URLs Web Service page, in the JSON section, right-click JSON, then select Copy URL.
JSON endpoint example
Step 9: Check your credentials and report.
Make sure the copied report URL, includes
Test the report URL by pasting it into a new browser session. An alert box should popup and ask for the ISU username/password credentials you have configured.
If the file lists all users and values for all fields visible to the report user - you're all good. Otherwise, check if you entered incorrect credentials, or if expected fields from Workday are not showing up in the report, you should probably check the report user (the ISU created on step 2) has appropriate permissions to read all included fields.
Step 10: Connect Workday integration to Torii.
Go to Torii Integrations page and click on the Workday tile in order to connect.
Username - Enter the username of the Integration System User created on step 2.
Password - Enter the password of the Integration System User created on step 2.
Report URL - Enter the report URL from step 8.
You can always contact our support team for help at email@example.com.