Known issues

This topic contains information about potential issues that you may encounter while using Kofax RPA 11.2.0. The workarounds are provided, as applicable.

Product component names differ in documentation and product package

1646492: The Kofax RPA product component names mentioned in the documentation slightly differ from the actual product component names as appear in the product package. The difference is in the use of an underscore after the product name and a fourth digit in the version number. The correct names are listed in Product package components renamed.

Installation guide contains incorrect note about PostgreSQL

1644804: Page 12 of the Kofax RPA Installation Guide contains a wrong statement about a PostgreSQL database saying that it cannot be used as a Management Console system, logging, or audit database. This is incorrect, and a PostgreSQL database can be used as a Management Console system, logging, or audit database.

For more information on supported database management systems, see the Kofax RPA Technical Specifications available on the Kofax RPA Product Documentation site.

Classic Kapplets backup files have restrictions

1644468: Classic (legacy) Kapplets backup files have a few restrictions. Values of the following fields, Session, Country, Currency and Language, cannot be saved in a classic Kapplets backup file. Therefore, these fields cannot be restored with a backup in Kapplets 11.2.0.

Misleading description of Wait For Result option in documentation

1644014: The Wait For Result option is incorrectly described in the documentation.

The correct description is provided below and will be added to the documentation in the next Kofax RPA release.

"When Wait For Result is selected, the robot waits until the code is executed and the result is written into the JS Execution Result variable.

The timeout is 60 seconds. If the action is not completed within this time period, a timeout error is shown. Also, if the JavaScript code contains errors, an error is shown. If you do not select this option, the robot does not wait until the code execution is finished and proceeds to the next step immediately. The result is not collected and is not written into the variable. Furthermore, any definition made or object created in this code will be limited to this step only, and will not be available in subsequent Execute JavaScript steps."

For more information, see Robot Building > Robot Steps > Windows > Application actions in Help for Kofax RPA.

Slider cannot be moved by Move Mouse and Press/Release

1642468: If a website opened with the Browse step contains a bar with a slider, it is impossible to move the slider using the Move Mouse and Press/Release steps.

Workaround: Use the Left Click step to indicate the expected position of the slider on the bar. Then execute the step to move the slider to that position.

Tree not available for SAP

1642467: It is impossible to use SAP because nodes for some elements are not available in the tree.

Workaround: To make all nodes available in the tree, from the product installation files, download and save the RegSAPSurrogate.reg file on the computer running the Desktop Automation Service. Run it accepting any warnings and then restart the Desktop Automation Service agent. The file resides in the {path}\DesktopAutomationService\bin folder.

TotalAgility cannot reach RPA with server configuration set to Cluster

1641912: Kofax TotalAgility cannot reach Kofax RPA when a server configuration is set to Cluster. Applicable to Kofax TotalAgility versions 7.8.0 and 7.9.0.

Workaround: Configure KTA to use RoboServer instead of Cluster. Or, configure KTA to use the REST communication type instead of .NET.

Excel Paste action does not recalculate worksheet dimensions

1641710: If large text is pasted into an Excel cell, the cell selection is shifted.

Workaround: Use the "Scroll To" step to recalculate the cell.

Obsolete reference to Windows 7 in DTS documentation

1640150: The Document Transformation feature is no longer supported on Windows 7. All existing references to Windows 7 that are still present in the Kofax RPA documentation will be removed in the next Kofax RPA release.

Headless Excel keeps running when DAS is stopped manually

1638874: When running Headless Excel on a remote Desktop Automation Service, the Desktop Automation Service instance can be stopped with the systray application. If this is done by a user while a Headless Excel application is opened in a Robot, the Excel COM instance associated with the application keeps running.

Audit logging occurs for every Robot run

1635332: When a computer with the Desktop Automation Service is started, and the audit logging is enabled for the Management Console, executing a schedule with a Robot that performs actions on the Desktop Automation Service computer causes the audit logging to occur for every Robot run. Instead, the audit logging should occur once the Desktop Automation Service is started.

