10.1.6.2

Edit

Troubleshooting

Cannot launch bots locally because of duplicated dependencies

Expand to learn more

note

You can apply the solution to any version of WorkFusion Studio.

Symptoms

In some cases, when you try to launch bots locally in WorkFusion Studio, the following issue can occur: even though the project is built without any errors, when a bot is launched, a duplicated dependencies error appears.

Resolution

To resolve the issue, follow the steps below:

  1. Right-click the project.

  2. Select the Properties menu item.

  3. In the window that follows, click Maven.

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

  5. Click Apply and close.

After deselecting the 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 can get an error message similar to this one:

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

Resolution

To resolve the issue, follow the steps below:

  1. In the Eclipse installation folder, find the eclipse.ini file.

  2. Add the 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 can 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 might 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 or 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 WorkFusion 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 the full OS version (for example, Microsoft Windows 10 Pro x64) and installed Java version (for that, execute java -version in cmd).

To access the 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 in your environment, you can specify which one is to 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 in the beginning of the file (before the 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 WorkFusion 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 an 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. To resolve the issue, follow the steps below:

  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 that contains a wrong version number (see the 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 that had not been migrated 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 the browser update, you need to do the following:

For Chrome Driver:

  1. Download the newest driver.
  2. Replace the old driver in IntelligentAutomationCloud\\RPA\\rpa-grid\\drivers\\windows\\x32.

For Firefox Driver:

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

Bot cannot click required 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 the default profile settings are populated according to the following guide: Preferences.
  3. If not, populate all necessary fields, then click 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 Cannot find active server profile error in Server Profile (see below), you need to delete the C:\\Users\\%USER\_NAME%\\.eclipse folder 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

    Perform the steps below only in case the C:\\Users\\%USER\_NAME%\\.eclipse folder is absent. If you have it and can remove, see Steps 1-3 above.

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

    1. Open Window > Preferences > General > Security > Secure Storage.

    2. Uncheck Windows Integrated (64 bit), click Apply, and then OK.

      caution

      Do not click the Change Password button.

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

    4. Restart and launch WorkFusion Studio.

    5. In the password window that appears, enter the password you have previously set, go to WorkFusion Studio, and check whether the default server profile is filled.

Recording is not playing: Unable to read file

Expand to learn more

Symptoms

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

Resolution

Check that the details in all actions are filled in completely and there are no empty dropdown boxes, 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

Right after the record starts playing, the bot 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. Mind that the secret entry name must be the same as in the exception. In this case, you must 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 Secrets Vault variable doesn't have any default secret entry. Before playing your script, make sure you have the required secret entry as described in the Configure preferences guide. Alternatively, you can remove the variable from the script.

RPA Recorder gets too slow

Expand to learn more

Symptoms

WorkFusion Studio is working extremely slow. The most probable reason is that the maximum memory allocation pool for Java Virtual Machine (JVM) has been exceeded by Studio.

Resolution

To resolve the issue, follow the steps below:

  1. Make sure that WorkFusion Studio is closed.
  2. Go to Studio folder. By default, it is C:\\IntelligentAutomationCloud\\Studio\\.
  3. Find and open the workfusion-studio.ini configuration file.
  4. Find the Xmx property. The 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

An OCR action fails and returns the following error: "Error executing OCR action: URL is not absolute".

Resolution

To resolve the issue, follow the steps below:

  1. Check if the server profile is filled in. If not, you can fill it in manually as described in the Configure preferences guide.
  2. If the above step does not help, check your version as it might require an update. Go to Control Panel > Programs > Programs and Features as shown in the figure below:

Error executing OCR action: OcrException cannot be found

Expand to learn more

Symptoms

An execution error occurs:

Resolution

To resolve the issue, follow the steps below:

  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, you use the Window action, but the window cannot be recognized. For example, you entered the selector of the Save As window using Inspector.

During script execution, an exception occurs:

Resolution

To resolve the issue, follow the steps below:

  1. Check your SAP GUI UI theme.
  2. Change your UI theme to Blue Crystal or Classical if you use any other.
  3. In case you use one of these themes or the 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

As you try to open execution-result.log.csv in WorkFusion Studio in Excel after script execution, the following exception appears:

The error occurs because the total length of the file name and path exceeeds the allowed limit.

Resolution

Make sure the whole file path to the execution-result.log.csv* file does not exceed:

  • 200 characters for OneDrive, including spaces and slashes
  • 260 characters for a local drive, including spaces and slashes

In case the path exceeds the above values, move your project or the entire workspace to a shorter path and remove the unnecessary folder hierarchy.

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

Expand to learn more

Symptoms

As you try to log into a 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 the issue in this case. To fix the exception, do as follows:

  1. Open Java Control Panel and select the Java tab.
  2. Open View and,in the Runtime Parameters field, enter -Djava.vendor="Sun Microsystems Inc.".
  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

To resolve the issue, follow the steps below:

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

← Troubleshoot WorkSpace issues