Set up webhook for your Workday Financials spoke

Set up a webhook to get the data from the Workday Financials application to your ServiceNow instance when an event occurs.

Before you begin

• Set up the Workday Financials spoke
• Role required: admin

Generate user name and password in your ServiceNow instance

Generate user name and password in your ServiceNow instance to authenticate requests and retrieve the required data from the Workday application.

Before you begin

Role required: admin.

Procedure

1. Navigate to All > System Definition > Table.
2. Filter and search for the Workday Financials spoke webhook registry table, for example, Workday Financials Webhook Registry.
3. Click the Show List related list.
4. Click New.
5. On the form, fill these values.

   Field	Description
   Description	Description of the webhook registry record. Enter Workday event and authentication for Create PO.
   UserName	Workday user who has integration rights using Workday Web Services.
   Password	Password of the Workday user.
   Workday Event	Event for which the webhook is set up. Enter CreatePO.
   Workday Instance	Base URL of the Workday instance or tenant name.

6. Right-click the form header and click Save.
7. Click Generate UserName And Password.
   Copy and record the values of user name and password. These values must be specified in the Workday instance to authenticate the webhook requests.

Retrieve the resource path from your ServiceNow instance

Retrieve the resource path from your ServiceNow instance for later use to authenticate requests and retrieve the required data from the Workday application

Before you begin

Role required: admin.

Procedure

1. Navigate to All > System Web Services > Scripted Web Services > Scripted REST APIs.
2. Open the record for the Workday Financials spoke.
3. In the Resources tab, click the Callback record.
4. Record and save the value of Resource path for later use.

Import CLAR file to your Workday instance

Import CLAR file available at ServiceNow Store to set up webhooks and authenticate requests from ServiceNow instance.

Before you begin

• Workday Studio should be installed.
• Access to custom report creation policy.
  • Create custom report in Workday based on the Purchase_order_report structure and share the report with ISU user.
  • Ensure that you select all companies in company prompt in report.

    

• Access to edit business process definition.
• Access to create and edit integration system.
• Role required: admin

Note:

Except integration name, report field XPath (if required), and Workday instance header, users are cautioned against modifying the values of fields or properties in the CLAR file.

Procedure

1. From the Workday Financials spoke page on ServiceNow Store, download the Workday-Finance-Webhook-Studio-Sample file from Supporting Links and Docs.
2. Unzip the sample file to obtain the CLAR file.
3. Import the CLAR file to Workday Studio.
4. In the Properties tab of the StartHere component, navigate to Services and select the RAAS report created for this webhook.

   

5. Choose the environment where your report exists such as, implementation or sandbox, and configure the report as per your requirement.
6. Provide a report name and select the required report.

   

7. Provide the alias name of the report.

   

8. After the report alias is added, add the selected path of report in Extra Path that is used to run the report based on prompt.

   

9. In the Set Headers component, provide your Workday instance for the WorkdayInstance header.
   
10. In the properties of HttpOut, fill in these values.

    Field	Value
    Endpoint	REST endpoint Note: See Retrieve the resource path from your ServiceNow instance for more information.
    Http Method	POST

    

11. Save the changes.
12. In the project explorer, select the integration and deploy it in your Workday system.
13. Log in to your Workday instance and navigate to Integration > Integration System > Configure Integration Attributes.

    

14. Provide user name and password in Configure Integration Attributes that you have generated in Generate user name and password in your ServiceNow instance.

    

15. Modify a business process and add this integration in your business process.
    1. Edit definition of the business process.
    2. Search for Purchase Order business process in Workday.
       If within one customer environment there are more than one purchase order business processes, all the business processes should be configured to enable this webhook for all purchase orders.

       

    3. Select the effective date and click Ok.
    4. Click the + sign and add a new business process step in BP.
    5. Select an order, which is after the completion step of business process.
    6. Select Type as Integration.

       

    7. Provide ISU username in Run as User and click Ok.
    8. Click Configure Integration on the newly added business process step in hire BP.

       

    9. On the Configuration Integration Step page, click Ok.
    10. In integration criteria, select value type as Determine value at runtime and select value as PO Number.

        

        Selected PO Number should be as shown below.

        

    11. Click Ok.
    12. Create a report for the webhook with these details:

        Purchase Order report definition:

        

        Column labels:

        

        Filter:

        

        Prompt default: