Table of Contents

Search

  1. Preface
  2. Workday Connector
  3. Workday connections
  4. Workday operations
  5. Mappings and mapping tasks with Workday
  6. Appendix A: Workday data type reference
  7. Appendix B: General considerations when using Workday V2 Connector
  8. Appendix C: Workday target approaches

Workday V2 Connector

Workday V2 Connector

Configuring a request using request message editor

Configuring a request using request message editor

When you create a Source transformation, configure an XML request message for the operation that you want to perform in Workday.
Use the Request Message Editor to create a request message. The request message is in XML format. You can use the default request message for the operation and then customize the request message to specify the data that you want to enter into the data flow.
To customize your request, copy the request message from the sample template to the Request Message Editor pane where you can edit the XML message and add the attributes for the request.
For example, you want to perform an operation Get_Workers using Workday Connector to retrieve data for a worker that was updated through a specified period. Specify the attributes Updated_From and Updated_Through values in the request message to fetch worker transactions that occurred between May 12, 2016 and May 13, 2016.
The following XML sample shows the request input elements that you want in the response:
<bsvc:Get_Workers_Request xmlns:bsvc="urn:com.workday/bsvc" bsvc:version="v25.0"> <bsvc:Request_Criteria> <bsvc:Transaction_Log_Criteria_Data> <bsvc:Transaction_Date_Range_Data> <bsvc:Updated_From>2016-05-12T00:00:00-07:00</bsvc:Updated_From> <bsvc:Updated_Through>2016-05-13T00:00:00-07:00</bsvc:Updated_Through> </bsvc:Transaction_Date_Range_Data> </bsvc:Transaction_Log_Criteria_Data> </bsvc:Request_Criteria> <bsvc:Response_Filter> <bsvc:Count>1</bsvc:Count> </bsvc:Response_Filter> <bsvc:Response_Group> <bsvc:Include_Personal_Information>1</bsvc:Include_Personal_Information> <bsvc:Include_Transaction_Log_Data>1</bsvc:Include_Transaction_Log_Data> </bsvc:Response_Group> </bsvc:Get_Workers_Request>
Use only the following date time format:
yyyy-mm-ddThh:mm:ss
.
The following image shows the validated request message in a Get_Workers operation in the Mapping Designer:
You can view the configured request elements for the Get_Workers operation in the Request Message editor.
For information about the type, value, cardinality, and description of each of the parameters that you can use in the request XML message for the Get_Workers operation, go to version 25 of the WSDL in the Workday Web Services (WWS) Directory, and then select the Get_Workers operation listed under the Human_Resources service. See the following link for the Get_Workers operation listed for v25.0 in the WWS directory: https://community.workday.com/custom/developer/API/Human_Resources/v25.0/Get_Workers.html
The request message format in Workday Connector follows the service request definition in Workday. You can view the Get_Workers_Request and Get_Workers_Response to understand the request and response elements that you can use.
Ensure that you use well-formed XML formatting in the request message. You can verify if the XML request is valid to ensure that the XML matches the structure expected by the operation.