10.2.2

Edit

Troubleshooting

Cannot launch bots locally because of duplicated dependencies

Expand to learn more

note

This solution can be applied to any version of Workfusion Studio.

Symptoms

In some cases, while trying to launch bots locally in WorkFusion Studio, there may be a problem: even though the project was built without any errors when any bot was launched, an error on duplicated dependencies appeared. But these listed dependencies were not added to external dependencies of the project.

Resolution

  1. Right-click on your project.

  2. Select the Properties menu item.

  3. In the window that follows, click on Maven.

  4. On the right side of the window, unselect the checkbox Resolve dependencies from Workspace projects.

  5. Press Apply and close.

After unselecting this checkbox, you will be able to run bots locally.

Eclipse proxy settings

Expand to learn more

Symptoms

When executing bot task plugins that access external resources, you may get an error message similar to this one:

org.webharvest.exception.HttpException: IO error during HTTP execution for URL: https://workfusion.com/

Resolution

  1. Try to add settings to use proxy in the eclipse.ini file that is located in the eclipse installation folder.
  2. Add proxy settings. eclipse.ini - proxy settings: 
    -Dorg.eclipse.ecf.provider.filetransfer.excludeContributors=org.eclipse.ecf.provider.filetransfer.httpclient
-Dhttp.proxyPort=8080
-Dhttp.proxyHost=XXX
-Dhttp.proxyUser=XXX
-Dhttp.proxyPassword=XXX
-Dhttp.nonProxyHosts=localhost|127.0.0.1

NullPointerException

Expand to learn more

Symptoms

When running a bot task configuration, you may get a NullPointerException in Eclipse.

Resolution

If Eclipse restart does not help, start it in the clean mode in the command prompt. The sample command is as follows:

D:\WorkFusion Studio folder>eclipse.exe -clean
tip

For more information, see How to run Eclipse in clean mode.

OutOfMemoryError

Expand to learn more

Symptoms

When launching or editing an existing bot task configuration, you may get OutOfMemoryError.

!ENTRY org.eclipse.jdt.core 4 4 2016-08-22 10:59:46.260
!MESSAGE Background Indexer Crash Recovery
!STACK 0 java.lang.OutOfMemoryError: Java heap space at org.eclipse.jdt.internal.compiler.util.HashtableOfObject.<init>(HashtableOfObject.java:39) at org.eclipse.jdt.internal.compiler.util.HashtableOfObject.rehash(HashtableOfObject.java:165)

Resolution

To increase the maximum heap size, update eclipse.ini located in the Eclipse installation folder. To do this, open eclipse.ini and add/change the value of -Xmx to -Xmx1600m.

tip

For more information, see How to increase the heap size available to Eclipse.

Find log files

Expand to learn more

In case of unexpected errors in Studio, you can attach logs to JIRA issues.

Find a log following this path: %way_to_current_workspase%/.metadata/.log

In addition to the log file, specify full OS version (for example, Microsoft Windows 10 Pro x64) and version of Java installed (for that, execute java -version in cmd).

To access log, you can also go to Help > About WorkFusion Studio > Installation Details > Configuration > View Error Log.

Run Eclipse with custom Java runtime environment

Expand to learn more

In case of several JRE installed on you environment, you can specify which one will be used to run Eclipse with WorkFusion Studio.

  1. Go to %eclipse_installation_folder%/eclipse.ini
  2. Insert the following text on two separate lines into the beginning of the file (before line with -vmargs). 
    -vm %path-to-java-8-runtime%/bin/javaw

In this case, Eclipse will run using the specified JRE.

note

You can also copy the JRE folder directly to the Studio installation directory and rename it to jre. Thus, Eclipse will use it automatically.

Unable to open recording

Expand to learn more

Symptoms

While opening a recording created with a older version of Intelligent Automation Cloud, migration fails with the following error.

When you click OK, RPA Recorder cannot open the recording.

Resolution

Your recording is created with an older version of Intelligent Automation Cloud and cannot migrate automatically due to changes in the action model.

  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 you want to run.

  4. Open it with any text editor, for example, 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 currently installed on your machine.

    xmlns:recorder="http://www.workfusion.com/recorder/v2.4.0"

  7. Save your changes and close the text editor.

  8. Start Studio and open the recording.

  9. Repeat the procedure for all the recordings created with an older version, which fail to migrate automatically.

Model does not contain namespace URI

Expand to learn more

Symptoms

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

Resolution

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

Error executing WebElementAction

Expand to learn more

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 here.
  2. Replace the old driver in IntelligentAutomationCloud\RPA\rpa-grid\drivers\windows\x32.

Firefox Driver

  1. Download the latest drivers (both x32 and x64) here.
  2. Replace old drivers in the following directories:
    1. geckodriver-vx-win32.zip > in IntelligentAutomationCloud\RPA\rpa-grid\drivers\windows\x32
    2. geckodriver-vx-win64.zip > in IntelligentAutomationCloud\RPA\rpa-grid\drivers\windows\x64

Bot cannot click on needed element in Internet Explorer

Expand to learn more

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: java.net.MalformedURLException: no protocol

Expand to learn more

Symptoms

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

Resolution

  1. Open Window > Preferences > Workfusion Studio > Server Profiles.

  2. Check whether default profile settings are populated according to the following guide: Preferences.

  3. If not, populate all the necessary fields, then press Apply and Close.

Recording is not playing: Cannot find active server profile

Expand to learn more

Symptoms

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

Resolution

  1. Open Window > Preferences > Workfusion Studio > Server Profiles.

  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 the server profile has been found and is not empty.

  3. If the server profile is empty, populate the fields as described in this guide: Preferences.

    note

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

  4. If the folder C:\Users\%USER_NAME%\.eclipse is absent, and/or the server profile is not saved even after manual entering the data, do as follows.

    1. Open Window > Preferences > General > Security > Secure Storage.
    2. Uncheck Windows Integrated (64 bit), press Apply, and then OK.
    caution

    Do not click on the Change Password button.

    1. Enter your own password and hints for recovering password as shown below.
    2. Restart and launch WorkFusion Studio.
    3. In the password window that appears, enter the 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

Expand to learn more

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 the Details>> button.

Recording is not playing: Unexpected error during execution. Secret entry not found

Expand to learn more

Symptoms

After a bot starts playing, it fails with the following exception.

Resolution

This exception means that there is no secret entry for Secrets Vault variables in your script. Before playing your script, make sure you have the required secret entry in the guide. Pay attention that the secret entry name should be the same as in the exception. In this case, you should have the salesforce_cred secret entry as shown below.

Recording is not playing: Unexpected error during execution

Expand to learn more

Symptoms

After a bot starts playing, it fails with the following exception.

Resolution

This exception means that a secret variable doesn't have any default secret entry. Before playing your script, make sure you have the required secret entry as described here. Alternatively, you can remove this variable from the script.

RPA Recorder gets too slow

Expand to learn more

Symptoms

WorkFusion Studio is working extremely slow.

Resolution

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

  1. Make sure that WorkFusion Studio is closed.
  2. Go to Studio folder (by default C:\IntelligentAutomationCloud\Studio\).
  3. Find and open the 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 WorkFusion Studio.

Error executing OCR action: URL is not absolute

Expand to learn more

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. If not, you can fill it in manually using this guide.
  2. If this does not help, check your version as it might require an update. Go to Control Panel > Programs > Programs and Features as seen here.

Error executing OCR action: OcrException cannot be found

Expand to learn more

Symptoms

An execution error occurs.

Resolution

  1. Check the OCR status and the remaining number of pages to be processed under the current OCR license.
  2. If you see 0 pages left, you'll need to purchase an OCR license.
  3. If you still have pages remaining, check your Intelligent Automation Cloud version, as it might require an update. Go to Control Panel > Programs > Programs and Features as seen on the picture below.

Window cannot be recognized in SAP GUI

Expand to learn more

Symptoms

While automating SAP GUI and using the Window action, it cannot be recognized. For example, you entered the selector of the Save As window using Inspector.

While script execution, an exception occurs.

Resolution

  1. Check your SAP GUI UI theme.
  2. Change your UI theme to Blue Crystal or Classical if you use any other theme.
  3. In case you use one of these themes or this solution doesn't help, collect and zip the Studio log files.

Exception on opening execution-result.log.csv in WorkFusion Studio

Expand to learn more

Symptoms

While trying to open execution-result.log.csv in WorkFusion Studio in Excel after script execution, the following exception appears.

That happens due to the total length of the file name and path.

Resolution

Make sure the whole file path to the execution-result.log.csv file is not less than:

  • 200 characters for OneDrive (including spaces and slashes)
  • 260 characters in case of local drive (including spaces and slashes) In case it exceeds these values, move your project or the whole Workspace to a short path, and remove unnecessary folders hierarchy.

Oracle JInitiator version is too low. Please install version 1.1.8.2 or higher

Expand to learn more

Symptoms

While trying to log in to some servlet (Oracle Form), a similar exception occurs.

Resolution

Usually, the exception means that the Java version is old, for example, 7. But our application has its own Java package with version 1.8, so this is not an issue with it. To fix this exception, do as follows.

  1. Open Java Control Panel and select the Java tab.
  2. Open View and enter -Djava.vendor="Sun Microsystems Inc." in the Runtime Parameters field.
  3. Click OK and close Java Control Panel.
  4. Run your script.

Secure storage password: Incorrect password or data is corrupted

Expand to learn more

Symptoms

After launching WorkFusion Studio and entering the Secure Storage password, you receive the following message.

Resolution

  1. Close this message window and Studio completely. It may require several clicks on the message window.
  2. Go to the folder C:\Users\your_user_name and remove folder .eclipse.
  3. In the same folder, remove the profiles.properties file.
  4. Run the application again, enter a new password and hints if needed.

← Override property value