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.
Go to the Appian Designer.
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
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.
Click IMPORT. Due to the size of this application, it may take a while to import, at which point the screen may time out. This is expected, and the import is still occurring in the background.
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 the Appian Admin Console.
Click on the Third-Party Credentials option on the left side.
Click Create. 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 the navigation menu and click the 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
in Appian. 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:
RWM_AA_HISTORIC_LOAD_FLAG
- TrueRWM_AA_HISTORIC_START_DATE
- From when should the data be fetched from Automation AnywhereRWM_AA_HISTORIC_END_DATE
- Till when should the data be fetched from Automation AnywhereRWM_AA_ETL_BATCH_SIZE
- Initial value is 100, i.e 100 rows of data from Automation Anywhere will be transferred to Appian at a time. This number could be updated but the recommended value is 100.Go to the Appian Designer to see all the available applications.
Click the Robotic 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 or False in the Value radio box for RWM_AA_HISTORIC_LOAD_FLAG
constant and click Save.
The batch size can be updated in the Value text box for RWM_AA_HISTORIC_START_DATE
. Click Save.
Set the Automation Anywhere data retrieval batch size in the value field of RWM_AA_MAX_BATCH_SIZE
and click 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.
RWM_AA_HISTORIC_LOAD_FLAG
is set to False for the daily load.RWM_AA_FLAG_PROCESS
is set to True for daily load to run.Go to the Appian Designer to view all the available applications.
Click Robotic Workforce Manager. 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