Localization missing for some messages

1625531: Some exceptions and error messages related to kapowhub are not localized in this product version.

Legacy RoboServers do not write logs in UTC

1618537: Starting with version 11.2.0, Management Console and RoboServer write logs to a database in UTC time format, which is different from previous versions when the time was logged in a time zone of the respective Management Console and RoboServer.

Workaround: Start legacy RoboServers with the java -Duser.timezone=GMT option.

Time zone change in Kofax Analytics for RPA

1616761: The internal time zone format in Kofax Analytics for RPA has changed to UTC, which means that data from Kofax RPA versions prior to 11.2.0 is shown incorrectly in Kofax Analytics for RPA 2.5.0 and later.

New group created unexpectedly in Kapplets

1607788: Adding new users to the default RPA Administrators group in Management Console causes an "rpa administrators" group to be created in Kapplets.

Desktop Automation Service may stop running on Windows 7

1603045: The Desktop Automation Service may stop functioning on Windows 7 when a .NET application is started while it is running.

Browser update issue causes warning

1596966: When the Google Chrome browser is updated, it takes some time to respectively update the Chromium browser (CEF) used in Kofax RPA. Due to this version inconsistency, a warning message may appear for some websites stating that the currently used browser is not safe.

Workaround: In the Browse step, manually specify the User Agent from the latest Google Chrome version.

Call REST Web Service step cannot load page

1594223: The Call REST Web Service step cannot load a page with Digest authentication when using a proxy server.

Opening Recorder View context menu may slow down interface

1594101: Right-clicking some tree elements in the Recorder View to open the context menu may freeze the Design Studio interface for several seconds until the menu opens.

SignDoc email validation not imposed in RPA

1593366: Some email addresses of a reviewer or a signer that are invalid in Kofax SignDoc can be entered and validated in Kofax RPA.

Workaround: Consult the SignDoc documentation to ensure that the email addresses you are using are valid before entering them in RPA.

StackOverFlowError reported

1584988: If the StackOverFlowError is reported, you need to manually increase the memory limit in the DesignStudio.conf file. To do so, add the wrapper.java.additional.1 setting to the file and specify the memory limit.

Example: wrapper.java.additional.1=-Xss4096K

Management Console cannot create Analyzer database

1584454: If you use the Database provisioning default settings when filling out the Process Discovery Analyzer parameters in a Management Console, the Management Console cannot create the Analyzer database, and provisioning fails.

Workaround: Explicitly specify the username and password under Process Discovery Analyzer > Database provisioning in Management Console before creating a database.

Issue with Japanese offline documentation

1559704: If you deploy the offline documentation in Japanese on the Tomcat server using the Microsoft Edge browser, the help files may contain unreadable characters.

Workaround: Use Google Chrome or Mozilla Firefox browsers with the Japanese offline documentation.

WebKit browser upgrade issue

1549324: The WebKit browser used in Kofax RPA 11.2.0 includes the updated OpenSSL library (1.1.1 version). This library supports the new TLSv1.3 protocol, has increased requirements for keys and also no longer supports some weak ciphers. As a result, some of the websites with weak security protocols may not be accessible.

No events for applications running with administrator rights

1546570: Process Discovery Agent cannot collect events of the applications running with administrator rights.

Workaround: Run Process Discovery Agent with administrator rights to collect events from all applications.

Schedules not working after importing backup

1536508: When the user is trying to import a backup in Management Console, and the import fails, the existing schedules switch to their default values and can no longer be started.

Workaround: To start the schedules, they need to be recreated. Before importing a backup, we recommend that you create a backup of the current Management Console state.

Errors occur when using Kapplets database

1532653: Some errors occur when you try to use an existing Kapplets 11.0.0 database in Kapplets 11.2.0. The Kapplets 11.0.0 database contain user and system preferences that are not applicable to a new Kapplets 11.2.0 installation.

Uninstalling DTS does not remove license utility

1524460: When uninstalling the Document Transformation Service version 11.0.0 to prepare for a new installation, the license utility is not entirely removed.

