Professional Documents
Culture Documents
4a-W24 - SimpleIntegrations - Student - Guide (1) - EIB
4a-W24 - SimpleIntegrations - Student - Guide (1) - EIB
© 2015 Workday, Inc. All rights reserved. Workday, the Workday logo, Workday Enterprise Business Services, Workday Human
Capital Management, Workday Financial Management, Workday Resource Management and Workday Revenue Management are all
trademarks of Workday, Inc. All other brand and product names are trademarks or registered trademarks of their respective
holders. Version 24 (April, 2015)
Simple Integrations for Workday 24
CONTENTS
Simple Integrations for Workday 24 ......................................................................................... 5
Description ......................................................................................................................................5
Goal & Objectives ............................................................................................................................5
Agenda ...........................................................................................................................................5
Activity 27 (Optional) Using GetWorkers API and XSLT to Create HR-XML .................................... 146
EIB Features .......................................................................................................................... 147
DESCRIPTION
This Workday simple integrations course focuses on mechanisms for loading data though generated
template models and using custom report results in integrations. The inbound integration systems are
used to load bulk data into the Workday tenant using generated spreadsheet models based on Public
Web Services (WWS) that are produced, and then populated in MS Excel. The course also covers
outbound integrations using RaaS as a data source and touches briefly upon using the Workday Web
Services for EIB integrations.
Through a series of presentations, demonstrations and activities, you will learn about the different
template models with the different functional areas and how to generate, customize and populate those
templates for inbound transactions; how to build and launch an integration that extracts data out of
Workday and sends it to an external system. You will also learn how to use a business process to trigger
an outbound integration and how custom XSLT is used to transform data. This class will stress the
importance of business processes, Integration IDs, and data structure when you are working with both
inbound and outbound data.
After taking this course you will know how to use Enterprise Interface Builder to create inbound and
outbound integration systems to load and extract data.
AGENDA
Integration Architecture Overview
EIB Overview
o Enterprise Interface Builder (EIB)
o The 3-step EIB Design Pattern
Inbound Integration Systems
o Understanding the Business Process associated with the Inbound Data
o Generating Templates
o Loading Bulk Transactions
o Viewing and Validating Inbound Integration System Results
o Customizing Templates
o Troubleshooting
Outbound Integration Systems
o Using both Reports as a Service (RaaS) and Workday Web Services to extract data
o Integration Systems and Event Results
o Scheduling Integrations
o Integration as a step in a Business Process
o Using Custom XSLT
o Delivering Notifications
o Creating Sequence Generators
Developers also connect to the OMS via the UI Server to make use of the browser-based tools, for
example, when configuring Integration Systems or building integrations using the EIB.
Inbound
o Data is fed to Workday
o Incoming data is transformed
into Workday Compliant format
(Workday Web Service)
o Schedule
o Encryption
Outbound
o Data is provided by Workday
o Outgoing data may be
transformed
o Schedule
o Encryption
EIB OVERVIEW
OVERVIEW OF EIB
The Enterprise Interface Builder (EIB) allows users to perform simple and secure integrations with
Workday. Unlike other Workday integrations, the purpose of the EIB, which uses no third-party software
or hardware, is to allow customers to build their own integrations according to their unique business
scenarios. Workday does, however, provide some packaged integrations with the EIB. The Enterprise
Interface Builder can be used for both exports and imports.
Direction of
Description Example
Integration
AS2
HTTP/SSL
Transformation: There are also multiple options for transforming data using the EIB:
o Alternate output
o Custom Report Transformation
o Custom XSLT
EIB LIMITATIONS
When you attach a spreadsheet at integration launch time, the size of the document attachment is
limited to 30 megabytes (MB). When you upload an EIB spreadsheet from a file server, like sFTP, the
spreadsheet size cannot exceed 300 MB. If you attempt to upload a spreadsheet file that exceeds the
300 MB limit, Workday returns an error and does not load the data.
When you create an outbound EIB, you have the option to specify a Document Retention Policy (in
Days). You may specify a value of up to 180 days.
When you transform very large amounts of data, outbound EIBs with custom XSLT transformations
consume as much as 10 times the amount of memory that the source data requires. Workday
recommends that the amount of data transformed not exceed 100 MB. Although EIBs that transform
more than 400 MB of data have a high risk of malfunctioning, Workday still attempts to complete all EIBs.
The maximum amount of memory that is allocated to an EIB transformation is 15 gigabytes (GB). An
EIB's custom XSLT transformation can process for up to 2 hours. Custom XSLT transformations that
spend more than 2 hours processing are terminated automatically.
Workday provides a best-effort attempt to launch an integration at the scheduled initiation time and
processes it as quickly as resources are available. However, Workday does not guarantee when an
integration will be launched and when the integration will complete, because these factors are highly
dependent on the current load on Workday and the work that needs to be done. You should not design
or implement any integration system or external system that relies on an integration running and/or
completing successfully at a specific time.
To ensure resource availability for all customers, Workday terminates HTTP requests including Workday
Web Services and Reports-as-a-Service (RaaS), that exceeds 6 hours. The following integrations make
HTTP requests:
EIBs
Studio Integrations
Cloud Connect integrations
WORKDAY REPORTS-AS-A-SERVICE (RAAS)
When you enable web services for an Advanced custom report and expose the report for integration
scenarios, the maximum size of the response that can be returned is 2 GB.
All access to Workday data is done through web service operations and Reports-as-a-Service. These web
service operations, report data sources, class report fields, and custom reports are secured to various
security domains.
Integration systems (and external systems that access Workday) must have the appropriate ( Get and/or
Put) access to the domains that include the web service operations and the appropriate (View) access to
the domains that include the report data sources and class report fields. Outbound EIBs also require
access to the custom report that they use as a data source. Permissions are controlled by the user who
runs the EIB integration.
Additionally, you need access to the appropriate domains to build, configure, debug, and access
integration events and reports.
INBOUND EIB
As a method to verify the data was properly loaded from our inbound EIB, we will review the output of a
custom report.
Scenario: Logan McNeil has created a New Hire Report. The report prompts the user for a date range
and returns any hire events that are effective dated within the date range that the user enters. This
report has been created for you.
Tasks to Use
Sign in as Logan McNeil (lmcneil) using the password you were provided
1. Search for WDINST EIB.
2. Click the WDINST EIB IntNewHire link in the Tasks and Reports area of the search results.
3. Enter 01/01/2013 date as the Start and today’s date as the End, click OK.
4. Review the report’s output. This report will be used to validate the data loaded with our inbound
integration system.
To complement the standard Enterprise Interface Builder (EIB) framework, Workday provides
spreadsheet import templates that offer immediate business values by helping you upload data into
Workday. You can generate templates directly in Workday. Each spreadsheet template is based on a
template model that defines the column information for an upload. To simplify data entry and streamline
the upload process, you can edit the template model to fit your needs. For example, you can override
column values, provide your own labels and cell comments, reorder worksheets, and hide unwanted
items to customize the template for a specific purpose. Since the version 20 update, some web service
operations now support Template Generation with Data to simplify data entry.
Inbound EIB provides an Excel front-end to Workday Web Services (WWS). While it makes it easier for
non-technical users to load bulk data into Workday, it does not eliminate the complexity of the Object
Model exposed by the WWS.
SPREADSHEET TEMPLATES
You must create a separate Enterprise Interface Builder (EIB) integration for each version of a template
model. Workday automatically creates a template model when you set up an EIB interface. You then
generate a spreadsheet template, which is a blank spreadsheet used to populate data. Only users with
View and Modify access to the Integration Build or Integration Process domains can access the
Generate Spreadsheet Template task.
As a best practice, start by generating a baseline spreadsheet template and reviewing the spreadsheet
details. Then, edit the underlying template model as needed to define a custom spreadsheet template.
Open the spreadsheet in Microsoft Excel and familiarize yourself with its details:
Look at the overall structure of the spreadsheet, including the individual worksheets and sheet
areas.
Review the column groupings in each area to understand the relationships between fields.
Notice which areas and fields are required, conditionally required, and optional.
View comments by resting your mouse pointer over spreadsheet cells.
Determine whether you want to modify the spreadsheet template. You can make the following changes:
Worksheets - reorder tabs, rename tabs, change sheet titles, or hide sheets completely.
Areas - rename, add Excel cell comments, or hide areas completely.
Columns - rename, change area labels, override values, select reference ID types, edit
Excel cell comments, or hide columns completely. You can also maintain occurrences for
columns that accept multiple values, such as worktags, address lines, earnings,
deductions, and related calculations.
Certain web service operations support the generation of spreadsheet with data to simplify the
data entry process. To determine which operations are supported, run the Supported
Inbound EIB Operations report.
The Enterprise Interface Builder is used to create, configure and launch simple interface background
processes.
Create EIB: Locate the Create EIB task. Enter the integration system name and direction. You can add
a description in the General Settings page, using the Edit icon.
GET DATA
There are two areas that require input on the Get Data page of the wizard:
Data Source
The.xml file that will load the data into Workday can be attached at launch or can be retrieved using
different protocols: FTP/SSL; REST URL; SFTP. If using a pre-defined transport protocol, select Use
Existing Retrieval Method and then identify the protocol in the Retrieval Details and File Name fields.
Data Format
The File Type will most often be Web Service Spreadsheet Template. If uploading data to a Custom
Object, the selection should be Custom Object Spreadsheet Template.
TRANSFORM
When loading data from a web service spreadsheet template, the Transformation Type will auto-
populate.
If loading data from an external .xml file that requires transformation, Custom Transformation option
would be available. Note that custom transformations must be created outside of the wizarad using the
Create Custom XSLT Attachment Transformation task.
DELIVER
You will select a Workday Web Service operation for the delivery location for the Inbound Integration
System. If you selected " Web Service Spreadsheet Template" as your data format, this will
automatically default.
Workday enables you to load data through EIB spreadsheets into custom objects. On each Inbound EIB,
you can create or update data in the current tenant from the spreadsheet.
SUMMARY
The summary page of the wizard presents your configurations and allows you to edit fields using the
pencil icon. The Guide Me option takes you back the the specific page in the wizard.
6. Click Next.
7. In the Get Data page, click the icon to edit the Data Format area.
8. Use the Web Service Operation prompt to search for and select Hire Employee (Web Service).
9. Click Next.
10. Accept the default values on the Transform page and click Next.
11. Accept the default values on the Deliver page and click Next.
12. In the summary page, review your configuration. Note the buttons to ‘Guide Me’ or ‘Edit’ should
you wish to return to configuration mode to make any changes.
13. Click Save for Later, or navigate away and you will see that your changes have been saved. Click
OK to save.
The Spreadsheet model is broken into Template Model Areas based on a Business Process, Sub Business
Process or Task.
By expanding the folder(s) in the Spreadsheet Model, you can view the fields in each Template Model
Area. You can edit those fields by clicking on the Edit Template Model Area button.
Whenever you are prompted for a value for a field while populating an action or task online, you will have
to specify a Reference ID Type. This is a "lookup" field that must be populated with a valid Reference ID
Value in the integration file.
INTEGRATION IDS
Workday uses the term "Integration IDs" as an umbrella term to capture all of the various "IDs" that we
have in Workday that can be used for integrations. This term includes Workday ID (WID), Reference ID,
External ID, and Reserved System ID. Reference IDs are most often used to populate spreadsheet
templates for inbound EIB integrations.
Methods to locate the needed IDs consist of using related actions from objects in the user interface,
running the Integration ID or View Reference ID reports.
Workday ID
A globally unique identifier that Workday automatically generates on all customer data. Workday IDs
consist of a 32-character, non-changing string. For example, b0685b69d8ac412582c0a44d7973f707.
WIDs are unique within each Workday environment, thus the same Workday object has different WIDs in
your production, sandbox, and implementation tenants. Although the use of WIDs can prevent
integrations from inadvertently running against the wrong environment, testing and migration of these
integrations is more complex.
Reference ID
An optional, unique identifier that can be set externally or within Workday. Each instance of a business
object can have one or more reference IDs. All Reference IDs contain a "type" and a "value".
The "type" defines the attribute that is being used as the unique identifier.
External ID
A two-part unique identifier that is controlled by an external system and can change. These IDs provide
a way to capture external system IDs within Workday. These IDs are two-part unique identifiers. They
require an "Integration System" together with an identifier value (e.g. Integration System = "Taleo" with
ID = "A57987"). In prior updates, this ID was often referred to as "Integration ID" but are now referred
to as "External IDs" for clarity.
A system ID, which identifies an integration system in Workday. For example, SFDC is a system
ID for a tenanted integration system between Workday and Salesforce.com.
A value, which identifies a particular business object instance. For example, W-001 is the external
ID value for the Western region instance of the sales organization.
Most spreadsheets have separate tabs for the main business process and each supported sub process.
If you include data in the spreadsheet for a sub process that is not included in the worker's business
process configuration, Workday disregards the data and continues processing the transaction as long as
the automation level is set to Skip or Manual. A sub process marked Optional may contain required
fields (columns); if you provide data for this sub process, all fields are required if you set the processing
level to Automatic. If a sub process is before the completion step in the main business process, it must
be included in the spreadsheet; however, it can set to Skip.
Full Automation Import new hire data into Workday using EIB and select automatic processing to
bypass To Do tasks, Notifications, and approvals, and to automatically complete
business process workflow.
Important: To fully automate the Hire Employee business process, all employees
in a spreadsheet must have identical processing requirements. If some employees
will skip a sub process and others will not, you must either perform separate
spreadsheet uploads for each group or use partial automation.
Manual Processing If you want business process participants to manually complete all review and
approval steps, To Do tasks and Notifications, specify manual processing for the
entire business process and either import all of your new hire data into Workday
using the EIB upload process or provide partial data in the spreadsheet and enter
the rest manually.
Important: When you select manual processing, any data uploaded from the
spreadsheet will trigger workflow just as if the data had been entered online.
Partial Automation You can specify different levels of automation for the main hire employee process
and each supported sub process.
To require manual review and approval for some processes but not others, select
a mix of automatic and manual processing options. For example, you might want
to automate the Assign Organizations sub process while using approval workflow
for the Propose Compensation for Hire sub process.
Option Description
Triggers review and approval workflow and includes all To Do tasks and Notifications defined for a
process or subprocess. If you select this option for a subprocess, you can enter partial data in the
corresponding spreadsheet section and enter the remaining information online, worker by worker.
MANUAL PROCESSING
Important: Provide all required data for the main process, even when the automation level for this
process is Manual. Only subprocess actions can include partial data.
Automatically completes workflow steps and bypasses To Do tasks, Notifications, and approvals for
a process or subprocess. If you select this option, enter data in all of the fields (columns) marked
AUTOMATIC Required in the related worksheet.
PROCESSING
Note: The fields marked Required represent the minimum amount of data required to fully
automate the business process; other fields may be required depending on your setup.
Bypasses a subprocess that is either defined as optional or not included in your business process
SKIP PROCESSING WHEN
configuration. You cannot select Skip for the main process.
STEP IS MARKED
OPTIONAL
Important: If you select Skip, do not enter any information in the worksheet for this process.
Triggers immediate start of the business process or sub-process with manual processing. You
should use this option only if you need the business process to complete before the EIB has
RUN NOW
finished loading.
Note: Selecting this option will affect the performance of your EIB load; the load may take more
time than expected.
Triggers immediate start of the business process or sub-process with automatic processing. You
RUN NOW WITH
should use this option only if you need the business process to complete before the EIB has
AUTOMATIC
finished loading.
PROCESSING
Note: Selecting this option will affect the performance of your EIB load; the load may take more
time than expected.
Business Case: In order to better understand the structure of the spreadsheets generated from the
integration systems, you have been asked to review the Template Model for Hire Employee.
TASK 1: REVIEW THE TEMPLATE MODEL AND EDIT BUSINESS PROCESSES FOR THE
TEMPLATE MODEL
1. Search for 'WICT EIB' and select the WICT EIB Hire Employees Integration System from the All
of Workday or Integrations search category.
a. Hire Employee
7. In the course files provided by the instructor, from the Inbound Spreadsheet Solutions folder, open
the Act_4_Hire_Employee_24.xml in Excel. You may need to check the file properties and unblock to
be able to open the file.
8. Click on the Overview tab and review the Business Processes. Compare the list to the template model
in your tenant. Notice the ‘hidden’ business processes do not show up on the spreadsheet.
9. Click on the Hire Employee tab in the Excel spreadsheet. Review the contents to hire two employees
represented by their Applicant ID:
10. Click on the Propose Compensation for Hire tab in the Excel spreadsheet and review.
3. Find the corresponding Columns in your Act_4_Hire_Employee_24.xml on the Hire Employee tab.
Configure Integration System: To edit the Enterprise Interface, use the related actions menu to
launch the configuration wizard.
Launch Integration System: Navigation to the Launch task is through the Integration System related
action and choosing Integration > Launch /Schedule.
Once you launch the integration, you must create or select the integration attachment and decide
whether to execute the integration live or in validation only mode. To improve availability of integration
resources, Workday now limits the maximum size of inbound EIB spreadsheets to 300
megabytes (MB). However, there is a 30 MB limit for all attachments in Workday, so you will need
to use SFTP for inbound EIBs if loading large amounts of data in a spreadsheet.
LAUNCH PARAMETERS
In the Value Type field, indicate how the parameter value is set:
Select Specify Value to specify the value manually. Check the box to indicate ‘True’.
Select Determine Value at Runtime to have Workday calculate the value each time the integration
runs. Typically, only date fields are determined at run time, since they are the only fields that
vary over time in recurring integrations.
Select Use System Default to use the value that is configured in the Enterprise Interface
definition. This option is the default.
View Background Process Event: Once you launch the Enterprise Interface you will be transferred
directly to the View Background Process page. You will need to click the Refresh button to refresh
the page until completion. When the Integration is 100% complete, you can view the details of your
process as well as the attachment.
The Process Monitor report can also be used to examine the details of the background
process/integration event. Be sure to select Integration as one of the process types.
Another useful report to view integration system results is Integration Events. Simply search for 'int
event' in the Workday search feature and enter the 'optional' parameters to run the report. The results
will display your completed integrations.
Business Case: You've been asked to launch the WICT EIB New Hire integration system and upload
the Act_4_Hire_Employee_24.xml. First launch in validation mode then re-launch without validation
mode selected.
Sign in as lmcneil
1. Search for 'WICT EIB' and select WICT EIB Hire Employees. Select the Integrations or All of
Workday search category in the Search Results.
6. Select the Attach button and navigate to where you saved the files
provided by the instructor and choose Act_4_Hire_Employee_24.xml and
click open.
7. When 100% uploaded, select OK (this will bring you back to the
Schedule an Integration page).
8. In the Value Type column of Validate Load Only, select Specify Value then check the box under
the Value column.
9. In the Value Type column of Add Errors to Attachment, select Specify Value then check the box
under the Value column.
10. Click OK and Refresh for the results on the Process Monitor screen. DO NOT click Close!
11. Search for 'WICT EIB' and select WICT EIB Hire Employees (remember to select Integrations
category in the Search Results).
14. Select the prompt in the Value column of the Integration Attachment.
16. Click OK and Refresh for the results on the View Background Process page.
Run the WDINST EIB IntNewHire Report using 01/01/2013 as the starting date and today’s date as
the ending date. Then answer the following questions:
1. What are the employee id's for the following new hires?
Hint: For the last question, check Craig’s worker profile in the tenant to see what supervisory organization
he was hired into. Check the organization then look at the spreadsheet to see where the value was
entered.
When an integration event status is completed, you still want to verify the status of the Business
Processes loaded during the event. To view this tab in the Integration Event, you must be a member of
a security group that has access to the Integration Process domain.
You can cancel or rescind business processes triggered by an Enterprise Interface Builder (EIB)
integration when you need to undo the results of an upload. The reasons for this action might be:
Cancellation is allowed for business processes that are in progress, while rescind applies to business
processes that are past the completion step.
Once you've executed an integration and uploaded a spreadsheet, it is stored in Workday as an object.
You can edit this attachment by executing the task 'Edit Integration Attachment' and uploading a new
version of the file. This task must be completed independently of running the integration system.
Note: If you are loading new data using an existing spreadsheet, you must delete the data that has
already been loaded into Workday to avoid errors. Remember, there is a 30 MB limit for all attachments
in Workday.
Business Case: You have been asked to hire a 3rd employee. His information is provided in the table
below. Modify the Act_4_Hire_Employee_24.xml, edit the integration attachment then launch the
WICT EIB Hire Employees integration system.
1. Modify the Act_4_Hire_Employee_24.xml file with the above data and save.
*Don't forget to remove the old data
1. Search for 'edit int att' and select Edit Integration Attachment task from the search results.
2. Click the prompt and select the Act_4_Hire_Employee_24.xml object then click OK.
3. Click the Attach button and navigate to select your updated file (shown in the screen shot above is
replacing Act_4_Hire_Employee_24.xml spreadsheet with Act_5_Hire_Employee_24.xml
spreadsheet).
1. Search for your integration system - WICT EIB Hire Employee. Remember to select the
Integrations category.
3. Select your existing attachment and run it in validate only mode first. Notice that the file you
replaced is no longer available in the list.
5. Verify Andrew Shea was hired by running the WDINST EIB IntNewHire report and answer the
following questions:
The values of Reference IDs are configurable by the customer but the definition of the Reference IDs on
our business objects is defined by our applications. In other words, Workday defines the Reference IDs
for our business objects as well as default values, but our customers can configure these values.
You can define a reference ID by selecting Integration IDs > Edit Reference ID as a related action on an
individual business object. However, if you want to update reference IDs in bulk, use the Maintain
Reference ID task.
Note: Use caution when editing reference ID values. After the ID values have been set, changes to those
values can break existing integrations that use the current ID values.
Note: To edit and maintain reference IDs, you must be a member of a security group with access to Set
Up: Integration security domain or Set Up: System security domain.
Business Case: You've been asked to change the reference ID for the Language Skills reference IDs so
that they are more in-line with the needs of your organization.
1. Search for 'main ref id' and select the Maintain Reference IDs task.
4. Click OK.
6. Change the Reference ID Values for the following Instances then click OK to save then click Done.
When you use the Create EIB task to set up an inbound integration from a web service operation as its
data source, Workday automatically creates a template model as part of the workflow. Generate a
spreadsheet template in Workday that you can use for a data upload. You can optionally modify the
template to meet your needs. This will be discussed later.
Note: Workday generates spreadsheets in XML Spreadsheet 2003 format. To maintain the correct
spreadsheet format, do not change the .xml file extension.
By viewing the template model, you can review the Business Process and sub processes. Additionally,
within each subprocess, you can view the required fields and their required Reference ID Type.
You may need to change the Reference ID Type for a particular field. Once you view the template
model, click on the Spreadsheet Model tab. For each Business Process, you can review the Template
Model Area.
The Reference ID Type retrieved by default maybe the common usage or the first value alphabetically
in the list, and therefore, needs to be verified it is correct for your needs.
For smaller spreadsheets you may want to edit all the data model areas for a business process at once by
selecting the process folder and selecting Edit Template Model Sheet.
Business Case: You've been asked to create a new inbound EIB called WICT EIB Add Organizations
using the Add Update Organization (Web Service). Once saved, generate a spreadsheet so that your
company can load new organizations into Workday.
1. Search for 'create eib' and select the Create EIB task.
5. Notice that the Data Source area is already populated with a Retrieval Method of ‘Attach File at
Launch’.
7. Click the prompt for Web Service Operation and select Human Resources > Add Update
Organization (Web Service).
8. Click Next to access the Transform page and review (no change).
9. Click Next to access the Deliver page and review (no change).
10. Click Next to access the summary page to review your settings. Click Save for Later and OK.
11. Search for your WICT EIB Add Organizations integration system, remember to select the Integrations
category in the Search Results if necessary.
12. Use the related actions menu to navigate to Template Model > Generate Spreadsheet
Template. Check the box to confirm and click Submit. It will generate as a background process
and will be available on the W: Drive.
14. Save the spreadsheet to your hard drive, making note of the location.
Business Case: You've been asked to create a spreadsheet so that your company can manage the
language skills of employees through an integration system that uses the Manage Languages web
service.
Note: Not all steps are defined – use your knowledge and screen shots to assist.
Name it WICT EIB Manage Languages and use the Manage Languages web service:
Modify the Worker in the All template model area under Manage Languages, using the steps that
follow:
1. Using the related actions menu off the integration system, select Template Model > View.
4. Click Edit Template Model Area button and change the following Reference ID Type value by
clicking the prompt:
Modify the Assessed by Worker in the Languages+ (2nd occurrence) template model area under
Manage Languages (details follow).
6. Expand the Manage Languages folder and select the Language+ (second occurrence)
template model area.
7. Click Edit Template Model Area button and change the following Reference ID Type value by
clicking the prompt:
1. Use the related actions menu to navigate to Template Model > Generate Spreadsheet
Template. It will generate as a background process and will be available on the W: Drive.
Save the spreadsheet to your hard drive, making note of the location
(For high volume business processes) Identify the target population for the business process.
The most efficient way to learn the Workday Object Model is through the Workday UI. Another useful
tool is the documentation in the Excel tool tips. Workday now limits the maximum size of inbound EIB
spreadsheets to 300 megabytes (MB).
When launching integration systems, it is recommended to always test in your sandbox before loading
into production. Additionally, use the Validate Only Load, Load Error Limit and Add Errors to Attachment
options when launching your integration.
SPREADSHEET GUIDELINES
Template
Keep the template in its original XML SPREADSHEET 2003 format. Do not save a template to
any other format.
Add only data values to the generated spreadsheet. Do not make formatting changes, introduce
hard breaks or returns, rearrange rows or columns, or add new rows and columns. Doing so may
cause the upload to fail.
Required Data
Data Types
Columns with formats such as YYYY-MM-DD, Y/N, TEXT, or NUMBER accept data only in the
specified format.
To protect spreadsheet cell formatting, either enter values manually or reapply the correct
formats if you cut and paste data from another spreadsheet or report.
Lookup Columns
Columns identified as holding LOOKUP values must be populated with Workday reference IDs,
not the names that appear in the corresponding Workday fields.
If reference ID values are empty in Workday, you must assign reference IDs before you can
upload data.
ID Columns
When left blank, some ID columns trigger Workday's ID generator to assign new ID values
during the upload. Refer to the spreadsheet comments in ID columns to find out whether IDs
are automatically generated.
In addition to uploading new data, you can use an EIB spreadsheet to replace or delete existing
data. Inbound data automatically replaces existing values.
To delete data, enter {empty} values in spreadsheet cells that are formatted as TEXT fields.
You can use any of Workday's spreadsheet import templates to delete data, but deletion is
allowed only in TEXT fields, not LOOKUP fields.
No value entered in
EMPLOYEE TYPE Regular Regular
spreadsheet
SPREADSHEET KEYS
To enter multiple values in a multi-select field, add rows immediately following the initial row and
leave all fields in these rows blank except for the key fields and the fields holding the multi-select
values.
For example, the Cost Center field accepts more than one value; to add multiple cost centers you
need to specify only the Applicant ID (key field) in the additional rows and a reference ID for
each Cost Center:
A01032 61210
It is recommended that you use the ID of the object you are loading if it is available. For example, the
spreadsheet key for data being loaded for an employee can be the Employee ID.
ROW IDS
It is recommended that you use the ID (Spreadsheet key) of the main object followed by -1, -2, etc. for
each child row of data.
RESERVED SYSTEM ID
Another type of external integration ID, the reserved system IDs, are internal system ID values that allow
for backward compatibility between the original v1 and v2 operations in the Workday API and newer
operations that use reference IDs and WIDs. These exist for the original web service operations in the
early versions of Workday's API before the introduction of reference IDs.
We recommend that internal IDs (WD-I) should NOT be used in integrations since they can change as
Workday's object model evolves over time. We will continue to support these internal IDs within our
inbound WWS in order to preserve backward-compatibility.
WD-EMPLID: used to pass Employee IDs or Contingent Worker IDs into a v1 or v2 operation.
Even though as of update 21 the original v1 and v2 operations have been retired, some web service
operations, such as the Add Update Organization web service operation, still reflect the use of reserved
system IDs.
You will see examples of the use of reserved system IDs in the next activity. Pay close
attention when populating the spreadsheet for Organization Reference and Business Site Reference fields.
The combination of System ID and ID fields are the indicator that you need to see what the field is
referring to. If referring to an employee or contingent worker, the System ID is populated with WD-
EMPLID and the ID field is populated with the actual worker ID. If the field refers to anything else
(other than a worker) the System ID field is populated with WD-WID and the ID field is populated with
the 32 character ID.
Business Case: Now that you generated the add/update organizations spreadsheet, you've been asked
to populate it with the data below to create two new Supervisory Organizations that will be subordinate
to Sales Operations Group. Launch the WICT EIB Add Organizations integration system and verify
the results.
1. Open the AddUpdate_Organization_24.xml file created and saved in the previous activity.
Position Management Y
Business Site (use System ID WD-WID and ID of Sales Operations Location WID) columns V & W <Find in Tenant>
Reference
Position Management Y
Business Site use System ID WD-WID and ID of Sales Operations Location WID <Find in Tenant>
Reference (Columns V & W)
1. After the spreadsheet is populated, search for 'WICT EIB' in your tenant and select WICT EIB Add
Organization.
4. In the Integration Attachment Value prompt, select Create > Create Integration Attachment.
7. Select Specify Value for Validate Only Load and check the box.
8. Select Specify Value for Add Errors to Attachment and check the box.
9. Click OK and Refresh until the process is complete (Do not close).
10. If completed successfully, re-run the integration without Validate Only selected. Re-use the same
integration attachment created above.
11. If completed with errors, verify your data on the spreadsheet. Make any necessary changes and
save the spreadsheet locally. Then use the Edit Integration Attachment task to replace the
spreadsheet you first uploaded and try to validate again.
2. What is the reference ID value for Sales Operations - North America? _______________
3. What is the Superior Organization for Sales Operations - North America? _____________
5. What is the reference ID value for Sales Operations - Emerging Markets? _______________
6. What is the Superior Organization for Sales Operations - Emerging Markets? _____________
8. Why is the Business Process Loaded tab missing in the View Background Process?
____________________________________________________
CHALLENGE - Why is there no reference ID for the Organization Sales Operations - Emerging
markets?
Since an Organization_Reference_ID was not assigned to the supervisory Organization of Sales Operations -
Emerging Markets in the spreadsheet, manually assign the reference ID value of
Sales_Operations_Emerging_Markets in the UI.
Do you remember what task provides the ability to edit reference IDs?
Business Case: Now that you generated the Manage Languages spreadsheet, you've been asked to
populate it with the data below for Chad Anderson and Anthony Rizzo. Once populated, launch the
integration system using your spreadsheet and verify the results. You may need to run the Integration
IDs report to help you find the correct reference ID values.
1. Type Int IDs into the Search box and press enter.
3. For Business Object, search for Language and choose the Language Ability Type, Language
Proficiency, and Language Skill Business Objects then run the report.
4. Make a note of the Reference ID values you will be required to populate into the spreadsheet.
_____________________________________________________________________
_____________________________________________________________________
1. Click on the Overview tab and select Automatic Processing for the Manage Language Business
Process.
2. Click on the Manage Languages tab and populate the following information:
Mange Languages
All
Language French
(Reference ID
Type=
Language
Skill)
Assessed On 2015-02-01
Language Russian
Assessed On 2015-02-01
Language Speaking
Ability Type
Language Spanish
Assessed On 2015-03-01
Language Speaking
Ability Type
2. Use the related action icon next to the WICT EIB Manage Language Integration System to select
the Integration > Launch / Schedule task.
4. For the Integration Attachment field Value on the far right, click on the prompt icon.
9. Select Specify Value for Validate Only Load and check the box.
10. Select Specify Value for Add Errors to Attachment and check the box.
11. Click OK and Refresh until process is complete. (Do not close)
12. If completed successfully, re-run the integration without Validate Only selected. Re-use the same
integration attachment created above.
13. Once transferred to the View Background Process report – validate success.
2. Use the related action off of Chad Anderson's Employee Object navigate to Talent > View Skills
and Experience, and then choose the Languages tab to review your results.
As a best practice, start by generating a baseline spreadsheet template and reviewing the spreadsheet
details. Then, edit the underlying template model as needed to define a custom spreadsheet template.
Open the spreadsheet in Microsoft Excel and familiarize yourself with its details:
Look at the overall structure of the spreadsheet, including the individual worksheets and sheet
areas.
Review the column groupings in each area to understand the relationships between fields.
Notice which areas and fields are required, conditionally required, and optional.
Determine whether you want to modify the spreadsheet template. You can make the following changes:
Worksheets - reorder tabs, rename tabs, change sheet titles, or hide sheets completely.
Columns - rename, change area labels, override values, select reference ID types, edit Excel cell
comments, or hide columns completely. You can also maintain occurrences for columns that
accept multiple values, such as worktags, address lines, earnings, deductions, and related
calculations.
You can rename, change area labels, override values, select reference ID types, edit Excel cell comments,
or hide columns completely. You can also maintain occurrences for columns that accept multiple values,
such as worktags, address lines, earnings, deductions, and related calculations.
Within the template model area in the Spreadsheet Model, you can use the related actions menu to edit
the column details.
Business Case: In this activity, you will create an inbound EIB that uses the Request Bonus payment
service. Once created, you will view and modify the template model.
1. Create an Inbound EIB called WICT EIB Load Bonuses for Sales & Marketing using Template
from Request Bonus Payment (Web Service) operation.
1. Search for 'wict eib Load Bonus' and select your newly created EIB.
2. Using the related actions icon, navigate to Template Model > View.
3. With the Request Bonus Payment folder selected, click the Edit Template Model Sheet button.
4. Scroll through the first Template Model Area All and do the following:
5. Scroll down to the Template Model Area Bonus Payment Data and do the following:
6. Scroll down to the second Template Model Area All and do the following:
8. In the Request Bonus Payment folder, select the first All template model area.
13. In the Request Bonus Payment folder, select the Bonus Payment Data template model area.
14. Use the relation actions menu on the Bonus Plan column to navigate to Template Model Column
> Edit Details.
1. Use the related actions menu to navigate to Template Model > Generate Spreadsheet
Template
2. Save the spreadsheet to your hard drive, making note of the location
Saved location: _______________________________________________
Business Case: Now that you generated the spreadsheet, you've been asked to populate it with the
Bonus Payment data below, launch the integration system and verify the results.
1. Search the tenant for a report called WDINST EIB Sales & Marketing Payments.
2. Run the report and review the output. You will use this report to locate the necessary reference IDs
and to validate the data loaded by your integration system.
1. Open the Request_Bonus_Payment.xml file created and saved in the previous activity.
2. On the Overview tab, select automatic processing for the BP (Request Bonus Payment).
3. Enter the information below into the correct columns on the Request Bonus Payment Tab. Some of
the values are accessible from a report that is provided for you called WDINST EIB Sales & Marketing
Payments:
Employee 21103
Position P-00124
Employee 21102
Position P-00123
Employee 21105
Position P-00127
Employee 21165
Position P-00126
Employee 21141
Position P-00143
Employee 21101
Position P-00120
Employee 21166
Position P-00122
Employee 21037
Position P-00040
1. After the spreadsheet is populated, search for 'WICT EIB' in your tenant and select WICT EIB Load
Bonuses for Sales & Marketing. Don’t forget to select the Integrations category.
4. In the Integration Attachment Value prompt, select Create > Create Integration Attachment.
7. Select Specify Value for Validate Only Load and check the box.
8. Select Specify Value for Add Errors to Attachment and check the box.
9. Click OK and Refresh until the process completes. (Do not Close)
10. If completed successfully, re-run the integration without Validate Only selected. Re-use the same
integration attachment created above.
11. Run the WDINST EIB Sales & Marketing Payments report to verify the results.
As of Workday 20, you have the ability to generate a spreadsheet populated with data to aid in loading
data. This option generates a pre-populated spreadsheet based on your EIB's web service operation and
template configuration. You can edit the filter to populate specific data. When complete, you must
download the file from the Notifications section of My Workday report, or locate on your W:Drive.
This feature can be valuable when the need to reload data occurs. You may just need to make minor
edits or additions. The pre-populated spreadsheet can reduce the effort and time required.
If you attempt to generate a spreadsheet with data where the web service operation returns between 60
MB and 300MB of data, Workday splits the output across multiple spreadsheets. If you attempt to
generate a spreadsheet with data where the web service operation returns more than 300 MB of data,
Workday displays an error in the Process Monitor and does not generate a spreadsheet. To resolve this
issue, filter your data by selecting Edit Template with Data Options in the template model’s Data tab.
The Supported Inbound EIB Operations report can be run to identify the web service operations that
currently support the ability to generate spreadsheet with data.
Business Case: Using the Submit Payroll Input Web Service, you will generate a spreadsheet with data
loaded from ongoing payroll input.
1. Search for and run Ongoing Payroll Input with Reference ID report. Use 01/01/2013 as the
Start date and click OK.
2. Note the Payroll Input ID for United Way Annual Pledge Pay Component._________________
1. From the related action off the EIB, navigate to Template Model > View.
2. Scroll down to locate the Data tab; click the Edit Template with Data Options button.
c. Scroll down to click the Generate Spreadsheet Template with Data button.
d. Check the confirmation check box and click Submit and Done.
3. Click the link in your Notifications or on the W: drive to save Submit_Payroll_Input.xml to your local
hard drive. Be sure to maintain XML Spreadsheet 2003 format.
Batch ID WICT-EIB-UnitedWay
1. Scroll down and click the Usage tab. Use the related action of the WICT EIB Submit Payroll
integration system, launch it to Run Now.
4. When complete, re-run the Ongoing Payroll Input with Reference ID report and note the
changes loaded with your EIB.
New import web services were made available with update 21 that are optimized for performance. The
benefits are improved availability of the Workday application for other users and systems, and reduced
time and effort to monitor and troubleshoot the spreadsheet load.
The Import web services highlight a 2-tab spreadsheet template format and template model support.
The integration event is enhanced with drillable errors providing access to view detailed data and
exceptions.
And more! Be sure to use ‘import’ web services instead of the older ‘submit’ web services when
possible, to take advantage of the performance improvements.
Understanding the way Workday handles integration errors enables you the ability to troubleshoot
problems more easily. Always check the status of an integration event by accessing the Process
Monitor or Integration Event and view message details by drilling down on the number of Errors &
Warnings column.
EVENT STATUS
MESSAGE SEVERITY
WARNING Ann Smith has missing Processing continues Completed with warnings
or invalid data. The
value 1223-456-78910
is too long for “Phone
Number” and will be
truncated in the output.
Phone Number should
have length equal to or
shorter than 12.
ERROR Errors during data load. Processing continues Completed with errors
See report for details. unless the error
threshold has been met.
MESSAGE COMPONENTS
Context Identifies the source of the problem, such as the name of the worker or integration
map that caused the error.
Condition Describes the error condition, such as invalid data, missing fields or attributes, or
empty map values.
An integration event can generate up to 500 error messages before processing stops. Although warnings
do not affect integration processing, the number of warnings is limited to 500 at which time a final
warning is issued. Workday processes inbound and outbound integrations differently when errors occur.
Workday processes the entire batch of transactions in inbound integrations. If an error occurs, Workday
generates an error message, skips the transaction that caused the error, and continues to process the
other transactions in the batch. Transactions without errors execute successfully.
When an error occurs in an outbound integration, Workday does not transmit any data but fully
processes the file to produce a comprehensive error report.
Integration Exception Audit: Lists exceptions for integration systems. The report summarizes
critical errors and warnings by integration system and provides suggestions to help you resolve each
problem. Workday does not prevent you from launching an integration with exceptions, but you can
avoid integration failure by viewing the exception audit to identify issues and take action.
Scheduled Future EIBs Exception Audit: Lists exceptions in EIB integrations that are scheduled
to run in the future. The report identifies two types of security-related exceptions:
EIBs that cannot be launched by the scheduled user due to insufficient security. Resolve the
exception by modifying the current user's security permissions, or transferring ownership to
another user.
EIBs that cannot be triggered by workflow steps in business process definitions due to insufficient
user security. Either modify the security for the user specified in the workflow step, or edit the
business process definition to assign a different user to the step.
Business Case: You have been given a spreadsheet that contains three new hires. You've already
created the integration system to hire employees so you are ready to launch and upload the
spreadsheet!
TASK 1 : Launch the WICT EIB Hire Employees integration system in validation mode and upload
the Act_14_Troubleshooting_HireEmployee_24.xml provided in the .zip file, in the Inbound Spreadsheet
Solutions folder.
TASK 2: Now that you've determined the need to create two applicants, you can populate the fields
on the Hire spreadsheet to create the applicants during the Hire upload.
1 US Cynthia Lee
3 US Michael Renato
1 cynthialee@gmail.com
3 mrenato64@yahoo.com
1 N
3 N
1 Y WORK
3 Y WORK
TASK 3 : Edit the integration attachment in your tenant and launch the WICT EIB Hire Employees
integration system using the updated attachment.
OUTBOUND EIB
There are two options as the data source for outbound EIBs: Reports as a Service or Workday Public Web
Service. We will take a look at each.
Workday enables you to expose advanced custom reports as web services that can be called in an
integration.
When you enable a custom report as a web service, Workday generates a unique RaaS namespace for
the report, using the following format: urn:com.workday.report/Report_Name where Report_Name is
the name of the report.
The RaaS namespace remains fixed even if the report owner changes due to transfers of ownership or
the report name changes. This prevents integrations that rely on the report's output from being unable to
retrieve data if the report owner changes.
You can edit the namespace for a custom report. However, you should consider the following:
Reports that are enabled as a web service must have labels defined for all columns, prompts and related
business objects.
When you enable web services for an Advanced custom report and expose the report for integration
scenarios, the maximum size of the response that can be returned is 2 GB.
Create an outbound EIB to export data from Workday by using a custom report, a REST URL, or a
Workday Web Service operation as a data source. This task uses the EIB configuration wizard to simplify
the setup process. The wizard guides you by filtering the configuration options for an outbound data
flow.
CREATE EIB
After naming and selecting Outbound as the direction of the EIB, the General Settings page is displayed,
just as with Inbound EIBs, where you can edit to add a description.
GET DATA
Custom Report: Select an existing custom report definition at the prompt. The selection
list only shows custom reports that are enabled for web services.
Web Service Data Source: Select an existing web service data source if one has already been
defined. Web Service data sources must be created using the Create
Web Service Data Source task to show in the list.
If you want to generate the report output in a format other than Workday XML, select an Alternate
Output Format. This option is only available when a custom report is defined as the Data Source.
TRANSFORM
You may optionally transform the output of an XML file. You may select:
New Custom Report Transformation: Custom Report transformations enable you to define
output order, format individual report, and add headers
and footers to output files.
DELIVERY
You can specify where to deliver the data. The options are:
Workday as an Attachment
The output file is attached to the integration event in Workday.
AS2
Email
FTP
FTP/SSL (FTPS)
HTTP/SSL
SFTP
WebDAV
You will also need to specify a file name with a valid extension type and a document retention policy. A
retention period is required when you send an output file back to Workday as an attachment, and is
recommended for audit purposes when you send an output file to an external endpoint. After the
integration runs, Workday attaches the output file to the integration event for the specified length of
time. Optionally, you may compress, encrypt or restrict the target environment for this delivery.
Once you launch the Enterprise Interface you will be transferred directly to the View Background Process
page. Click the Refresh button on this page until you see the Status change from Processing:
If there are no errors, the Status will change to Completed, and the Output Files tab will contain the
output file if Workday attachment was the configured Transport Protocol:
INTEGRATION EVENT
Every time an integration system is launched, it creates a new integration event. The integration
background process performs any required transformations and outputs the appropriate files or web
service messages.
The event can be accessed via the Process Monitor, however, the Integration Events report is
especially designed to monitor and review the results of integration events.
Tasks to Use
Edit Custom Report
Create EIB
2. Use the related action for the WDINST EIB IntNewHire report definition that we used in the
inbound activities, and select Custom Report > Edit.
3. In the Columns tab, remove the following fields: Worker and Employee ID.
4. In the Prompts tab, add rows for the Hire Date filters that are configured to prompt and enter
Label for Prompt as shown:
5. Click OK to save.
6. From the related action of the report name navigate to Custom Report > Edit.
The Web Service API Version and Namespace will populate automatically.
8. Click OK to save.
9. Notice Column Heading Override XML Alias fields populate automatically in the Columns tab.
5. Click Next to access the Get Data page, then use the pencil icon to access Edit mode.
6. Accept the default of Custom Report in the Data Source Type drop-down menu.
7. Use the prompt to locate and select the WDINST EIB IntNewHire report.
8. Click Details to select CSV as Alternate Output Format and click Done.
10. Accept the default Transformation Type of None and click Next to access the Deliver page.
12. Delivery Method and Details default to Workday Attachment, which is what we want.
13. For File Name specify NewHireIntegration.csv (*you must name the file with an extension).
3. Accept the default Run Frequency value of Run Now. Click the OK button.
4. You will be prompted for the Report Parameters. Enter values as follows:
Field Value
Start 01/01/2013
1. Once you launch the NewHireIntegration Integration System you will be transferred to the View
Background Process page.
2. Click on the WICT NewHireIntegration link (blue text) at the top, or the Refresh button, to refresh
the page.
3. Scroll down while on the Integration Details tab and notice our Workday attachment file.
4. Explore the other tabs. The .csv file is available from the Output Files (1) tab. Download to verify
the alternate format by opening in Excel.
10. You will then be transferred to the same event details (View Background Process) page previously
seen.
SECURITY PROXY
Sometimes the Workday account that needs to launch the EIB does not have security privileges to run
the report that is configured as the data source. It is possible to create a security proxy to grant access
to the report for the purpose of executing the integration. This ensures the integration user can access
only the report, and not other items.
Once the security proxy is created, the EIB must have the Run As User set to the Proxied Workday
Account. Now the Authorized Workday Account will be able to launch the EIB.
The expiration date is not required and if left blank, the Security Proxy will continue to work until it is
deleted.
Sign in as Teresa Serrano (tserrano) using the password you were provided
2. Use the related action to locate the option for Integration > Launch/Schedule.
Sign in as Logan McNeil (lmcneil) using the password you were provided
2. Configure as follows:
Sign in as Teresa Serrano (tserrano) using the password you were provided
2. Use the related action to locate the option for Integration > Launch/Schedule.
Field Value
Start 01/01/2013
6. Sign out.
INTEGRATION SCHEDULING
The Integration Scheduler can launch an integration background process with five different options:
Run Now: You have seen this option already, in the previous activity.
Run Once in the Future: An integration can be scheduled to run once at a future date/time
(for example, 8pm tonight).
Daily Recurrence: An integration can also be scheduled to run daily, at a specified time, from
specified starting and ending dates.
Weekly Recurrence: Similar to the Daily Recurrence option, but run weekly or on specified
days of the week.
Monthly Recurrence: Similar to the Weekly Recurrence option, but run monthly or on specified
days of the month.
To schedule an integration, use the Integration > Launch/Schedule related action off the EIB integration
system, or initiate the Launch/Schedule Integration task. The task can be located by searching for
“sched int”.
The Launch / Schedule Integration task is a generic page used to launch or schedule any 1)
Workday delivered or 2) customer defined integration as a background process. It supports scheduling
and launching both Enterprise Integration Builder (EIB) integration systems and other types of
integration systems (such as those created using Workday Studio) as background processes.
There are three parts to scheduling an integration. The user that schedules the integration background
process must do the following:
Run Now
Run Once in the Future
Daily Recurrence
Weekly Recurrence
Monthly Recurrence
Enter the Selection Criteria: The integration selection criteria are specified on the Integration Criteria
tab on the Schedule an Integration task. For each selection criteria field, you can either enter the value or
have the system determine the value at run time. For recurring integrations, when you specify the
integration criteria value explicitly in the scheduled process request, that value will be used each time the
integration is launched. If you select to determine the value at run time, the selection criteria field value
will be calculated each time the integration is launched at the time the integration is launched. Unless
you desire unique filenames, typically only date fields are determined at run time, since they are the only
fields that vary over time for a recurring process.
2. Enter the Scheduling Parameters: Based on the chosen Run Frequency. The user must also
enter the Recurrence Type, Start Time, Time Zone and the Range of Recurrence. For the Range of
Recurrence, the Start Date cannot be before the current moment (taking into account the Start
Time), and the End Date cannot be beyond Dec 31st of the next year.
The Schedule tab will vary, based on the chosen Run Frequency.
To view a list of the integration requests you have scheduled but not yet run, navigate to the Scheduled
Future Processes report. Once an integration has been initiated, you can view the status of the
background process (such as scheduled, running, completed, success, and so on) on the Process Monitor
report. From the process instance displayed in the Process Monitor, you can also view any integration
errors that occurred.
The Scheduled Future Processes report enables you to view the integration requests that are scheduled,
but not yet run. This includes both recurring integrations and one-time integrations scheduled to run at a
future date or time. Through the Integration Requests report, you can view the details of the integration
request by clicking on the Integration Process Description associated with integration request. To view
the detailed schedule criteria associated with the request, click on the Trigger field in the usage section of
the page.
You can also suspend or activate a scheduled integration by selecting the appropriate related action on
the Integration Process Description field associated with the integration request. Suspending an
integration request causes the system to continue to increment the recurrence at the appropriate time,
but does not initiate the integration background process. Activating a suspended integration request
causes the system to resume launching an integration background process at the next appropriate time
based on the scheduled recurrence. The Status column on the Scheduled Future Processes report
indicates whether an integration request is currently active or suspended.
Monday – Friday. You will schedule the integration to run within the next 15 minutes (from now) for the
first time. It should then run every day at the same time. We will first edit the integration system to
output to SFTP.
Process Monitor
Sign in as Logan McNeil (lmcneil) using the password you were provided
1. From the Related Action icon of the WICT NewHireIntegration system, select Enterprise
Interface > Edit.
4. Click the prompt for Delivery Details. Complete using details provided by your instructor.
The following screen shot serves as an example:
5. Click Done.
1. Use Search to find the Launch/Schedule Integration task, or use the related action off of the
integration system.
Start Value Type = Determine Value at Runtime: Value = First Day of Last Calendar Year
6. Click on the Schedule tab located near the upper left hand side of the screen.
10. Refresh the Scheduled Future Processes task after 15 minutes has passed, to verify that the Number
of Times Run column has changed from 0 to 1.
11. The instructor will display the SFTP directory to verify delivery of the output file.
It is also possible to launch an integration directly through the execution of a business process. Using
the Hire Business Process as an example, each time an employee was hired, an EIB type of integration
could be launched as a background process to deliver the new employee’s information to an outside
system.
Create & Configure Integration System: The design of the integration system must match
up with the available object model of the corresponding business process. If the architecture is
using a Workday Custom Report as the Data Source, then the report must be modified so that it
can accept the passing of a variable from the business process to the Report Prompt in the EIB.
Modify Business Process/Add Integration Step: A new step in the business process is
added. It is identified as being an “Integration” type step. Finally, an integration system is
identified to be launched with the business process is executed.
Configure Integration Step on Business Process Definition: Only after the Integration
step is added to the business process and saved can it be configured. Using the related action
icon you can configure to the integration step by choosing which values/objects will be passed to
the integration system (if the integration system requires parameters). Exit criteria can also be
specified so that the integration is launched under certain circumstances.
A business process is the definition of tasks that need to be done in order for an event to occur, the order
in which they must be completed, and who must do them. The business process definition specifies the
security group responsible for each step in the process, notifies the workers in these groups, and gets
feedback on when each step is complete so it can move on to the next step. Steps can also be
conditional.
Once a step is added to the business process and it’s saved, you can modify that step by using the
related action menu of the step.
To edit the steps of a business process, use the related action menu and navigate to Business Process >
Edit Definition.
You can add steps to the business process, change the order of steps, and select the type of step. In our
example, we will add an Integration step to the BP: Hire for IT HelpDesk Department.
Tasks to Use
Create EIB
1. Search for WDINST EIB. Select the Reporting or All of Workday category.
2. Use the related action off of the WDINST EIB IntNewHire report definition and navigate to
Custom Report > Copy.
3. Change the name of the report to WICT EIB BPIntNewHire and click OK.
b. Add a new filter (by clicking on the icon). Select Worker (note self-reference icon) as
the field against which to filter. The filter should have the values below :
5. Similarly, change the Prompts tab, deleting the Prompt Defaults for Hire Date, and adding a row for
the Worker filter. Leave the Prompt Qualifier value as defaulted (Default Prompt). Notice the Label
for Prompt XML Alias defaults in as “Worker”.
7. Click Run and enter Logan (or another worker) as input. Note that the search might look different
from what you are used to, but entering “logan” in the search and pressing the Enter key on your
keyboard will show Logan McNeil in the prompt.
8. Click OK to run the report with Logan (or another worker) as input and view the results. These are
the results you will eventually want to see in a CSV file, but for a new hire, as the result of
completing the Hire business process.
4. Choose Outbound.
5. Click OK.
6. Click Next to access the Get Data page; then click the Edit icon.
7. Click on the Custom Report prompt and choose your WICT EIB BPIntNewHire report.
9. Click Next twice or simply click to access the Deliver page; then click the icon to Edit.
11. Provide a File Name of BPNewHireIntegration.csv (*don’t forget the file extension).
13. Click Next to review the Summary page and click Save for Later and OK.
1. Search for bp:hire to find the Hire for IT HelpDesk Department Business Process.
2. View the Hire Employee for IT HelpDesk Department BP and verify that step b is marked as the
completion step:
3. On the Hire Employee for IT HelpDesk Department BP, use the related action to choose Business
Process > Edit Definition.
5. Click the icon to add a new Step (row) to the Business Process definition.
6. Make it the 3rd step in the process by entering a ‘c ’ in the Order field.
7. In the Type field define the new step as an Integration step using drop down list.
14. For the Worker Parameter, specify Determine Value at Runtime for the Value Type, and specify
Worker (search for Worker and scroll down to select the self-referencing Worker object) for the
Value.
15. Leave the other fields defaulted (to Use System Default).
3. From Related Action off of the Senior IT Analyst (Unfilled) position, select Hire > Hire
Employee.
4. For Existing Pre-Hire search for and select Jack Williams, then click OK.
6. Click the Submit button to save and initiate the Hire process.
11. Click Done. Notice the Plan Details now includes the General Salary Plan as the Plan Name and
$65,000.00 as the Amount.
4. Use the related action on the most recent WICT BPNewHireIntegration listed under the Request
column and select Background Process > View Output Files.
6. Now search for Jack Williams. Choose the All of Workday category.
Available now in Workday is the ability to configure custom report transformation as an alternative to
developing a custom XSLT file. To use this feature you must have created an outbound EIB that uses a
web service enabled custom report as its data source (RaaS) and is configured with Custom Report
Transformation selected for the Transform step.
Configure as much as you can in the custom report, rather than the transformation.
Use a custom report that already has the fields you want, in the order that you want.
If you add report fields to, or remove report fields from the custom report definition, Workday
automatically adds or removes the corresponding columns in the transformation when you select
Enterprise Interface > Configure Transformation.
If you make other changes to the custom report after creating the transformation, you may need
to edit the transformation to accommodate these changes. When you change a custom report,
you should test any EIBs or Studio integrations that are dependent on it.
Use of Delimiter characters and fixed column width should usually be exclusive of each other.
STEPS TO CONFIGURE
2. As a related action on the EIB, select Enterprise Interface > Configure Transformation.
After a custom report transformation is first created, the grid will display a source and target column for
each report field in the Custom Report.
5. (Optional) Select the Header tab and format the output file header:
6. (Optional) Select the Footer tab and enter an Optional Report Footer.
7. Specify the Delimiter character such as (,) or (;) that should separate each column in the output
file. You can enter \t for tab characters or \s for space.
If you need to delete your Custom Report Transformation, select Custom Report Transformation > Delete
as a related action on the transformation (not the EIB). If you then run the EIB, Workday does not
transform the output file.
1. Search for WICT NewHireIntegration. Be sure to select the Integrations or All of Workday
category and use the related action to access Enterprise Interface > Edit.
6. From the integration system related action menu, select Enterprise Interface > Configure
Transformation.
8. Click the row for Legal Name – Last Name. Change the Column Heading Override to read “Last
Name”.
10. Click the row for Cost Center –Name. Enter the Column Width as 12 and a Pad Character of &
and select Right Padding.
11. Click the Header tab and enter WICT GMS New Hires as the Optional Report Header.
12. Click the Footer tab and enter End of Data as the Optional Report Footer.
1. Search for WICT NewHireIntegration . Remember to select the Integrations category. Choose
Integration > Launch/Schedule from the related action and Run Now.
2. Enter January 01, 2013 for the start date and today as the end date for the launch parameters.
4. Download the output file and open in a text application, like Notepad. Notice the file is pipe delimited
and contains the header and footer as you configured.
Also note the Cost Center Names are truncated when they exceed the length you defined, and padded
with & when shorter.
CUSTOM XSLT
EIB & CUSTOM XSLT & WORKDAY WEB SERVICES (WWS)
There are times when Workday does not present output in the desired format for simple integration
tasks. One example is upper-case and lower-case letter. Workday stores people’s names in mixed-case,
but another system might require the last name appear as all upper-case letters. Another example might
be Social Security Number. SSN is typically formatted as a 9 digit numeric value (if unmasked). Another
system could require that the data be passed but, only the last 4 digits. In this case an Extensible
Stylesheet Language Transformation (XSLT) could be implemented with the EIB.
Formatting: If Workday data comes out of the system and is incompatible with the external
system, XSLT can be used to transform the data. Some common examples are date fields. Many
external systems require a different date format from Workday. XSLT can be used to reformat
the data to suit the endpoint’s needs.
Conditional Logic: The standard EIB transformations do not allow for conditional logic. There
are times when the output format should be different based upon the value of a particular data
element. An example might be a contingent worker vs. a full time employee. Using if/then logic,
the output can be tailored to which type of worker the XSLT is attempting to transform.
Custom Output: Finally, an integration can be scheduled to process based on the scheduling
criteria that is defined by the user and the passage of time (for example – the first day of each
month). The benefit is that the integration does not need to be manually launched each time.
Another example would be to launch a benefit carrier integration each Friday at 6pm.
XSLT FUNCTIONS
Workday does not generate or validate XSLT. This document is created outside of Workday using
non Workday technologies and applications. For more information on XSLT functions, you can review
the following public web site: http://www.w3schools.com/xpath/xpath_functions.asp
XSLT attachment transformations are custom transformations that you create by using Extensible
Stylesheet Language Transformation (XSLT).
Use the Create XSLT Attachment Transformation task. Simply name the XSLT Attachment
Transformation and provide any comments that are necessary. Browse for your file and attach it to the
Workday system.
Once the file has been uploaded using the Create XSLT Attachment task, it is available to select in the
Enterprise Interface configuration wizard.
CONFIGURE TRANSFORM
The Transform page of the wizard is configured to reflect your options. When using an XSLT attachment,
the Transformation Type is set to Custom Transformation; and the Custom Transformation field is used
to select your uploaded XSLT attachment.
Tasks to Use
2. Find the Act20_XSLT_IntNewHire_SubstringSSN.xsl file and right-click and select Open With to open
it with the Notepad text editor, or Wordpad, or Notepad++, or any other text editor (IMPORTANT: do
not open the .xsl file with a browser such as IE).
4. Close the editor, making sure not to change the contents of this file (close, do not save).
5. Search for the WDINST EIB IntNewHire report. Choose the Reporting or All of Workday category.
Select Custom Report > Edit from the related action.
6. Simplify the Column Heading Override XML Alias setting for use with the XSLT document as shown:
5. Use the related action off the WICT NewHireIntegration to select Enterprise Interface > Edit.
8. Search the Custom Transformation field prompt to select WICT Transform IntNewHire, the XSLT
attachment you created earlier.
1. Use the related action icon to Launch/Schedule the WICT NewHireIntegration integration system.
‘You are leaving this task. Your changes will be saved’, click OK.
6. When completed, open and review the output, verifying that only the final 4 digits of the Social
Security Number appear in the output for employees who have SSNs entered in the tenant.
Once you have uploaded an XSLT file, it is stored as an object in Workday. If you make changes to the
file outside of Workday, you must upload the new version to replace the existing file stored. You
execute the Edit XSLT Attachment Transformation task. This will enable you to upload the new
version without creating a new object. No additional edits are needed to the integration system itself.
When you transform very large amounts of data, outbound EIBs with custom XSLT transformations
consume as much as 10 times the amount of memory that the source data requires. Workday
recommends that the amount of data transformed not exceed 100 MB. Although EIBs that transform
more than 400 MB of data have a high risk of malfunctioning, Workday still attempts to complete all EIBs.
The maximum amount of memory that is allocated to an EIB transformation is 15 gigabytes (GB).
An EIB's custom XSLT transformation portion can process for up to 2 hours. Custom XSLT
transformations that spend more than 2 hours processing are terminated automatically.
We recommend that you take one or more of the following steps to avoid malfunctions:
Run the EIB with different filters, using either custom report filters and/or launch parameters to
filter the data source to reduce its size.
If you are in the process of designing/developing Workday integrations, please consider the future
growth of your data when choosing between implementing on EIB vs. Workday Studio.
2. Remove the Position and the Cost Center information (fields in your report need not be displayed
in the resulting output file.)
3. ADVANCED (optional): Change from comma separated to pipe “|” separated.
Tasks to Use
1. Open your XSLT with a text editor, Notepad, Notepad++, Wordpad, or any text editor you are
comfortable with. Do not open in a browser window.
(Hint: http://www.w3schools.com/xpath/xpath_functions.asp)
5. Also, either remove or comment out (using “<!--” and “-->” comment start and end) the lines which
output the Position and the Cost Center data, and anything else needed in order to remove these two
columns.
6. Save the file with a name different from the original .xsl file (such as IntNewHire_UPPER.XSL)
1. Use the related action icon to Launch/Schedule the NewHireIntegration Integration System.
2. Same as the previous activity, enter January 1st, 2013 for the Start (Enter Today’s date for the End)
ADVANCED (optional):
More XSLT Practice: Change from a .csv to a .txt file, and from a comma separator “,” to a pipe separator
“|”
2. Test your resulting file (if using Excel, file can be named .txt, and then open it in Excel and use the
wizard to specify | delimited)
All Business Objects (BOs) have Workday IDs (WIDs). “Simple Types” display in black whereas Business
Objects display as blue hyperlinks that are actionable. Business Objects have a related action icon.
Business Objects are related and either have a 1:1 or 1:M relationship. Compare icons below—Position
ID (‘T’ext) vs. Position (1:1).
Workday enables you to expose advanced custom reports as web services. Web services allow inter-
operable, machine-to-machine interaction over the Internet. In Workday, web services present report
results as URLs, enabling integration between Workday and external business services, such as payroll or
benefits providers.
WORKDAY XML
The Workday XML option outputs the literal, and somewhat advanced, XML code used internally within
Workday. This option might be useful in cases where REST (representational state transfer) or SOAP
(simple object access protocol) is used to leverage Workday's sophisticated use of the XML language.
Review the following example of a report in Workday XML. Notice that the related business objects have
more data than simple types. The Workday ID (WID) is also included for each of the business objects.
Workday XML may be too complex for many integration needs, such as quickly creating a refreshable
report with Microsoft Excel. In such cases, the Simple XML option may be more appropriate.
SIMPLE XML
Simple XML is particularly useful for basic desktop integrations, in which a knowledgeable user wants to
integrate with other reporting tools such as Microsoft Excel or Crystal Reports. With Simple XML, the
complexity of Workday XML is distilled into basic XML elements that are simple to understand and can be
processes by many desktop applications.
Simple XML results in XML that is easier to read and understand than Workday XML. Here are a couple of
key examples of how it is different:
Workday XML is the default output of an EIB unless an alternate output is selected or a custom
transformation is applied.
ALTERNATE OUTPUTS
CSV
The CSV (comma separated values) output option is likely to be used by a user wanting to import data
into a spreadsheet as simply and quickly as possible. No knowledge of XML or schemas is required.
RSS
RSS stands for Really Simple Syndication. It is an XML standard for publishing frequently updated content
over the Internet. Common examples of such content are news headlines and blog postings.
GData
The GData output option is useful for integrations with Google gadgets and other cases where it is
desirable to allow programmatic access to this data format.
JSON
The JSON (JavaScript Object Notation) output option is provided for use in system-to-system integrations
where this data format is required.
Elements have start and end tags: <wd:Last> & </wd:Last>. Elements can contain other elements,
attributes, & text (data).
Ex: wd:ThePos contains wd:Descriptor attribute (which is set to Web Content Manager)
Steps:
1. Modify WDINST EIB IntNewHire custom report so that the following RBOs are included:
Add the Cost Center field below the Cost Center – Name field (shown above.) Same with Position
below the Position ID (also shown above.) Place the Manager – Level 01 field anywhere you like.
2. Run the updated custom report. Note that the three added RBOs appear as actionable blue text.
3. View the XML for the RBO fields by using the Web Service > View URLs related action:
4. When prompted, enter a start date of Jan 1, 2013 and end date of today’s date in order to get
several workers in the output.
5. On the View URLs Web Service page, click “Workday XML” (blue text, to the right of REST).
6. If you are clicking on Workday XML for the first time for this report, you will be prompted to enter
username (lmcneil) and password. The resulting XML appears in the browser.
7. Note the RBO fields have more data than the Simple Type fields (compare CC with TheCC):
Scenario: Now that you have changed the custom report so it uses the Position RBO field
instead of the Position ID field, change the XSLT code in order to get the Descriptor for the
Position in the resulting output file (you can choose either comma or pipe separated output
format.) For example, instead of Position ID “P-00230” the desired value in the output file is
Position Descriptor “Web Content Manager”.
Modify WDINST EIB IntNewHire custom report (already done, in previous activity)
Review the output XML (already done, in previous activity)
Modify the XSLT code and upload to tenant
Re-Run integration
Review the result
Steps:
1. Now that you see how RBOs appear in the XML output, change the XSLT code in the .xsl file from the
previous activity so that instead of outputting the Position ID, output the Descriptor on ThePos
column. HINT: The required XSLT uses a “@” to get an attribute value. The below screenshot
shows the desired output:
2. For those wanting help on the previous step, the desired XSLT is shown on the next page …
3. To get the Description on ThePos field use this XSLT code "wd:ThePos/@wd:Descriptor", as shown
inside the for-each loop here:
4. Once the XSLT file is modified, upload the new version to Workday using the Edit XSLT
Attachment Transformation task.
XML data that has not been entered into a spreadsheet can be loaded via an Inbound EIB. Generally,
this data will need to be formatted to match the Workday data structure and will require XSLT to
transform the XML. It is recommended that if you have large files that require transformation, it is more
efficient to create an integration system using Workday Studio.
XSLT
XSLT (Extensible Stylesheet Language Transformations) is a declarative, XML-based language used for
the transformation of XML documents. See the WSDL document for a full description of the web service
operation and its elements.
WSDL
You must fully understand the web service operation you are invoking in order to properly transform the
data you are importing to meet Workday's data structure and data validation rules. The Web Service
Description Language (WSDL) is an XML document that describes the Operations within that service, the
elements within the request and response message to invoke those operations. Your inbound XML file
must match the defined requirements. Below is the WSDL for the Update Employee Personal Info
description. You can see how the elements are defined in the XSLT on the previous page to transform
the original xml document to meet the requirements of Workday.
When you create the inbound EIB, in the Get Data page, select the appropriate Retrieval Method rather
than attachment to pick up the file from an external server. The Retrieval Details contains the address,
directory and authentication. You must also specify the file name. Set the Data Format to None.
Generally, the xml file will need to be transformed. You will create an XSLT attachment to upload the .xsl
file. In the Transform page of the EIB, set the Transformation Type to Custom and select your uploaded
XSLT attachment.
Finally, specify the Delivery Service and Web Service Operation that is invoked to update Workday.
Like an integration attachment, the XSLT file is created and stored as an object in the Workday Tenant.
Once the XSLT Attachment has been created, it can be edited using the Edit XSLT Attachment
Transformation task (very similar to editing an Integration Attachment).
5. Click OK.
14. You need to upload a custom .xsl file, but the only option is to select from a list. In the search box,
enter create xslt and select the Create XSLT Attachment Transformation task. Notice your
changes to the EIB are automatically saved when you navigate away.
15. Enter ‘WICT EmployeeEmail" in the Name and click Attach to select employee_email_24.xsl
found in the Activity24_XML_Inbound folder. Click OK and Done.
16. Search for the WICT EIB Maintain Contact Info integration system and use the related action to
access Enterprise Interface > Edit.
18. Select Custom Transformation from the Transformation Type drop-down menu.
19. In the Custom Transformation field, select WICT EmployeeEmail. This is the file you uploaded
with the Create XSLT Attachment task.
22. Use the Workday Web Service Operation prompt to search and select the Maintain Contact
Information (Web Service).
24. Click Save for Later and OK to complete the creation of the EIB (Integration System).
25. Use the related actions icon to launch the integration and Run Now.
26. First run the integration in Validation Mode. Once successful, re-run out of validate mode.
27. To verify, look up Employees 21142 and 21019 in the tenant and view their contact information.
Additional Challenge
Review the Human Resources WSDL document for the Maintain Contact Information (Web Service)
operation.
All Workday Web Service operations are invoked by a request message. Workday will process the
request and send back a response message. To learn more about the Request and Response XML
elements for each operation, please see the API documentation on Workday Community.
To view the Request XML, access the integration system and edit the data source by using the related
actions menu of the Data Source on the Configuration tab.
The default request message contains all sub-elements, including those that are optional or mutually
exclusive to other sub-elements.
RESPONSE FILTER
You can filter the response message return from Workday by adding Response Filters. Each Web
Service Operation has defined Response Filters. For example, the Get_Workers_Request has four,
including Page and Count.
3. Click OK.
4. Use the Create EIB task to create an Outbound EIB named WICT EIB GetWorkers WWS.
8. Accept the default Delivery Method and Details and enter a File Name of GetWorkersOut.xml
9. Accept the default Document Retention Policy and click Save for Later and OK.
Note the warning “No RequestXML and Launch Parameters have been defined for the Web Service Data
Source. Use the Edit task for the Web Service Data source to complete the setup.
10. If necessary, search for and select your EIB. To fix the warning, select the Related Action on the
Data Source Get Workers Web Service Data Source > Edit.
11. Click the (-) to delete the Launch Parameter (the UI incorrectly assumed we wanted at least one
Launch Parameter).
12. Replace the Request XML with the following input XML for the Get_Workers WWS API:
<wd:Get_Workers_Request xmlns:wd="urn:com.workday/bsvc">
</wd:Get_Workers_Request>
14. If your new EIB is not displayed, use Search to find it (recall, it is an Integration System).
15. Notice that the Warning message (from a previous step) no longer exists.
16. Launch this EIB (Run Now) using System Default values (no changes).
17. The results will be quite large (8+ MB), so do not open this file in any browser or editor. Instead,
continue to the next step (Part 2) to obtain a somewhat smaller file as the result.
Part 2: Slightly change the Request XML by specifying that you would like to retrieve only page number
4 of the results, as shown here:
<wd:Get_Workers_Request xmlns:wd="urn:com.workday/bsvc">
<wd:Response_Filter>
<wd:Page>4</wd:Page>
</wd:Response_Filter>
</wd:Get_Workers_Request>
18. Note that to do above, you will once again need to delete a launch parameter (which the Workday UI
assumed you wanted).
19. Launch and then open the resulting xml file in a browser (or an XML editor if you have one), and
investigate the structure of the xml output, such as the Worker_Data.
LAUNCH PARAMETERS
Workday provides a default XML request message that includes the tokens you can use as input
parameters. Tokens are delimited by % signs, such as %Workers%. The XML request message and
launch parameters for a particular web service data source apply to all integration systems that use that
data source. However, you can specify different parameter values at each launch. Integration system IDs
are appended to the data source name to identify each usage.
Steps:
1. From the integration system from the previous activity, again use the Edit Web Service Data Source
related action to change the Request XML as follows:
<wd:Get_Workers_Request xmlns:wd="urn:com.workday/bsvc">
<wd:Response_Filter>
<wd:Page>4</wd:Page>
<wd:Count>%count per page%</wd:Count>
</wd:Response_Filter>
</wd:Get_Workers_Request>
2. This time, instead of deleting the Launch Parameter, specify a Launch Parameter with a Name of
count per page.
6. Launch and specify a count per page of 1 (change the default you had set to 10).
Just like you can apply a custom transformation to an EIB created using a custom report, you can apply
one to an EIB created using a Workday Web Service. The steps to apply the xls document are the same.
There is an example on Workday Community that is specific to the Get_Workers Web Service Operation
called "Extracting HR-XML Using GetWorkers & EIB". You may wish to follow this example and
compare the output of the file with and without the custom transformation.
Tasks to Use
Configure Integration System
Edit Integration Transformation
Launch Integration System
Steps:
2. Choose the top-most result page: Extracting HR-XML using GetWorkers & EIB.
3. The URL should show node 6478 (https://community.workday.com/node/6478) which looks like the
following two screenshots (showing the top and the bottom of that page, the bottom containing
some XSLT code in an .xsl file attachment):
4. Scan through the instructions (they should reinforce previous activities), and stop on the bottom at
the Attachment table, which contains an .xsl file (GetWorkers2HRXML.xsl).
5. Download the GetWorkers2HRXML.xsl file, then upload it as the transformation step of your EIB from
the previous activity.
6. Launch your EIB for 2 or more workers, view the results, compare the HR-XML with the previous
Workday XML data for Workers.
EIB FEATURES
NOTIFICATIONS
To help monitor integration events, you can create one or more notification messages to send to
specified groups for integration events. You can trigger notifications for events. The notifications can be
sent to a Workday Inbox, email address, or both. The maximum size of a Workday email notification is
20 MB. Workday does not process email notifications larger than 20 MB and does not display error
messages in this situation.
The default integration notification can include text and content from external fields, as well as a link to
the integration process event.
You can configure your integration system to generate a unique, sequenced file name each time it runs.
Edit your integration system and use Deliver Details to select a sequence ID definition.
To create an ID definition, search for the Create ID Definition/Sequence Generator task. You can
use the pop-up help text to construct a name for your file.
The Use Time Zone selection applies to the date and time used in the Format/Syntax field and
Restart Every field.
When you launch the integration system, instead of using the Filename defined as the System Default
defined on the integration system, change the Value Type of Filename to Determine Value at Runtime.
For the Value, select Next Sequence for Integration File Utility under the Integration category.
Steps:
1. Search for ‘create sequence’ and execute the Create ID Definition / Sequence Generator task.
6. Enter WICT-UniqueFile_[Seq]-
[hh]:[mm].csv in the Format/Syntax
field.
10. Click the icon to Edit the Deliver page and select Details.
11. In the Sequence Generator for Filename prompt, select Test Unique EIB Filenames.
EMAIL AS A DESTINATION
You can export data from Workday by using email. It can deliver data to multiple email addresses,
including carbon copy (cc) and blind carbon copy (bcc) recipients, and supports custom messages for the
email body.
This transport protocol by default requires you to encrypt the outbound file using PGP. If you choose not
to encrypt the output, you can save the EIB, but you cannot run it until your Security Administrator
approves the exception. Once your Security Administrator overrides this requirement by viewing the EIB
or integration system in the Integration Exception Audit report and selects Toggle Approve Unencrypted
Transport as a related action, the EIB can be run an unlimited number of times. However, if you edit the
EIB later, your Security Administrator must re-approve the override.
PGP ENCRYPTION
For data encryption and signing, Workday supports PGP (Pretty Good Privacy), a public key encryption
standard. PGP provides an asymmetric key encryption scheme; each entity has a key pair, and each pair
consists of one public key and one private key. The public key is used to encrypt data and verify digital
signatures, and the corresponding private key is used to sign files and decrypt data. The public key is
intended to be provided to entities that will encrypt data only for you, so distributing your public key is
not a security concern. Data encrypted with your public key can be decrypted only with your private key.
Workday can encrypt outbound and decrypt inbound Cloud Connect, Studio, and EIB (Enterprise
Interface Builder) integration files using PGP; Workday can also digitally sign outbound integration files.
This ensures that only you and your trading partners can read the data that you exchange, and allows
your trading partner to confirm that an outbound integration file came from you. You store all PGP keys
in your tenant; this enables (and requires) that you maintain your own encryption keys to ensure that
you and your trading partners can secure your integration traffic.
For inbound integrations: if the file is to be opened by the Workday tenant,, we need to create
the key (store the private key) in Workday and give the public key to anyone who needs to
encrypt for Workday. Example is Benefits, 401K loan payments data that is inbound.
For outbound integrations: if Workday is sending the encrypted file, we need to get the public
key and use that to encrypt files. The destination system will then use their private key to un-
encrypt it, open and read the file. Example is Payroll sync file going to ADP.
For additional information on PGP Certificates in Workday, refer to the following Community
documentation:
https://community.workday.com/doc/int/dan1370796399717
Steps:
6. Click Done.
d. Click Done
APPENDIX
10. To find all Integration IDs associated with a business object in Workday, which report should be
run?
a. Maintain Reference IDs
b. View Reference IDs
c. Integration IDs
d. Business Object Details
A: All objects in Workday are referenced by either Ref ID or WID which are both unique. When
we send data in, the ID tells Workday for which object we are passing in the data.
A: From her profile >> Related Action of the organization >> View Integration IDs
A: No- because they may not be unique- and you will get an error. The web service operation
requires integration IDs (usually reference ID)
A: For sending data to Workday from an external system or to bulk load data into Workday
A: Public Web Services Report >> related actions >> Security >> View Web Service Operations
Security Groups. Or run View Security for Securable Item report
A: XML
Q: In addition to general integration security to build, launch and monitor, you must have access to
what?
Q: What are the two possible data sources for an outbound EIB?
A: Report or WWS
A: It ties the data for the same object across the different sheets (tabs) in the spreadsheet
A: When you have child data – multiple rows for one object
Q: After launching an integration, in the View Background Process Page, you normally see the Business
Process Loaded Tab. When might you not see this tab?
Q: True/False: You can make whatever changes you want to the spreadsheet directly regarding hiding
columns, changing labels, etc.
A: Yes
Q: What are some of the reports you can run to find more information about an integration event?
Q: What are some of the delivered Workday transformations for outbound EIBS with RaaS?
Q: You can launch the outbound EIB immediately or schedule it. What is another way to trigger your
integration?
Notes: