Example: Automating service requests for payslips by using UiPath RPA

Use the BMC Sample Request Payslip with UiPath 21.3.01 sample service in the BMC Helix Digital Workplace Catalog application to automate service requests for payslips.

Scenario

Ajay, an application business analyst wants to create a service to automate user requests for payslips. He uses the content package to create the service.

Ajay creates a UiPath connector configuration. He creates a UiPath (RPA) process by using a sample script. Ajay configures the process to fetch a payslip from a payroll system and to send the payslip to the user through an email. He updates the BMC Sample Request Payslip with UiPath 21.3.01 service in the BMC Helix Digital Workplace Catalog application. He then publishes the service and makes it available for users.

The following image describes the actions to create a service to automate user requests for payslips:

The following video (2:46) explains how to automate a payslip service request using UiPath:

https://youtu.be/gvq9jUnXYs4

Before you begin

Make sure that you have completed the following actions:

Downloaded the following files:
- BMC Sample Request PaySlip Process.zip
- BMC Sample Request Payslip Definitions
- Sample Payslip.zip

Imported the BMC Sample Request PaySlip Process.zip file to UiPath.
Imported the BMC Sample Request Payslip Definitions file to your BMC Helix Digital Workplace Catalog application in BMC Helix Innovation Studio.
The BMC Sample Request Payslip Definitions file contains the rule definition that is used by the BMC Sample Request Payslip with UiPath 21.3.01 service workflow.
Configured a webhook callback URL with the UiPathConfig name.
Learn about configuring a webhook callback at Adding a UiPath connector configuration.

Task 1: To create a UiPath connector configuration

Log in to BMC Helix Innovation Studio.
Navigate to the Administration tab.
Select Connectors > UiPath, and click Add new setting.

Enter the values for the following fields:

Field	Description
Connection ID	ID for the connection. You can specify an alpha numeric ID such as UiPath-12.
Client Key	Key to log in to your UiPath account
Name	Name for the connection
Account Logical Name	Unique URL that is derived from the company name that you specify during signup or from your first name and last name
Client ID	Value of the Application ID obtained after creating an Orchestrator application in UiPath
URL	UiPath server endpoint URL
Trust All Certificates	If you want to trust your certificates, specify the value as True, else do not specify any value.
Organization UnitId	ID of the modern folder where your UiPath processes are located
Tenant Logical Name	Tenant associated to your UiPath account
Callback URL	URL that was populated automatically when you configured the webhook callback
Callback Auth Key or User Name	Authorization GUID or string that you added while configuring the webhook callback URL for UiPath connector, such as UiP-12345
Callback Password	Password for the account you are using

Learn about User Key, Account Logical Name, and Tenant Logical Name at Consuming Cloud API Open link .

Click Save.

Task 2: To define the UiPath process

Log in to UiPath.
In UiPath, create RequestPaySlip process by using the BMC Sample Request PaySlip Process.zip sample process.
In the process, update the values for the arguments.
Important

Make sure that the arguments in the process and the input variables in the service workflow are the same.
The following image shows an example of arguments:
Update the values for the process variables such as host.
The following image shows an example of variables:
In the jsonObject variable, specify the following value:
Important

Make sure that in the UiPath studio you import the UiPath web API activities package.
In the filePath variable, configure the path for sample payslips.
Specify the path where you downloaded the Sample Payslip.zip file.
To receive a callback from the process, configure the HTTP header.
The following image shows an example of the HTTP header:
Configure the REST service as shown in the following image:

Make sure that you specify the following parameter values:
Parameter Value
Input section
AcceptFormat JSON
Method POST
Options section
Body Convert the JSON body in string format.
Make sure that you use the following JSON object structure:
```
JObject.FromObject(
New With {
key.processCorrelationId=processCorrelationId,
key.resourceType="com.bmc.arsys.rx.application.process.command.SignalProcessInstanceCommand",
key.signalInputValues=New With {
key.Result="Success",
key.ProcessResult="Process Successfully Completed"
}
})
```

Task 3: To define Request Payslip service

Log in to BMC Helix Digital Workplace Advanced.
On the Services tab, click Services.
The service BMC Sample Request Payslip with UiPath 21.3.01 is displayed in the Service Management console.
Select the service, click Actions, and click Edit Service Name.
Update the service name, and click Save.
For example, Request Payslip.

Task 4: To define the Request Payslip service workflow

In the BMC Helix Digital Workplace Advanced application, in the Service Management console, select the Request Payslip service.
Click Actions, and click Open.
In the Service Options pane, click Edit corresponding to the Workflow option.

In the Workflow and Questions pane, in the Workflow section, click Edit.

The following workflow is displayed in the Workflow designer:

The following elements are used in the workflow:

Element	Label	Description
Create Document	Process Inputs	Accesses the attributes within the schema of the UiPathParams document definition. Specify the document node values that are used as input to run the RPA process.
Run UiPath Process	Run UiPath Process	Triggers a UiPath process. Specify the process name and jobs count in the element properties.
Receive Task	Receive Process Status	Adds wait steps in the workflow and waits for process completion.
Timer	NA	Interrupts a wait step after time out.
Send In App Notification	Send notification on process failure	Sends the process status to the administrator through a notification.
Send In App Notification	Send notification on successful process execution	Sends the process status to the service requester through a notification.

If required, update the workflow input variables.
The following input variables are available:
Map the payslipMonth and year input variables to the service questionnaire so that user responses to service question are used as variable values.
Select the Create Document element with the Process Inputs label, and make sure that you specify the keys in the document nodes in the same manner as you specify in the process script input variables.

Select the Run UiPath Process element and update the following properties:

Property	Description
Connection ID	Connection ID of your UiPath connector that you configured in Task 1.
File ID or name	Name of the process, RequestPaySlip.
Jobs Count	Number of times you want to run a job that is to run the UiPath process.

Save the changes.

Task 5: To define the Request Payslip service questionnaire

In the BMC Helix Digital Workplace Advanced Service Management console, select the service.
Click Actions and click Open.
In the Service Options pane, click Edit corresponding to the Workflow option.
In the Workflow and Questions pane, in the Questions section, click Edit.

The Questions designer displays the questions that the user must answer to retrieve the payslip for a specific period (month and year) as shown in the following images:
In the Questions designer, add questions corresponding to any additional input variables that you have added in the workflow to receive inputs from the service requester.
Save the changes.

Task 6: To define the Request Payslip rule

Log in to BMC Helix Innovation Studio.
Navigate to the Workspace tab, and select the BMC Helix Digital Workplace Catalog application.
In the application, select Rules, and click the UiPathCallbackRule rule.
The following image shows an example rule:
In the rule, update the Qualification and Signal Process element properties.

Task 7: To publish the Request Payslip service

In the BMC Helix Digital Workplace Advanced application, in the Service Management console, select the Request Payslip service.
In the Service Options pane, click , and click Publish.

After you publish the service, the service is available to users.

Task 8: To test the Request Payslip service

Log in to BMC Helix Digital Workplace Advanced application.
Submit a payslip request by using the Request Payslip service.
Verify that you receive an email with the payslip attached.

Result

The Request Payslip service is available to the users. Users can submit payslip requests by using this service and their requests are processed automatically.