The RWM application was deprecated with Appian 24.1. The application will no longer be updated or pre-installed for new Appian Cloud sites with Appian RPA enabled. RWM will be removed in a future release and we encourage customers to use the Operations Console to manage robots instead. |
The setup instructions on this page require Appian 20.1 or later and UiPath v19.4.0 or above.
Note: To successfully import an application package, the service account user which deploys the application package must be in the GMT time zone and must not be changed.
Navigate to the Appian Designer.
Click Import.
Robotic Workforce Manager.properties
for UiPath connected system. The connected system object name is RWM_UiPathCSP
.apiKeyValue="Bearer <apiKeyValue>"
Upload the Robotic Workforce Manager<version>.zip
file to the Package (ZIP) section. Make changes to the Robotic Workforce Manager.properties
file as mentioned below.
Robotic Workforce Manager.properties
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
Provide the database vendor, ex: MYSQL or MSSQL
## Constant: RWM_DB_VENDOR
## Type: Text
##
## Text values will be displayed in Appian exactly as they are
## specified here. No spaces are trimmed. Values do not need to be
## encased in quotation marks.
content._a-0000e49f-ec1b-8000-9bc3-011c48011c48_1126829.VALUE=@@DATABASE_VENDOR@@
Provide the Appian environment URL ex:https://xyz.appiancloud.com
## Constant: RWM_VAL_APPIAN_DOMAIN_NAME
## Type: Text
##
## Text values will be displayed in Appian exactly as they are
## specified here. No spaces are trimmed. Values do not need to be
## encased in quotation marks.
content._a-0000e23d-7780-8000-9ba2-011c48011c48_64089.VALUE= [http(s)]://[Appian URL]
Appian business database name ex:jdbc/Appian
## Constant: RWM_VAL_COMMON_DATA_STORE_APPIAN
## Type: Text
##
## Text values will be displayed in Appian exactly as they are
## specified here. No spaces are trimmed. Values do not need to be
## encased in quotation marks.
content._a-0000e23d-7780-8000-9ba2-011c48011c48_69762.VALUE=jdbc/[Database Name]
The following are details specific to the UiPath connected system. No modifications are needed; these details are configured directly from the database.
## Connected System: RWM_UIPath_CSP
connectedSystem._a-0000e2f2-a540-8000-e99f-01ef9001ef90_314069.host=http(s)://<UIPath_Orchestrator_URL>
connectedSystem._a-0000e2f2-a540-8000-e99f-01ef9001ef90_314069.port=<Port_Number to access UIPath Orchestrator>
connectedSystem._a-0000e2f2-a540-8000-e99f-01ef9001ef90_314069.tenant=<Host_Name to access UIPath Orchestrator>
connectedSystem._a-0000e2f2-a540-8000-e99f-01ef9001ef90_314069.userName=<Username to access UIPath Orchestrator>
connectedSystem._a-0000e2f2-a540-8000-e99f-01ef9001ef90_314069.password=<password>
The following are specific to the Appian RPA HTTP connected system. For API Key Value, use the format "Bearer <apiKeyValue>". The API Key must be related to a service account in Admin Console. The service account should have System Administrator access.
## Connected System: RWM_AppianRPA
connectedSystem._a-0000e3be-674f-8000-9ba5-011c48011c48_30431.baseUrl=[http(s)]://[Appian URL]/rpa/
connectedSystem._a-0000e3be-674f-8000-9ba5-011c48011c48_30431.apiKeyValue=Bearer <apiKeyValue>
Check Include related import customization file and upload Robotic Workforce Manager.properties
to the Import Customization File (PROPERTIES) section.
Click INSPECT. If the inspection returns no warnings or conflicts, then you are ready to move on to the next step of importing. If you're shown unexpected warnings or conflicts, please contact the support team.
An admin account on each tenant in UiPath has to be created with the GMT time zone. The ETL process will load all data for each tenant using the corresponding admin account.
Click on the top right corner and click Users.
The Orchestrator lists all the available users. Click on the (+) icon to add a new user.
Enter all the user details. Select Administrator role and repeat the same steps for each tenant.
To use the encryption function plugin, you'll need to create third-party credentials. Setting up third-party credentials is required because the encryption function is used to encrypt the admin user's credentials of UiPath.
To create third party credentials:
Go to Admin Console in Appian.
Click Third-party Credentials on the left side.
Click Create. An interface will open up to set up third party credentials.
Type encryptdecryptkey
in the Name text box and select Encryption Function in the plug-in picker field.
In the Credentials section, click Add field to add credentials. In Field name enter the text key and in Value enter an encryption key. You will need to generate your own AES-256 encryption key to enter here. Enable the Mask checkbox and click Save.
This concludes setting up third party credentials for the encryption function plugin.
To configure the vendor details, you need to be a member of the RWM_Admin group.
Click Add New Environment and enter the details.
https://rwm1-ahupy5zg4n5c2.azurewebsites.net
To add the instance details:
On this tab, click Add New Instance to add all the instance details in accordance with vendor details. Disabled fields are not required.
Environment Name: to get the environment name:
Log in to the UiPath Orchestrator using a tenant username and password.
Click Robots in the left side menu bar and click Environments on the top bar.
Environment Id: Automatically updated using the credentials and environment name.
Caution: Do not click Set as default test values! The basic authentication credentials here are not saved in the application. However, clicking Set as default test values may leave the values visible to other designers and admins, exposing the credentials and compromising security.
Data is loaded from UiPath to Appian on a daily basis by running the ETL process called RWM UI ETL Wrapper Model
on the Appian side. The same ETL process is used for loading historical data as well.
Before running the ETL process, make sure all the tenant details are present in the RWM_UI_TENANT_DETAILS
table. Steps to populate tenant details data are mentioned in the Set-Up and Configuration document.
To load the historic data, these Appian constants should be configured:
RWM_UI_HISTORIC_LOAD_FLAG
- Set to True.RWM_UI_HISTORIC_START_DATE
- Start date the data should be fetched from UiPath.RWM_UI_HISTORIC_END_DATE
- End date the data should be fetched from UiPath.RWM_UI_ETL_BATCH_SIZE
- Initial value is 100, i.e 100 rows of data from UiPath will be transferred to Appian at a time. This number could be modified but the recommended value to have is 100.Navigate to the Appian Designer page to see all available applications.
Open the Robotic Workforce Manager application to see all objects related to RWM application.
Select the Constants checkbox on the left side to filter the list. You can also type in the constant name in the search text box.
Click on the constant object you want to edit from the filtered objects.
Select True or False in the Value radio box for RWM_UI_HISTORIC_LOAD_FLAG
constant and click Save.
Select the appropriate date in the Value text box for RWM_UI_HISTORIC_START_DATE
and click Save.
Type in appropriate integer value in a value text box for RWM_UI_ETL_BATCH_SIZE
and click Save.
Once the above variables are configured, the same ETL process RWM UI ETL Wrapper Model
on the Appian side needs to be started manually.
RWM UI ETL Wrapper Model
process is scheduled to run every day (configured for 1 A.M. GMT nightly) on the Appian side to collect UiPath statistics and load it to Appian via web services provided by UiPath.
The timing of this run is configurable. Users can configure the timing by updating the constant variable RWM_UI_ETL_TIMER
in Appian.
NOTE:
RWM_UI_HISTORIC_LOAD_FLAG
is set to False for the daily load.RWM_UI_FLAG_PROCESS
is set to True for daily load to run.Navigate to the Appian Designer page to see all the available applications.
Click the Robotic Workforce Manager application to see all objects related to the RWM application.
To find the ETL process model, select Process Model on the left side to filter the list of objects and search for RWM UI ETL Wrapper Model
. The process model object appears in the list.
Open the process model and select the Designer View. Click File and select the Start Process for Debugging to start the ETL process.
Once the process is completed successfully, it should appear as follows:
If the ETL process encounters problems, the terminate node won't change to blue even after waiting for a longer period. Contact the support team if this occurs. The maximum time ETL process can take to complete is 15 minutes. If the terminated node doesn't turn blue even after 15 minutes, contact the support team in that case. Below is a sample snapshot of the failed ETL process.
Data regarding processes, queues, work items, resources, and other components are transported from UiPath to Appian on a scheduled interval. A scheduler invokes Appian to execute a process, which runs several APIs in UiPath and the response is moved to the Appian database.
Once a user starts or schedules a process, the process name and its input parameters are sent to UiPath via the UiPath connected system. The UiPath connected system returns the unique session id for the started or scheduled process and it's saved in the RWM database.
Currently, the near real-time extraction of the process (Start/Schedule execution), Resource Status from UiPath. For this, there is a process in Appian that will run after the ETL process to update the status. This response will be updated in Appian.
Currently, the exception management reference app has been developed in Appian and UiPath, where Appian is used as a tool to manage the exceptions raised from UiPath. RWM automatically pulls exception work items by ETL process and these exceptions are assigned to a specific user or group based on the routing logic (configurable) in Appian. If a match in the decision table is not found, the exceptions are sent to the Exception Manager for assignment.
Setup with UiPath