{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21593,"path":"integrate-applications/integration-hub/setup-webhk-wd.md","title":"Set up webhook for your Workday Financials spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Set up webhook for your Workday Financials spoke\n\nSet up a webhook to get the data from the Workday Financials application to your ServiceNow instance when an event occurs.\n\n## Before you begin\n\n- [Set up the Workday Financials spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-workday-fin-spoke.md)\n- Role required: admin\n\n## Generate user name and password in your ServiceNow instance\n\nGenerate user name and password in your ServiceNow instance to authenticate requests and retrieve the required data from the Workday application.\n\n### Before you begin\n\nRole required: admin.\n\n### Procedure\n\n1. Navigate to **All** > **System Definition** > **Table**.\n\n2. Filter and search for the Workday Financials spoke webhook registry table, for example, **Workday Financials Webhook Registry**.\n\n3. Click the **Show List** related list.\n\n4. Click **New**.\n\n5. On the form, fill these values.\n\n |Field|Description|\n |-----|-----------|\n |Description|Description of the webhook registry record. Enter `Workday event and authentication for Create PO`.|\n |UserName|Workday user who has integration rights using Workday Web Services.|\n |Password|Password of the Workday user.|\n |Workday Event|Event for which the webhook is set up. Enter `CreatePO`.|\n |Workday Instance|Base URL of the Workday instance or tenant name.|\n\n6. Right-click the form header and click **Save**.\n\n7. Click **Generate UserName And Password**.\n\n Copy and record the values of user name and password. These values must be specified in the Workday instance to authenticate the webhook requests.\n\n\n## Retrieve the resource path from your ServiceNow instance\n\nRetrieve the resource path from your ServiceNow instance for later use to authenticate requests and retrieve the required data from the Workday application\n\n### Before you begin\n\nRole required: admin.\n\n### Procedure\n\n1. Navigate to **All** > **System Web Services** > **Scripted Web Services** > **Scripted REST APIs**.\n\n2. Open the record for the Workday Financials spoke.\n\n3. In the **Resources** tab, click the **Callback** record.\n\n4. Record and save the value of **Resource path** for later use.\n\n\n## Import CLAR file to your Workday instance\n\nImport CLAR file available at ServiceNow Store to set up webhooks and authenticate requests from ServiceNow instance.\n\n### Before you begin\n\n- Workday Studio should be installed.\n- Access to custom report creation policy.\n - Create custom report in Workday based on the Purchase\\_order\\_report structure and share the report with ISU user.\n - Ensure that you select all companies in company prompt in report.\n\n \\[Omitted image \"prompt-instructions-wd-fin.png\"\\] Alt text: Prompt instructions\n\n- Access to edit business process definition.\n- Access to create and edit integration system.\n- Role required: admin\n\n**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.\n\n### Procedure\n\n1. From the [Workday Financials spoke](https://store.servicenow.com/sn_appstore_store.do#!/store/application/dddbe37edbe5c810ea4494d9db96195f) page on [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home), download the `Workday-Finance-Webhook-Studio-Sample` file from **Supporting Links and Docs**.\n\n2. Unzip the sample file to obtain the CLAR file.\n\n3. Import the CLAR file to Workday Studio.\n\n4. In the **Properties** tab of the **StartHere** component, navigate to **Services** and select the RAAS report created for this webhook.\n\n \\[Omitted image \"conf-starthere-wd-fin.png\"\\] Alt text: Configure the StartHere properties\n\n5. Choose the environment where your report exists such as, implementation or sandbox, and configure the report as per your requirement.\n\n6. Provide a report name and select the required report.\n\n \\[Omitted image \"provide-purchase-order-wd-fin.png\"\\] Alt text: Provide purchase order name\n\n7. Provide the alias name of the report.\n\n \\[Omitted image \"alias-box-wd-fin.png\"\\] Alt text: Alias\n\n8. 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.\n\n \\[Omitted image \"extra-path-wd-fin.png\"\\] Alt text: Extra Path\n\n9. In the **Set Headers** component, provide your Workday instance for the **WorkdayInstance** header.\n\n \\[Omitted image \"set-headers-wd-fin.png\"\\] Alt text: Set headers\n\n10. In the properties of **HttpOut**, fill in these values.\n\n\n
\n\nField\n\n\n\nValue\n\n
\n\nEndpoint\n\n\n\nREST endpoint**Note:** See [Retrieve the resource path from your ServiceNow instance](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-webhk-wd.md) for more information.\n\n
\n\nHttp Method\n\n\n\nPOST\n\n
\\[Omitted image \"httpout-properties-wd.png\"\\] Alt text: Configure the HttpOut properties\n\n11. Save the changes.\n\n12. In the project explorer, select the integration and deploy it in your Workday system.\n\n13. Log in to your Workday instance and navigate to **Integration** > **Integration System** > **Configure Integration Attributes**.\n\n \\[Omitted image \"conf-int-attributes-wd-fin.png\"\\] Alt text: Configure integration attributes\n\n14. Provide user name and password in **Configure Integration Attributes** that you have generated in [Generate user name and password in your ServiceNow instance](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-webhk-wd.md).\n\n \\[Omitted image \"username-password-wd.png\"\\] Alt text: Configure username and password\n\n15. Modify a business process and add this integration in your business process.\n\n 1. Edit definition of the business process.\n\n 2. Search for Purchase Order business process in Workday.\n\n 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\n\n \\[Omitted image \"edit-definition-fin.png\"\\] Alt text: Edit definition\n\n 3. Select the effective date and click **Ok**.\n\n 4. Click the + sign and add a new business process step in BP.\n\n 5. Select an order, which is after the completion step of business process.\n\n 6. Select **Type** as **Integration**.\n\n \\[Omitted image \"integration-type-fin.png\"\\] Alt text: Select integration type\n\n 7. Provide ISU username in **Run as User** and click **Ok**.\n\n 8. Click **Configure Integration** on the newly added business process step in hire BP.\n\n \\[Omitted image \"conf-int-button-fin.png\"\\] Alt text: Configure integration button\n\n 9. On the Configuration Integration Step page, click **Ok**.\n\n 10. In integration criteria, select value type as **Determine value at runtime** and select value as **PO Number**.\n\n \\[Omitted image \"determine-value-runtime-wd-fin.png\"\\] Alt text: Determine value at runtime\n\n Selected **PO Number** should be as shown below.\n\n \\[Omitted image \"emp-id-fin.png\"\\] Alt text: Employee ID field\n\n 11. Click **Ok**.\n\n 12. Create a report for the webhook with these details:\n\n Purchase Order report definition:\n\n \\[Omitted image \"po-report-wd-fin.png\"\\] Alt text: Purchase Order report definition\n\n Column labels:\n\n \\[Omitted image \"col-names-wd-fin.png\"\\] Alt text: Column labels\n\n Filter:\n\n \\[Omitted image \"filter-wd-fin.png\"\\] Alt text: Filter\n\n Prompt default:\n\n \\[Omitted image \"prompt-defaults-wd-fin.png\"\\] Alt text: Prompt defaults\n\n\n"}}