Skip to end of metadata
Go to start of metadata

Important Notes

Before you proceed with looking for a solution to your issue, double-check:

  1. Your target machine has a 64-bit version of Windows OS installed. 32-bit version is not supported!

  2. Your computer meets the system requirements.

     System Requirements


    TypeOSOS TypeCPURAMDisk Space
    Server + Workstation

    Windows Server: 2012, 2012 R2, 2016

    OR

    Windows: 7, 8, 8.1, 10

    64 bit

    4 cores at 2.8 GHz

    Minimum 8 GB of free memory

    (16 GB recommended)

    10 GB
    Server

    Windows Server: 2012, 2012 R2, 2016

    4 cores at 2.8 GHz

    Minimum 8 GB of free memory

    (16 GB recommended)

    8 GB
    Workstation

    Windows: 7, 8, 8.1, 10

    OR

    Windows Server: 2012, 2012 R2, 2016

    2 cores at 2.8 GHz

    Minimum 4 GB of free memory

    (8 GB recommended)

    2 GB

    Please refer to Deployment Diagrams for additional details.

If you don't find your solution here, escalate to RPA Express support: rpaexpress@workfusion.com

ABBYY SDK Licensing

If you face any issues during activation of OCR pages, please refer to ABBYY Knowledge Base.


RPA Express Installation

The section describes how you can solve issues that may occur during RPA Express installation.

Error code 0x80070661

Symptoms

Installation failed with error code 0x80070661.

Resolution

  1. Your target machine has 32-bit operating system installed.
  2. Check that you have 64-bit operating system (32-bit is not supported).

Error code 0x80070643

Symptoms

Installation failed with error code 0x80070643.

Resolution

  1. Some of .msi files can be moved to quarantine by anti-virus or anti-malware software.
  2. Disable your antivirus or antimalware software temporarily, restore file, and run RPAExpressInstaller.exe once again.
  3. If this doesn't help, collect and zip installation log files as described here and send them to rpaexpress@workfusion.com with a short description of your issue.
Error code 0x80070570

Symptoms

Installation failed with error code 0x80070570.

Resolution

  1. Make sure you have completely extracted the content of the installation archive (RPAExpressInstaller.zip) on your local drive.
  2. Disable your antivirus or antimalware software.
  3. If this doesn't help, collect and zip installation log files as described here and send them to rpaexpress@workfusion.com with a short description of your issue.
Error code 0x80070005

Symptoms

Installation failed with error code 0x80070005.

Resolution

In most cases it means that you don't have access to the folder C:\ProgramData\Package Cache. To check it, do the following steps.

  1. Create a folder in C:\ProgramData\Package Cache like C:\ProgramData\Package Cache\test, then try to copy any file from your PC and paste to this folder.
  2. If you get message below, ask to obtain an appropriate permission from your local IT department in order to resolve the issue.

  3. If you are able to create folder in C:\ProgramData\Package Cache, but the issue still exists, collect and zip installation log files as described here and send them to rpaexpress@workfusion.com with a short description of your issue.
Update admin user in PostgreSQL database was failed

Symtomps

The following window is being displayed during installation.

Resolution

  1. Check whether your system meets the System Requirements.
  2. If it does, check with your local IT team whether port 15423 is blocked. In case it is blocked, ask to unblock it, and run the installation once again.
  3. If the port is not blocked and installation still fails with the same error, collect and zip installation log files as described here and send them to rpaexpress@workfusion.com with a short description of your issue.

RPA Express Launch

The section describes how you can solve issues that may occur during RPA Express launch.

RPA Express shortcut doesn't start: Pop-up window is showing

Symptoms

After clicking on the RPA Express shortcut, the following window is shown.

Resolution 1

  1. Right-click on the RPA Express shortcut on your desktop.
  2. Press Change and find the application file wscript.exe in C:\Windows\System32 on your PC (see the screen below).
  3. Select this file, click Apply, and close shortcut properties.
  4. Run RPA Express.

Resolution 2 (if Microsoft Windows Based Script Host is removed from PC)

  1. Open folder C:\RPAExpress\RPA\wfagent.
  2. Create a file with the name express.bat and add content as below:

    START /B ..\..\Applications\Java\bin\javaw -Dagent.showIntro=true -Dloader.path=lib -Dhttp.nonProxyHosts="localhost|127.0.0.1" -Djava.awt.headless=false  -Dagent.desktopType=RPA_EXPRESS -Dfile.encoding=UTF-8 -Xmx500m -jar status-agent.jar --spring.config.location=./express.yml


  3. Open the shortcut properties and change attributes as shown below:

  4. Launch RPA Express.
RPA Express shortcut doesn't start: Windows Script Host access is disabled

Symptoms

After clicking on the RPA Express shortcut, the following window is shown.

Resolution

If you don't have permissions to change registry, contact your IT department.

  1. Type regedit in the Run box and press Enter to open the Registry Editor.
  2. Navigate to the following key: HKEY_CURRENT_USER\Software\Microsoft\Windows Script Host\Settings
  3. On the right panel, Value name is Enabled. If you see the entry 0, the Windows Script Host access is disabled on your Windows machine. To enable, double-click it and set Value data to 1.

    1. A value of 1 enables Windows Script Host
    2. A value of 0 disables Windows Script Host
  4. Click OK and exit the Registry. 

If you don’t see this entry, go to HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Script Host\Settings and repeat the steps above.

Platform Monitor page is unreachable

Symptoms

Connection to Platform Monitor via localhost cannot be established.

Resolution

Your computer is connected to the network via a proxy server, and the connection is managed by network administrators.

  1. Go to Control Panel > Internet Options and click LAN settings.
  2. Check, if there is a proxy specified in Automatic configuration (it cannot be changed).
  3. Contact your network administrator and request to add the following resources to exceptions:
    • localhost
    • 127.0.0.1
Control Tower failed to start

Symptoms

Control Tower cannot start, while your PC meets the System Requirements.

Resolution

  1. The cause is "Not enough storage is available to process this command".
    1. Solution: Edit registry
    2. Disable Microsoft Security Essentials (if installed)
  2. Check that all ports used by RPA Express are open. These are as follows.

    15100 - Platform Monitor
    15110 - S3 File Storage (Minio)
    15280 - Nginx
    15380 - Tomcat
    15306 - Mysql
    15423 - Postgres
    15444 - RPA Grid (Bot Manager)
    15410 - 15415 - RPA Node
  3. Check that UAC (User Account Control) is set to either on of the following options:
    1. Never notify
    2. Notify me only when programs/apps try to make changes to my computer
  4. Check Firewall inbound rules (Firewall > Advanced settings). It should be enabled for:
    1. RPAExpress Java
    2. RPAExpress Minio
    3. RPAExpress MySQL
    4. RPAExpress Nginx
    5. RPAExpress Postgres
Control Tower cannot be started from the tray menu

Symptoms

You tried to start Control Tower from the tray menu, but the status is Not started after several tries.

Mind that the tray menu is deprecated since RPA Express 2.3.0. Starting from 2.3.0, Control Tower is enabled on the Components tab in WorkFusion Studio.

Resolution

  1. Check whether your PC meets the System Requirements. Note that Control Tower takes a lot of RAM, so you may need to close other active applications while Control Tower is starting.

    It can take up to 10-15 minutes, depending on the machine's properties, to start Control Tower.

  2. If your machine meets the system requirements, but Control Tower still hasn't started, try starting it using Platform Monitor.

    Platform Monitor is deprecated since RPA Express 2.3.0.

    1. Open Platform Monitor from the tray menu.
    2. Go to System Processes and check components: 
      1. mysqld
      2. postgress
      3. tomcat
    3. They should have status stopped as on the screenshot below.
    4. Press Actions > Start for each of these components.
    5. Click OK in the window below and wait till the status of the components changes to running.

After that, you can log into Control Tower by opening this link in your browser: http://localhost:15280/workfusion/login

If the above steps are of no help, escalate to rpaexpress@workfusion.com with a detailed description of your issue.

Working with RPA Express

The section describes how you can solve issues, that may occur while working with RPA Express.


Bot Manager cannot be started

Symptoms

Bot Manager is stopped and cannot be started from the tray menu, while your machine is not connected to the network either by Ethernet or Wi-Fi.

Mind that the tray menu is deprecated since RPA Express 2.3.0.

Resolution

  1. Enable a Network interface.

    Important note

    It does not mean you should have access to Internet.

  2. Exit RPA Express.
  3. Install Microsoft Loopback Adapter as described on Microsoft TechNet website or follow the instruction below (for Windows 10).
    1. Open My Computer > Properties.
    2. Open Device Manager.
    3. Go to Action and select Add legacy hardware.
    4. Click Next in Add Hardware Wizard.
    5. Choose Install the hardware that I manually select from a list (Advanced) and click Next.
    6. Select Network adapters in the hardware types and click Next.
    7. In the Select the device driver dialog, choose:
      1. Manufacturer – Microsoft
      2. Model – Microsoft KM-TEST Loopback Adapter

      and click Next.
    8. Click Next to install.
    9. Wait until the installation ends and click Finish to complete.
    10. Open Device Manager to make sure Lookback Adapter is installed and enabled.
  4. Wait until the connection is established.
  5. Open Command Prompt and use ipconfig to check the status of all network interfaces. Make sure Loopback Adapter has got the ip-addresses.
  6. Start RPA Express.
  7. Check Bot Manager status in the tray menu.

    Mind that the tray menu is deprecated since RPA Express 2.3.0.

No samples of business processes in Control Tower

Symptoms

You see empty Business Processes list in Control Tower, though there should be samples with business processes.

Resolution

  1. Run your Control Tower if it is not started and open it.
  2. Go to the Business Processes list and click on the button next to Create New, and press Import package.
  3. Press Add in order to upload files.
  4. Find in the dialog window C:\Users\<user_name>\ControlTower\Samples. You should see several zip-archives and csv-files.
  5. Choose one of archives and press Open. You should see the following screen.
  6. Press Preview Package, wait a bit while the Import package button becomes available and press it. 
  7. After that, you can see sample business process in the list. 

Unable to open recording

Symptoms

While opening a recording created with a older version of RPA Express, migration fails with the following error.

When you click OK, Recorder cannot open the recording.

Resolution

Your recording is created with an older version of RPA Express and cannot migrate automatically due to changes in the actionmodel.

  1. Close the tab that shows the error and close Studio.
  2. Go to your workspace folder (by default C:\Users\%username%\workfusion-workspace\rpae_project).
  3. Find the .rpae file which you want to run.
  4. Open it with any text editor, e.g., Notepad.
  5. Find the string in the XML header which contains a wrong version number (see example below).

    xmlns:recorder="http://www.workfusion.com/recorder/v1.0.0"
  6. Change the namespace manually to the version of RPA Express currently installed on your machine (for example, 2.1.4)

    xmlns:recorder="http://www.workfusion.com/recorder/v2.1.4"
  7. Save your changes and close the text editor.
  8. Start Studio and open the recording.
  9. Repeat the procedure for all recordings created with an older RPA Express version, which fail to migrate automatically.
Model does not contain namespace URI

Symptoms

When you launch a recording, you get this error, as Recorder does not support migration from later to earlier versions.

Resolution

Open your recording with any text editor and manually change the version of RPA Express to the one installed on your machine. Follow the same steps described above for Unable to open recording.

Error executing WebElementAction

Symptoms

Error executing TemplateAction

...

Caused by: org.openqa.selenium.WebDriverException: unknown error: call function result missing 'value'

Resolution

If your RPA scripts stopped working after browser update, you need to do the following steps.

Chrome Driver

  1. Download the latest driver from https://sites.google.com/a/chromium.org/chromedriver/downloads
  2. Replace the old driver in RPA\rpa-grid\drivers\windows\x32

Firefox Driver

  1. Download the latest drivers(both x32 and x64) from https://github.com/mozilla/geckodriver/releases
  2. Replace old drivers in the following directories:
    1. geckodriver-vx-win32.zip → in RPA\rpa-grid\drivers\windows\x32
    2. geckodriver-vx-win64.zip → in RPA\rpa-grid\drivers\windows\x64
Bot cannot click on the needed element in Internet Explorer

Symptoms

You use Internet Explorer as your browser for automating, but a Bot cannot click on the needed element, no matter what mouse click option you select.

Resolution

Make sure your Windows display scaling is set up to 100%. To perform the needed changes, do as follows.

  1. Go to Start > Settings > System > Display.
  2. In Scale and Layout, select 100% for Change the size of text, apps, and other items. The changes apply automatically.
Recording is not playing: Unable to connect with Robot

Symptoms

You click Play recording, but the Unable to connect with Robot message emerges.

Resolution 1

Check Bot Manager status. Perhaps, it is not started.

  1. To start Bot manager, open RPA Express tray menu and click Start in the Bot Manager section.

    Mind that the tray menu is deprecated since RPA Express 2.3.0.

  2. If it does not help, choose All Components > Restart

Resolution 2

If the status of Bot Manager is 'Started' in the tray menu, do as follows.

  1. Click Details>> on the window with the error message.
  2. If the error text contains: Caused by: org.openqa.selenium.WebDriverException: Unable to parse remote response: <!DOCTYPE html>, open Server Profile (Window - Preferences - WorkFusion Studio - Server Profiles)
  3. Check the value of Bot Relay URL
  4. The URL should be: http://localhost:15444/wd/hub
  5. If it is wrong or missing, edit/insert it manually.
  6. Click Apply, then OK.
  7. If this URL is correct, but you still get the same exception, please refer to your local IT team in order to provide access to the URL.
Recording is not playing: java.net.MalformedURLException: no protocol

Symptoms

You click Play recording, but it fails with the following exception.

Resolution

  1. Open Window → Preferences: Workfusion Studio - Server Profiles, or click Server Profile:Default → Manage Profiles at the bottom right corner of WF Studio.
  2. Check whether Default profile settings are populated according to the following guide: Preferences
  3. If not, populate all necessary fields, then press Apply and save settings.
Recording is not playing: Cannot find active server profile

Symptoms

You click Play recording, but it fails with the following exception.

Resolution

  1. Open Window > Preferences: WorkFusion Studio - Server Profiles, or click Server Profile: Default > Manage Profiles at the bottom right corner of WorkFusion Studio.


  2. If you see the error 'Cannot find active server profile' in Server Profile (see below), you need to delete folder C:\Users\%USER_NAME%\.eclipse and check whether Server Profile has been found and is not empty.
  3. If the Server Profile is empty, populate the field as described in this guide: Preferences

    Note

    Do the next steps only in case of folder C:\Users\%USER_NAME%\.eclipse being absent. If you have it and can remove, see steps 1-3 above.

  4. In case the folder C:\Users\%USER_NAME%\.eclipse is absent, and/or Server Profile is not saved even after manual, do as follows.
    1. Open Window > Preferences and go to General > Security > Secure Storage.
    2. Unheck Windows Integrated (64 bit), press Apply and then OK.

      Do not click on the Change Password button.

    3. Enter your own password and hints for recovering password as shown below.

    4. Restart RPA Express and launch WorkFusion Studio.
    5. You should see a password window. Enter password you have previously set, go to WorkFusion Studio, and check whether Default server profile is filled in.
Recording is not playing: Unable to read file

Symptoms

You click Play recording, but the message 'Unable to read file' appears.

Resolution

Check that the details in all actions are filled in completely and there are no empty drop-downs, paths to files/folders or conditions.

You can see which element is missing in the error log by clicking Details>> button.

Recording is playing in RPA Recorder but not in Control Tower

Symptoms

You play the recording in WorkFusion Studio and it runs without errors. But after publishing the recording to Control Tower it is not playing.

Resolution

If you use path to files in your actions (Enter Keystrokes, Launch Application), make sure that all backslashes are doubled, for example:

C:\\Program Files\\Your Super Software\\Installer.msi
Recorder gets too slow

Symptoms

WorkFusion Studio is working extremely slowly.

Resolution

The maximum memory allocation pool for Java Virtual Machine (JVM) has been exceeded by Studio.

  1. Make sure that Studio is closed.
  2. Go to Studio folder (by default C:\RPAExpress\Studio\).
  3. Find and open Studio configuration file (workfusion-studio.ini).
  4. Find the Xmx property. Default value is 1024m that equals to 1024 MB of memory.
  5. Change the value of the flag to 2048m to double the size of the memory pool.
  6. Save and close the configuration file.
  7. Start Studio.
Cannot publish a recording to SPA Control Tower

Symptoms

You are getting an error while trying to publish a recording to SPA: "Control Tower has responded with error."

Resolution

Check the following:

  1. Verify that your SPA Control Tower is up and running
  2. Check Studio properties in %install_dir%/Studio/configuration/config.ini file. Example:
    1. com.workfusion.studio.recorder.wf.host=http\://wfapp.somedomain.com

    2. com.workfusion.studio.recorder.wf.port=8080

    3. com.workfusion.studio.recorder.wf.username=someUsername

    4. com.workfusion.studio.recorder.wf.password=somePassword

  3. Check that "recorder-images" bucket exists on S3, which is connected to SPA
RPA Express does not respond

Symptoms

RPA Express has got non-responsive and stays so for a long time.

Resolution

You should end all RPA Express processes manually.

For that purpose we recommend to use Process Explorer (Windows Sysinternals tool), as the standard Windows Task Manager is not convenient to handle multiple processes.

  1. Go to Process Explorer page. There you can find a description of the tool and the download link.
  2. Download Process Explorer and unpack it to a local folder on your computer.
  3. Start Process Explorer (procexp.exe or procexp64.exe) and accept EULA. Process Explorer opens.
  4. Find the following tasks:
    1. java.exe with multiple sub-tasks;

    2. cmd.exe with sub-tasks postgres.exe.

  5. Select the task, right click and choose "Kill Process Tree" in the context menu.

  6. Do the same for the second task.

Error executing OcrAction: OcrException cannot be found

Symptoms

Execution error appears:

Resolution

  1. First you need to check if the OCR has started in your tray menu.
  2. Then go to Platform Monitor > Components and click on the info icon near OCR. Check if you still have the remaining number of pages to be processed under the current OCR license.

    If you see 0 pages left, you'll need to purchase an OCR license. Please contact rpaexpress@workfusion.com for more details.

  3. If you still have pages remaining, check your RPA express version as it might require an update. Go to Control Panel > Programs > Programs and Features as seen on the picture below.


    Here you can find a list of all RPA Express versions, including the latest one, for a reference.
  4. If you have the latest version (no update available) you'll need to proceed with the investigation. Please contact rpaexpress@workfusion.com and describe your issue, the support team will help you out.

    Mind that the tray menu and Platform Monitor are deprecated since RPA Express 2.3.0. To view the number of OCR pages, go to the Components tab in WorkFusion Studio.

"Ctrl+Enter" keystroke combination not working

Symptoms

Keystroke combination 'Ctrl + Enter' is neither accepted nor shown in the Key combination box.

Resolution

By default, the 'Ctrl + Enter' keystroke is accepted with all windows minimized. Do as follows.

  1. Add Keystrokes to the Actions Flow.
  2. Click Change and minimize all windows.
  3. Hit Ctrl + Enter for the combination to appear in the details.