Workaround:

  1. Uninstall the old Document Transformation Service version.

  2. Install a new Document Transformation Service version and then uninstall it.

  3. Install the new version again.

Kapplets use system collation instead of schema collation

1523086: Kofax RPA Kapplets that use MySQL database use the collation from the database properties variable "collation_database" instead of using the schema collation. It may cause Unicode characters to be shown incorrectly if the "collation_database" is not set to a Unicode collation.

Workaround: Make sure that you use the schema collation for the utf8mb4 character set in the database system variables "collation_connection," "collation_database," and "collation_server."

Kapplet user missing group affiliation in imported backup

1517340: When a backup file containing a Kapplet user with the specific double-byte character set name is imported to a Management Console, the Kapplet user does not belong to the Management Console group that the user was initially assigned to.

Process Discovery database user password not encrypted

1517076: The Process Discovery database user password is not encrypted when stored in the Management Console.

File common.conf can only be used for initial configuration

1516977: The common.conf file can only be used to configure a Management Console for the first time, which includes the display language to use. If subsequent configuration is required for the Management Console, it cannot be performed with common.conf.

Workaround: Perform any subsequent configuration directly in the Management Console interface.

File org_freedesktop_general may get locked

1512677: When running multiple robots simultaneously, the org_freedesktop_general file used by the D-Bus protocol to authenticate the server and client may get locked by one robot for a short period of time, preventing another robot from accessing this file to read cookies from it.

'Jobs timeout' and 'Execution time limit' converted to minutes

1502164: During schedule creation, the "Jobs timeout" and "Execution time limit" property values are converted from seconds to minutes. This situation occurs only when the value in seconds can be converted to whole minutes.

For information on these properties, see "Schedules" in Help for Kofax RPA.

OAuth app not allowing project synchronization

1499121: When a Management Console contains an OAuth application in the repository, it is not possible to synchronize two projects with the VCS user.

Load Page fails to open web pages with Japanese characters

1498551: A Basic Engine Robot may fail to open website pages that contain Japanese characters. This issue was reported while using the built-in browser on a Windows system set to a Japanese regional format.

Workaround: For the loaded page, in the Robot Configuration > Page Loading > Page Change settings, specify a text replacement for the URL of the loaded page:

<body class="no-navi">

to

<body class="no-navi" style="text-align: start;">

Restoring backup fails if it contains case-sensitive folder names

1496143: Restoring a backup in Management Console is not possible if the backup contains folders with similar names that are case-sensitive such as "test" and "Test."

Robot using RFS does not work if copy is in another project

1478872: A Robot with steps that use the Robot File System does not work if a copy of this Robot is uploaded to another project in Management Console.

Symbols in Kapplets workspace name lead to errors

1445050: Using the following symbols in workspace names in Kapplets leads to errors:

/ \ % ? . {

Workaround: Do not use these symbols in workspace names in Kapplets.

Some variable types cannot be used in Raise Job Event

1403260: This issue is resolved with Kofax TotalAgility 7.8.0 and later. For earlier versions, the issue still occurs. Using the following variable types in the Raise Job Event action in the KTA step leads to errors: date, byte, document, float, double, nullable date, nullable string, and currency.

Trigger mappings not restored with backup

1398421: Management Console backup files created in versions 10.3.0.0 - 10.3.0.9 do not include trigger mapping data. Use the following workaround to create a backup that will contain all correct data. This workaround was introduced in version 10.3.0.10.

Workaround

For the enterprise Management Console

This procedure restores trigger mappings and applies to the Management Console deployed on Tomcat that contains attended robots with trigger mappings.

  1. Stop Tomcat and back up your database before continuing.
  2. Before installing the 11.2.0 .war file, open it and modify the version.properties file, which resides in WEB-INF\classes, to match the version you are upgrading from.

    For example, if you are upgrading from 10.3.0.5, the text in the file must be: fullVersion=10.3.0.5 266

  3. Install the updated 11.2.0 ManagementConsole.war file on Tomcat. It will start a 11.2.0 Management Console with the old database.

  4. Create a backup to contain all data including the trigger mappings.

  5. Install a new 11.2.0 Management Console with an empty database (without changes to the .war file).

  6. Restore the backup created in Step 4.

For the development Management Console

This procedure restores trigger mappings and applies to the embedded Management Console that contains attended robots with trigger mappings.

  1. Stop the original Management Console and back up the folder:

    C:\<username>\AppData\Local\Kapow\10.3.0.x_<build number>

    to

    C:\<username>\AppData\Local\Kapow\10.3.0.x_<build number>_original

  2. Install Kofax RPA 11.2.0 and do not start the Management Console.

  3. Open the ManagementConsole.war file, which resides in <program folder>\RPA 11.2.0 <build number>\WebApps, and modify the version.properties file, which resides in WEB-INF\classes, to match the version you are upgrading from.

    For example, if you are upgrading from 10.3.0.5, the text in the version.properties file must be: fullVersion=10.3.0.5 266

  4. Delete all files from:

    C:\<username>\AppData\Local\Kapow\10.3.0.x_<build number>\Temp

  5. Add the updated ManagementConsole.war file to the original version to:

    <program folder>\Kapow 10.3.0.x <build number>\WebApps\

  6. Start the Management Console original version. It will start a 11.2.0 Management Console with the old database.

  7. Create a backup to contain all data including the trigger mappings.

  8. Install a new 11.2.0 Management Console with an empty database (without changes to the .war file).

  9. Restore the backup created in Step 7.

Desktop icons not always part of Program Manager tree

1384485: A Robot cannot select icons on the desktop after the Win+D key combination is pressed. The Win+D key combination is a shortcut to hide and show the desktop. Before the keys are pressed, the icons on the desktop are listed under the Program Manager pane. After Win+D is pressed, the icons are hidden, which prevents the Robot from identifying the icon elements to display in the automation tree.

Workaround: If the goal of using Win+D is to minimize all windows and show the desktop, use Win+M instead. This key combination does not hide icons, so they remain available in the automation tree.

Unable to run some robots with remote API

1371327: If a database mapping is created in Management Console > Repository > Databases, a robot cannot be started with the remote API.

Workaround: Create a database mapping in the My Projects view (Shared Databases section) in Design Studio and use it with robots you want to start with the remote API.

Unicode not supported for CyberArk Application ID

1362162: In Password Vault in CyberArk, it is not possible to create a safe or account name in Unicode.

KTA step configuration cleared after change

1359670: When a Robot with the KTA step is opened for editing, the KTA step is marked with an icon to warn that the configuration is unavailable. After an attempt to change any configuration parameter for the process, the step configuration collapses to the KTA Server level. After expanding the step, the previous configuration is discarded and the user needs to reconfigure the step.

TotalAgility and RPA value boundaries do not match

1356285: The following parameter types have mismatching boundaries in RPA and TotalAgility: Currency, Decimal, Double, Float, Long, Short.

SAML not supported for Kapplets

1355484: Authentication with SAML is not supported for Kofax RPA Kapplets.

Windows 7 not supported for virtual keyboard driver

1354870: The virtual keyboard driver required by the Desktop Automation Service is built with User-Mode Driver Framework 2.0 and is only supported on Windows 10, Windows Server 2016, and Windows Server 2019.

RoboServer cannot rerun robots on computer with DAS

1351686: RoboServer cannot run a Robot more than once if it is installed on the same computer as the Desktop Automation Service.

Windows applications cannot run using process name

1343762: Some built-in 32-bit Windows applications cannot be run by using their process name.

Workaround: Use the full path to the application to run it. For example, use c:/windows/sysnative/dfrgui.exe instead of dfrgui.exe.

Large PDF file issue in Kapplets

1337449: A Kapplet with a large PDF file used as a binary input value generates an "Out of memory" error message.

Workaround: Change the "Maximum memory pool" value on the Tomcat server or the max_allowed_packet value in the MySQL my.ini file.

Kapowlock inconsistent behavior

1314402: The kapowlock process used by the Lock Screen and Initiate Session steps may freeze if the target computer is a virtual machine and it has an active session.

Workaround: Verify that no active sessions exist on the target computer or disable the "Use WDDM graphics display driver for Remote Desktop Connections" group policy setting.

Document Transformation .NET version requirement

1313129: The sentiment analysis and named entity extraction features require .NET version 4.7.2 or higher on Windows 2010 and Windows Server 2016.

Workaround: Install the latest .NET version to use these features on Windows 2010 and Windows Server 2016.

Issue with deleting file from Windows mapped share

1312329: When the Robot File System file share is mapped to a Windows drive (as configured in the Desktop Automation Service), the Windows WebDAV client used for the mapping caches information from the file share. On rare occasions, it may cause the mapped Windows drive to have an outdated view of the file share.

Workaround: Turn off the caching in the Windows Registry on the computer where the Desktop Automation Service is running.

  1. In the registry, locate the following key:

    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\MRxDAV\Parameters

  2. Change the value of the following parameters to 0.

    • FileNotFoundCacheLifeTimeInSec

    • FileInformationCacheLifeTimeInSec

  3. Restart the computer.

RPA Administrators cannot assign some roles

1289988: Users belonging to the RPA Administrators group cannot assign the Project Administrator, Developer, or Process Discovery Client roles to user groups in a project.

Characters in localized version of Kofax Analytics for RPA may not display

1281128: Characters in the localized version of Kofax Analytics for RPA may not display correctly if you use MySQL 5.7 or earlier with Insight for data and meta databases.

Workaround: Either upgrade your MySQL server to version 8.0 or later, or make sure the default character set for the server and all its components in MySQL 5.7 is set to UTF-8.

Project with too many types causes error

1263908: If you have a large number of types (180 or more) in a single project in Design Studio, it may cause the StackOverflowError and prevent you from opening and editing your Robot.

Workaround: Do not store too many types in one project.

Missing shortcut for Management Console on Start menu

1218466: The Windows 10 Start menu hides duplicate URL links, so if you have several Management Console installations, only the link to the first installed version is present on the Start menu.

Error occurs while backup is restored

1168320: When restoring a backup containing a file with a backslash in the name, an error about a corrupted file is shown. As the backslash character is not allowed for file names in a file system, the backup fails to be restored. The file with a backslash can be uploaded to the Kofax RPA project using the Repository API that does not prevent such files from uploading.

Workaround: When naming your work objects, such as robots, types, or snippets, do not use a backslash or other characters that may be reserved or have a special meaning in a file system. If you already have a backup containing file names with a backslash, unarchive the backup and then archive it again to work around the issue. For more information, see "Naming policy" in Help for Kofax RPA.

Tab titles are truncated

739186: The maximum length of tab titles in the Robot editor is 32 characters, including spaces and dashes. Titles that exceed the maximum length are truncated automatically.

Workaround: Do not use title names longer than 32 characters.

Expression editors can become unresponsive

695039: Expression editors become unresponsive if zeroes are added after the following characters: dollar sign ($) and the number one (1).

Lock screen and RDP connection features support

The lock screen and RDP connection features are only supported if the Desktop Automation Service runs on the Pro or Enterprise editions of Windows 7 or Windows 10. The Home edition of Windows does not have the remote desktop host and cannot be connected using RDP.

Windows Server 2016: security settings update required

Running the Document Transformation Service on Windows Server 2016 requires the following change to the Windows security settings:

  1. In the IIS AppPool\Kofax RPA Document Transformation Client script, add an entry for the Thin Client IIS application pool user.

  2. Open security settings for C:\Document Transformation\Batch.

  3. Allow all missing permissions for the user, save the changes, and apply the settings.

Display scaling on remote devices can displace selection

If VMware is used for hosting remote devices, text and icon scaling can displace selections in some applications, leading to unexpected behavior in Robots.

Workaround: Change display scaling to 100% on automation devices.