Robolytix is the key online analytic and monitoring tool for Robotic Process Automation using Sonar technology to evaluate, audit, monitor and improve performance of robots operating on any application or RPA platform. This tutorial will guide you to analyze your processes in AutoMate BPA by HelpSystems.
AutoMate BPA is an RPA tool created by HelpSystems focused on automation with use of scripting language. All steps are stored in code and can be edited directly.
To use Robolytix with AutoMate BPA, it is necessary to have a Robolytix account.
If you do not have one, you can create the account at Robolytix.com and make basic settings using the onboarding wizard.
We have provided two example tasks. Main task is called Robolytix Demo and demonstrates how to use Robolytix in your production tasks. Second is a subtask called Robolytix Sonar and serves as client for calling Robolytix API. You can download both tasks Robolytix Demo, Robolytix Sonar and import them into AutoMate BPA. Easiest way to import task is to open AutoMate BPA Server Management Console and Drag and drop both tasks on Repository tab. Using these two tasks will show you implementation of Robolytix without copying any code.
Robolytix Sonar is used for sending data and in other processes it is called as subtask. It is your actual client for Robolytix.
Robolytix Demo is an example process, that use Robolytix. Instead of showing MessageBox there belongs the actual work of the task (thus serving only as a placeholder).
It is a good practice to set all needed values to variables at the beginning of the process and then using inly these variables. There should be no important constants in individual steps in the middle of script.
List of variables used for monitoring in Robolytix:
You must set you own API key into AutoMate task, so Robolytix can pair your process in RPA tool with your account. Using API keys is described in Get Robolytix API key.
When you have your API key, you have to set variable VAR_ROBOLYTIX_APIKEY. There are two possibilities, where to set its value:
1/ Set API Key in Robolytix Sonar subtasks
When you want to set API Key only once for all tasks, open and edit Robolytix Demo subtask and replace text API_KEY with your value. You can modify "Robolytix Demo.aml" file in any editor before importing it into AutoMate. This is preferred way, when you want to provide prepared subtask for other developers in your company.
2/ Set API Key at the beginning of the task during initialization
At the beginning of your task set variable VAR_ROBOLYTIX_APIKEY to your value. All subtasks will use this value. This is preferred way, when you want to clearly see all variables at one place.
Implementation of Robolytix is split into two steps.
Initialization of variables at the beginning of the task. You have to define mentioned variables and set values at least for
VAR_ROBOLYTIX_RUN variables. Variable
VAR_ROBOLYTIX_APIKEY should be set according to previous section.
Example code is as follows:
<AMVARIABLE NAME="VAR_ROBOLYTIX_APIKEY" VALUE="AA37DC03-D8EA-4A58-8367-6B03792A9F40" /> <AMVARIABLE NAME="VAR_ROBOLYTIX_PROCESS" VALUE="D43ADC0E-D8EA-5488-AA67-KDRT79E458ER" /> <AMVARIABLE NAME="VAR_ROBOLYTIX_SONAR" VALUE="start process" /> <AMVARIABLE NAME="VAR_ROBOLYTIX_TYPE" VALUE="start" /> <AMVARIABLE NAME="VAR_ROBOLYTIX_RUN" VALUE="%CreateGUID()%" />
This step is repeated in whole process. You set new values for Sonar. It is preferred to set new values for
VAR_ROBOLYTIX_TYPE variables. Values of
VAR_ROBOLYTIX_SONAR should clearly and unique describe specific state / point in whole task. Values
VAR_ROBOLYTIX_TYPE depends on position in task. For first sonar in task use value start, for last sonar is used value end. For error state use value error and for all other calls use common value. Then a subtask is called (Robolytix is informed about the process flow).
Full code for setting Sonar name, type and executing subtask looks like:
You can copy this code into your process:
<AMVARIABLE ACTIVITY="set" VARIABLENAME="VAR_ROBOLYTIX_TYPE" VALUE="common" /> <AMVARIABLE ACTIVITY="set" VARIABLENAME="VAR_ROBOLYTIX_SONAR" VALUE="processing data" /> <AMTASK TASKFILE=".\Robolytix Sonar.aml" />
After proper process execution go to Robolytix platform and check process statistics. It is possible to show all recent messages sent to specified process. Go to Settings -> Processes menu and select list of process messages.
When you have any problems with implementation look at the Robolytix Demo task. There is also Robolytix Support Forum for following questions.