There is also a workaround to make it work without minimizing all open windows. You can record 'Ctrl + Enter' using RPA recorder.

  1. Click Insert recording.
  2. After recording starts, click 'Ctrl + Enter' and stop the recording. You will get the Enter Keystrokes 'Ctrl + Enter' action.

After that, you can use this recording anywhere you need to insert the 'Ctrl + Enter' keystroke.

Error executing OCR action: URL is not absolute

Symptoms

OCR action fails and returns an error 'Error executing OCR action: URL is not absolute'.

Resolution

  1. First you need to check if the server profile is filled in:
    image
    If not - you can fill it in manually using this guide.
  2. If this does not help, check your RPA express version as it might require an update. Go to Control Panel - Programs - Programs and Features as seen here:

    Here you can find a list of all RPA Express versions, including the latest one, for a reference.
  3. If you have the latest version (no update available) you'll need to proceed with the investigation. Please contact rpaexpress@workfusion.com and describe your issue, the support team will help you out.
Scheduled process doesn't appear in Business Processes list in Control Tower

Symptoms

 When you set up schedule for some process it doesn't appear in Business Processes tab.

Resolution

Please check that you've chosen a whole business process while scheduling, not a task.

Please correct the schedule for a whole business process and you will see it in the list of all business processes.


How to Send Logs

Hint

RPA Express logs contain information about events and messages produced by RPA Express components, and a short list of the system properties, such as OS version, CPU type and RAM size.

No sensitive information is collected and included.

It's safe to send them out to WorkFusion by any means (e-mail or via forum as a private message or an attachment to your post).


Installation logs

If installation failed and you see any exception after it, and your PC meets RPA Express System Requirements, do the following steps:

  1. Go to C:\Users\%user_name%\AppData\Local\Temp folder.
  2. Find all files that start with "WorkFusion_RPA_Express_" and have .log extension.
    For example: 
    WorkFusion_RPA_Express_20180505113212.log
    WorkFusion_RPA_Express_20180907113252_001_WorkFusionControlTower.log
  3. Create a ZIP archive with these files.
  4. Post this archive and description of your issues to WorkFusion Forum or send email to rpaexpress@workfusion.com.
RPA Express Component logs

If one of RPA Express components is not working properly after a successful installation, and your PC meets System Requirements, complete the following steps.

Mind that the tray menu and Platform Monitor are deprecated since RPA Express 2.3.0.

  1. Open Platform Monitor > Command Board (from the tray menu or type http://localhost:15100/commands in the browser address line).
  2. Click the Execute button opposite to the required command (command which starts a failed/unavailable component).
  3. Copy response text and send it to WorkFusion Forum
WorkFusion Studio logs
  1. Go to %install_dir%\Studio\logs (default is C:\RPAExpress\Studio\logs)
  2. Create a ZIP archive of contents of the folder.
  3. Post this archive and description of your issues to WorkFusion Forum or send email to rpaexpress@workfusion.com.
Control Tower logs

If you experience some issues, you can send us a report by click the Send report link.

This action will generate a detailed report and open your default email client with system info:

All you need for sending the report is to:

  1. Go to the folder in the RPA Express installation folder: C:\RPAExpress\Workfusion\
  2. Attach the report.zip file to the email.
  3. Send the email to rpaexpress@workfusion.com.
Control Tower logs (Tray menu is not available)

If you experience some issues with starting WorkFusion Agent, do as follows.

  1. Go to %install_dir%\RPA\wfagent (by default is C:\RPAExpress\RPA\wfagent)
  2. Right click on rpae-report.ps1 → Run with PowerShell

This action will generate a detailed report and open your default email client with system info:

All you need for sending the report is to:

  1. Go to WorkFusion's folder in the RPA Express installation folder (by default is C:\RPAExpress\Workfusion\)
  2. Attach the report.zip file to the email.
  3. Send the email to rpaexpress@workfusion.com.