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.2 or later and Automation Anywhere A2019 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.
Click on the menu and navigate to the Appian Designer page.
Click Import on the Appian Designer screen.
Upload the Robotic Workforce Manage<\version>.zip file to the Package (ZIP) section. Make changes to the Robotic Workforce Manager.properties 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
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]
...
## Constant: RWM_AA_IS_APIKEY_AUTHENTICATION
## Type: Boolean
## Set the Automation Anywhere authentication type. If true, integration will be set to authenticate with an AA API key. Otherwise, it will use Basic Authentication.
## Boolean values must be specified as either the text TRUE or FALSE.
content._a-0000e537-7388-8000-9bc5-011c48011c48_1218413.VALUE=FALSE
Click the Include related import customization file checkbox and upload it to the Import Customization File (PROPERTIES) section.
Click Inspect. It will take some time to inspect before displaying that there are no warnings or conflicts. If any are encountered, contact Appian support.
To establish authentication, you'll need to set up a role and user to create an API key in Automation Anywhere.
In the left side menu, click Administration > Roles > Create new role.
Check Generate API-Key and finish creating the new role.
In the left side menu, click Administration > Users > Create new user.
In the list of Available roles, select the AAE_Admin and use the Service API Role.
In order to use the encryption function plugin, we need to create third party credentials. Setting up third party credentials is mandatory because the encryption function will be used to encrypt the admin user's credentials of Automation Anywhere. Below are the steps to create third party credentials.
Go to Admin Console.
Click on the Third-Party Credentials option on the left side.
Click on the Create button. An interface will open up to set up third party credentials.
Input encryptdecryptkey in the Name text box, and select Encryption Function in the plugin 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 completes the set up of third party credentials for the encryption function plugin.
To configure the vendor details, you need to be a member of the RWM_Admin group.
Go to Tempo from Navigation Tab and click on the action Configure Environment and Instance Details action. Use this interface to submit updates or new environments.
https://automation-anywhere.solutions-dev.appianci.net/
The Instance Tab can be used to update existing instances or add new instances.
RWM_AA_IS_APIKEY_AUTHENTICATION
constant set to True
, the environment uses API keys for authentication. Enter the API key here instead of a password.Note: Disabled fields are not required.
Bot Runners are responsible for running or executing bots. Configure the Bot Runner user details in the RWM database to start and schedule processes.
To get the Bot Runners from the RWM integration object, open the RWM_AA_getBotRunnerDetails object from Appian Designer.
RWM_UI_tenantDetails
.tenantId
as the input parameter for the object named RWM_AA_getBotRunnerDetails
.In the RWM_AA_BOT_RUNNER_LIST table in the RWM database, use the below sample script to insert BotRunner user details.
1
INSERT INTO `RWM_AA_BOT_RUNNER_LIST` ( `USER_ID`, `USER_NAME`, `EMAIL`, `DISABLED`, `DELETED`) VALUES ('userId', username, 'email', disabled, deleted);
The data from Automation Anywhere to Appian is loaded on a daily basis by running the ETL process called RWM AA ETL Wrapper Model at the Appian side. The same ETL process will be 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.
The following Constant values must be configured in Appian in order to load historical data
Click on the menu and navigate to the Appian Designer page. This will list all the available applications.
Click on the Robotics Workforce Manager Application. This will list all the objects related to the RWM application
Select the constants checkbox on the left side and type in the Constant name in the provided search text box.
Select True/false in the Value radio box for RWM_AA_HISTORIC_LOAD_FLAG constant and click on save.
The batch size can be updated in the Value text box for RWM_AA_HISTORIC_START_DATE. Then click on Save.
Set the Automation Anywhere data retrieval batch size in the value field of RWM_AA_MAX_BATCH_SIZE and click on Save. Note that the values above the default 100 are not recommended.
Once the above variables are configured, the Same ETL process RWM AA ETL Wrapper Model in Appian needs to be started manually.
RWM AA ETL Wrapper Model process is scheduled to run on the set scheduled time interval at the Appian side to collect Automation Anywhere statistics and load it to Appian via web services provided by Automation Anywhere.
The timing of this run is configurable. Users can configure the timing by updating the constant variable RWM_AA_ETL_TIMER_INTERVAL (follow the same steps to update the constant object) in the RWM Appian application.
NOTE:
Click on the menu and navigate to the Appian Designer page. This will list all the available applications.
Click on the Robotics Workforce Manager Application. This will list all the objects related to the RWM application.
Select Process Models in the left side filter and type in the ETL process model name RWM AA ETL Wrapper Model in the search bar and click search. The process model object will be visible on the right side.
Click on File and select Start Process for Debugging to start the ETL process.
Once the process is completed successfully, the terminate node will turn blue, shown below.
Data regarding Process, Queue, Work Items, Resource information, and other metrics are pulled from Automation Anywhere into Appian on a set scheduled time interval. A scheduler invokes Appian to execute a process that runs several APIs in Automation Anywhere. The response is then moved to the Appian database.
Once users start or schedule a process, the process name and its input parameters are sent to Automation Anywhere via the Automation Anywhere HTTP connected system. The Automation Anywhere APIs return the unique session id for the started/scheduled process, which is saved in the RWM database.
Currently, the exception management reference app has been developed in Appian and Automation Anywhere, where Appian is used as a tool to manage the exceptions raised from Automation Anywhere. This module automatically pulls exception work items from the constantly running background ETL process, where these exceptions will be assigned to a specific user/group based on the routing logic (configurable) in Appian. If a match in the routing module is not found, the exceptions are sent to the Exception Manager for assignment.
Setup with Automation Anywhere