Workday Enterprise Management Cloud currently includes solutions for finance, HR, planning, and spend management. Accordingly, Workday is a valuable source to discover services, invoices, spend, employees and departments.

Integration details

📘

Integration Categories

  • HRIS
  • Financial System

📘

Authentication mechanism

  • API

Discovery Capabilities

Available entitiesProductEntity descriptionWorkday resource
New servicesEAM, SMPService discovery is the process of automatically identifying services and applications. All discovered services are added to LeanIX automatically.Suppliers
InvoicesSMPInvoices discovery is the process to collect invoices from all services. All discovered invoices on the services are added to SMP automatically.Supplier Invoices
CostSMPCost discovery is the process to identify every spending on all costs. All discovered costs on the services are added to SMP automatically.Expense Report
EmployeesSMPEmployees are discovered to get a complete overview of all employees of an organization and enrich the data for each discovered user.Workers
DepartmentsSMPDepartments represent the organisational structure of an organization relate to employees. This data is used to identify where in the organization which SaaS is used.Organizations

Instructions

In this document, we will provide instructions for connecting Workday with LeanIX to get accounts data.

📘

Permissions required

Admin account is needed to be able to follow guides from the instruction document, i.e. to create Integration System User and Integration System Group and give the proper rights.

​1​) Configure a System Integration User in Workday

To create an integration system user:

  1. Sign into your Workday tenant using an administrator account.
  2. Search for and open the Create Integration System User task.
  3. Create Integration System User by supplying a User Name (LeanIXSMPIntegrationUser) and Password for a new Integration System User.
    1. Leave the Require New Password at Next Sign In option unchecked, because this user will be logging on programmatically.
    2. Leave the Session Timeout Minutes with its default value of 0, which will prevent the user’s sessions from timing out prematurely.

​2​) Create a Security Group

You need to create an unconstrained integration system security group and assign the user to it. To create a security group:

  1. Search for and open the Create Security Group task.
  2. In the Type of Tenanted Security Group field, choose Integration System Security Group (Unconstrained).
  3. Enter a group name “LeanIXSMPIntegrationUser” and click OK.
  4. Select the user you created (LeanIXSMPIntegrationUser) from the Integration System Users choice list and click OK, and then click Done.

​3​) Configure security group options

Add the integration security group to domains by completing the following steps:

  1. Search for domain: manage org and open the Manage: Organization Integration domain.
  2. Click the ellipsis (...) next to Manage Organization Information. In the window that opens, point to Domain and select Edit Security Policy Permissions.
  3. Under Integration Permissions, add the security group “LeanIXSMPIntegrationUser” (GET and PUT) that you created and click OK.

    Next, follow steps 1-3 add the security group under each permission for HR module. Permission names could differ so please adjust access to appropriate resources. See the list below for permissions/resources:

For HR (people and departments):

OperationDomain Security PolicyDomain Security Policies Inheriting Permission
Get OnlyWorker Data: Public Worker Reports
Get OnlyWorker Data: Current Staffing Information
Get OnlyWorker Data: Workers (documentation)
Get OnlyWorker Data: Worker ID
Get OnlyWorker Data: All Positions
Get OnlyWorker Data: Business Title on Worker Profile
Get OnlyPersonal Data: Work Contact InformationPerson Data: Work Address

Person Data: Work Email

Person Data: Work Instant Messenger

Person Data: Work Phone

Person Data: Work Web Address
Get OnlyOrganisations (documentation)

For suppliers (SaaS discovery):

OperationDomain Security PolicyDomain Security Policies Inheriting Permission
Get OnlyReports: Supplier

For suppliers and invoices:

OperationDomain Security PolicyDomain Security Policies Inheriting Permission
Get OnlyReports: Supplier
Get OnlyProcess: Recurring Supplier Invoice
Get OnlyProcess: Supplier InvoiceProcess: Supplier Invoice - Add Attachment

Process: Supplier Invoice - Core

Process: Supplier Invoice - Hold from Payment

Process: Supplier Invoice - Invoice Workbench

Process: Supplier Invoice - Mass Action

Process: Supplier Invoice - Prepayments

Process: Supplier Invoice - Request

Process: Supplier Invoice - View

For expenses:

OperationDomain Security PolicyDomain Security Policies Inheriting Permission
Get OnlyReports: Expense Reports
Get OnlyExpenses: Expense Items

​4) Manage Authentication Policies

  1. Open the "Manage Authentication Policies" view and select the environment where data should be fetched from (usually called "Production")
  2. Navigate to the Authentication Ruleset after clicking on "Edit" at the bottom of the page.
  3. Add a new rule for the previously set up integration user and allow access to the system via Username and Password . We also have the capabilities to use a static IP range for this integration, please reach out to [email protected] if this should be configured for you.
  4. Once the exception for the LeanIX integration user is configured, proceed to the next step.
2450

Authentication Policy for the SMP integration user

​5) Activate All Pending Security Policy Changes

Activate Pending Security Policy Changes by completing the following steps:

  1. Search for act pending and then click on the link Activate All Pending Security Policy Changes.
  2. Begin the Activate Pending Security Policy Changes task by entering a comment for auditing purposes, and then click OK.
  3. Complete the task on the next screen by checking the checkbox Confirm, and then click OK. Find all the activated domain security policies listed in table Domain Security Policies.

​6)​ Workday Web Services Endpoint Data

To obtain the Web services endpoint, simply look up the WSDL of any of the Web services in your organisation, as follows:

  1. Search for and open Public Web Services.
  2. From the Public Web Services list, select any one of them (e.g. Human Resources) and click the ellipsis (…) to reveal a drop-down menu.
  3. Select Web Service \View WSDL, which displays the full WSDL in a separate window.
  4. In the WSDL, search for soapbind:address to see the Web services endpoint corresponding to the Web service that you chose. The Web Services endpoint is combined of: <subdomain>/ccx/service/<tenantName>/Human_Resources/v36.1
  5. For the LeanIX configuration, you only need two parts of the found URL: subdomain and tenantName.
    For example, if the value in the WSDL is https://implcc.workday.com/ccx/service/leanixsi/Human_Resources/v36.1.

Subdomain: implcc.workday.com

TenantName: leanix

​7) Integrate Workday in LeanIX

  1. In LeanIX SMP: Navigate to Settings > Discover Integrations, find Workday and click Add.
  2. Enter the Workday integration name, followed by Workday Subdomain, Tenant Name, Username and Secret.

  1. Click Integrate.