1. Help Center
  2. Getting started

Sessions Controller for building scripts

Automai's Sessions Controller serves 2 functions:

1. Script Creation:

Allows you to RDP to one of the robot machines and create a script.  This ensures that the scripting and playback are in similar desktop environments, eliminating issues with font smoothing, color variations, etc.

(Scenarios should be built in the environment where the robots are so that images are rendered the same) .

For this purpose you must download and install Sessions Controller on your PC where you are connecting from.

 

2. Script Execution:

Ensures your robots always have a desktop available to execute the processes.  This is preinstalled with every robot (Version 8.4 and up).  For this function, Sessions Controller starts automatically and runs in the background.

Make sure configurations of Sessions Controller match those where the script is executed:

 

For AppLoader:  Injectors must have the same configuration as Sessions Controller

To do this, go to Injectors tab, Edit the Injector, go to RDP parameter section.  Make variables match with Sessions Controller (or vice versa)

 

For rTester, rWorker, and ScenarioStation: . Make sure they match those with Sessions Controller.

Follow these steps to use Sessions Controller for Scripting: 

1. Open Sessions Controller. 

2. Click "Add ScenarioBuilder Session".

3. Fill out parameters to match those of the robot's environment  (to check what these are, go to the robot's Sessions Controller and open Manage Sessions).

4. Go into the session you created

Go into your system tray and click on the Sessions Controller icon.

sessionsController image   or icon

5. Once in that session, open ScenarioBuilder, and begin creating your script.

 

Troubleshooting Tips

Connection Error

Refer to the solutions below if you receive the "ERRCONNECT_PASSWORD_CERTAINLY_EXPIRED" connection error:

Solution 1:

Go to "Computer Management", open the user properties and make sure the password is not expired for the user account.

Screenshot_5

Solution 2:

  1. Go to the machine where Sessions Controller is installed.
  2. Go to the "...\Automai\Sessions Controller\resources\app\php" folder and open the "SSrdpManager.conf" file.
  3. Change "securityoption=3" to "securityoption=1".
  4. Save the change and close the file.
  5. Try to connect to the user session again.

Solution 3:

NOTE – this only applies if the user is a domain user.

  1. Go to the machine where Sessions Controller is installed.
  2. Go to the "...\Automai\Sessions Controller\resources\app\php\sessions" folder and open the user connection file.
  3. Look for the hostname and replace it with "localhost".
  4. Save the change and close the file.
  5. Try to connect to the user session again.

    Keyboard Stops Working

    While rare, it is possible that the keyboard might stop working while the ScenarioBuilder user session is open. If this happens, try to minimize and then maximize the ScenarioBuilder session window or close and reopen it.