This program is oriented ONLY for unattended bot runners. For attended bot runners (AARI Desktop/AARI Web) estimates are made differently With the aim of estimating the complexity of a process, this program takes as input the bot id of a bot (within public folder) and returns a dataframe with information about the bot and all its dependencies as well as each bot complexity estimation (0<complexity<1).

On top of that this program returns an overall process complexity estimation, taking into consideration the number of bots involved

This program gives a first picture of a process. However, more variables shall be considered to estimate the complexity, these are:

• Does the process use any triggers?
• Does the process use Workload Management (queues)
• What is the retry logic of the process?
• Any kind of reporting?
• In how many VMs is this process executed?
• If process is attended (AARI Desktop/Web) then another approach shall be taken

For example, inserting the bot id from this url https://aa1-app2019.iacc.epam.com/#/bots/repository/public/taskbots/3669/view we obtain:

NOTE THAT ONLY ACTIVE ACTIONS ARE COUNTED (PROGRAM DOES NOT TAKE INTO CONSIDERATION DISABLED ACTIONS)

Overall complexity 0.5935

As mentioned for executing this program you will need:

• config.py file is used for storing the sensitive variables such as username, password/apikey and control room url

• A360 Control Room user with appropriate permissions for exporting bots. At least user should have these permissions:

  • BOTS
    • View my bots
      • Export Bots
  • API
    • Generate API-Key
  • Permission to view content of public Bots folder (or specific folders within)

• A360 Control Room username and password/apiKey (it works with both, but password is not recommended)

  • Be careful: For a Control Room that is deployed on Cloud and has SAML authentication enabled, generate the web token with your username and apikey

• Access to the Control Room so that you can get the bot id from the Public folder

• You only need to point to the Master/Main bot. All dependencies are automatically detected and added

• You should have git installed on the machine so that you can clone this repository to your local device (this is a private repository, you will need a token issued by the author to clone it)
• You should have Python installed in your machine (this program has been deployed with Python 3.10.1 and tested with 3.10.5)
• You should install all the requirements that are located in requirements.txt file
• Once you cloned the repo and installed all the dependencies you must manually create a config.py file with the following variables:

# This is an example of a config.py file
# You have to write the apiKey or password (one of them) and be coherent when you call the program (add --password flag if password is used)
# Be very careful with special characters within api keys!! Use the raw string prefix in them:
username = "<YOUR_USERNAME>"
cr_url = "<CONTROL ROOM URL>"
apiKey = r"<YOUR API KEY>"
password = "<PASSWORD>"

pip install -r requirements.txt

This program is executed from the terminal:

python main.py --id=3669 --process_name="Medical Record Processing"

Output:

Overall complexity: 0.5895
Task bots file saved in output folder as: Medical Record Processing_bots.csv
Other dependencies file saved in output folder as: Medical Record Processing_other_dependencies.csv

In case you need help on how the program works you can type --help:

 python main.py --help
 
 usage: main.py [-h] --id BOT_ID --process_name PROCESS_NAME [--password]

This program will create two csv files within local output folder containing the task bot files and other dependency files. It is necessary that config.py file exists and contains the following key-value pairs: 1)cr_url 2)username     
3)apiKey OR password. Default method of authentication is via api key

options:
  -h, --help            show this help message and exit
  --id BOT_ID           Numeric bot id
  --process_name PROCESS_NAME
                        Process Name
  --password            Flag for password authentication (not recommended)

This code has been developed using Python 3.10.1. Requirements are located in the requirements.txt file

Andoni Aguirre Aranguren

LinkedIn GitHub