Known issues

This section describes known issues when working with UFT Developer.

UFT Developer inherits its capabilities from UFT One and is affected by UFT One's known issues as well. For details, see Known issues in the UFT One Help Center.

IDE Plugins

General

  • When using the Highlight option in the application model for a test object with VRI objects defined, the highlight operation succeeds only if exactly one object matches the description (including the VRI definitions). If multiple objects match, nothing is highlighted.

    Workaround: Use the VRI Preview option to check the description.

  • When working with Java 9, application model features in the IDE plugins are not supported.

Mac OS

When working on Mac, make sure that you open any IDEs supported by UFT Developer at least once before installing UFT Developer. Otherwise, the UFT Developer installation adversely affects the IDE's installation and you can no longer open the IDE.

To repair a damaged IDE installation, run the following command: 

xattr -d com.apple.quarantine <Path to IDE application>

Eclipse on Linux

UFT Developer 23.4 or later: To work with application models in Eclipse on Linux, you must start Eclipse as a root user.

Eclipse 2021

An error occurs when working with application models in Eclipse 2021.

Cause: Incompatibility of some legacy UFT Developer files with the Java 16 JRE used in Eclipse.

Workaround: Add the following line to your eclipse.ini configuration file:

--illegal-access=permit

Eclipse 2022-09

UFT Developer 2023: You cannot create, open, or close an application model in Eclipse 2022-09.

Eclipse-based IDEs

When working with the following environments, application model features are not supported:

  • Ubuntu with OpenJDK 9 or later

  • Fedora with OpenJDK 8 or later

Eclipse Kepler/Luna users

To use the Eclipse IDE for Java EE Developers or Eclipse Standard editions with the UFT Developer plugin, you must deploy the Google Gson plugin to your Eclipse folder:

  1. Download the Google Gson plugin, version 2.1 or later, from the MVN Repository.

  2. Copy the downloaded .jar file to your <Eclipse deployment>\plugins folder and reopen Eclipse.
Visual Studio

Web-based AUTs

If your IDE is in front of your browser when you click the Highlight option from the Application Model editor or from the Object Identification Center, the Highlight rectangle appears, but sometimes the IDE window stays in focus and may block the object.

Workaround: Arrange your screen so that the IDE does not block your application.

Visual Studio 2022

The plugin for Visual Studio 2022 is not included in the UFT One 2023 installation packages.

Workaround

If you installed UFT Developer from the UFT One installation package, follow these steps to add the plugin for Visual Studio 2022:

Download the UFT Developer installation package, as described in Prepare for installation.

Copy the following file from the package: IDE\VisualStudio\ExtensionAsync\HP.LFT.PackageVsix.Async.2022.vsix

Place the file on the computer where UFT Developer is installed.

Double-click the vsix file and follow the on-screen instructions to install the UFT Developer plugin on Visual Studio 2022.

IntelliJ IDEA
  • When moving an application model's .tsrx file to a different module/location while viewing it in the Editor's Design tab, the view changes to the Text tab.

  • IntelliJ 2020.2 or later suggests that you delete certain environment variables. Make sure not to delete the following variables: _JAVA_OPTIONS, JDK_JAVA_OPTIONS, and JAVA_TOOL_OPTIONS. These are installed by UFT Developer and are required for testing Java applications.

  • When creating or working with Application Models in IntelliJ IDEA 2022, you may encounter an error about user data not being supported.

    You can ignore this error, the functionality is not affected.

Changing the plugin installation on Linux or Mac

Use the Add/Remove Features option of the UFT Developer setup program to install or remove the UFT Developer plugin from your IDEs.

If you make any changes to the plugin or IDE installation in other ways, keep the following in mind: 

The Add/Remove Features option assumes that the currently installed features are the ones last installed by the installer. If you made any manual changes in the plugin installation, the next time you use the Add/Remove Features option, you will not achieve the expected results.

For example, after manually removing the plugin, uninstalling the IDE, or moving it to another location, attempting to reinstall the plugin using the Add/Remove Features option does not install it. This is because the setup program assumes the plugin is still installed.

To fix this situation, first, run the installer as if to remove the plugins that are no longer there.

Then you can reinstall the plugin using the setup program's Add/Remove Features option.

Back to top

Parallel test execution

  • Parallel test execution is not supported on Internet Explorer and Edge Legacy browsers.
  • The WebElement.dragAndDropOn method is not supported in parallel test execution.
  • If you run AI-based tests in parallel, we recommend not including AIRunSettings steps. Any settings you change affect all tests running in the same parallel run session, and may cause unexpected results.

Back to top

UFT Developer Grid

  • When running tests in grid mode, using VRI for object identification is supported only for web applications.
  • AGGrid and UIGrid objects are not supported when running tests on a Linux or Mac UFT Developer Grid node.

  • Nodes that connect to the same grid must have unique names. If multiple nodes with the same name connect to the grid, only the last node to connect will be available.

Back to top

Test recorder

  • You cannot use the test recorder to record an action on a Web.FileField. Add this code manually to your test script.
  • The Browser.closeAllTabs action does not work as expected on Firefox during a test recording. Add this code manually to your test script.
  • You cannot use the test recorder to record test steps on applications in Safari.

Back to top

Verifications

In some cases, a verification step on a multi-line text fails, though the expected and actual texts displayed in the report are identical.

Possible cause: The technology on which you are running the test requires a \r for line breaks.

Solution: Try adding a \r before each \n in the expected text in your step and try again.

Back to top

Run result reports

  • When you specify the report's location in the ReportConfiguration object, the folder name can contain only utf-8 characters.

  • When working in Java based IDEs (IntelliJ, Eclipse, Android Studio), the UFT Developer > View Last Run Results is sometimes unexpectedly disabled, or it opens the wrong project's report.

    Workaround: Open the UFT Developer HTML Report manually from your project's location in the file system.

Back to top

PDF run result reports

  • To export run results to a PDF report, the run results folder must contain the runresults.json file. If you renamed this file for any reason, make sure to change the file name back before exporting the results to a PDF report.

  • If your run results include snapshots for each step, these are not exported to the PDF report.

  • When the run result descriptions are complex and include nested tables, some of the descriptions are not included in the PDF report.

  • You can export run results to a PDF report only on the same type of operating system that generated the results.

  • Some non-English characters are not supported, and are not displayed correctly in the generated PDF report.

Back to top

Text recognition - OCR methods

  • Text recognition depends on font and image quality, as well as spacing and resolution. In some cases, text is not recognized as you would expect.

  • UFT Developer 2021 R1 and later: To use OCR methods, the ABBYY OCR engine has to be included in the UFT Developer installation.

  • UFT Developer 23.4 or later: UFT Developer 23.4 introduced some text recognition enhancements that might affect the behavior of tests written with previous versions of UFT Developer:

    • UFT Developer now uses an updated version of the ABBYY OCR engine, enhancing its text recognition ability. Therefore, the results of the GetTextLocation or GetVisibleText methods are now more accurate.
    • AI-based text recognition now ignores text identified in unexpected areas or controls, and breaks up text strings based on the borders of identified UI controls. If your tests require restoring the previous behavior, contact support for assistance.

Back to top

AI-based testing

  • If you installed UFT Developer on a computer that does not meet the AI installation requirements, some AI features are still visible but are not supported. For requirements, see installation guide.

  • You can change AI settings during a run, using the AiRunSettings class in the SDK.

    Changes you make during the run affect all tests running in the same runtime session. These may be tests running in parallel or sequentially in the same runtime session.

  • The following AI Object operations (introduced in UFT Developer 23.4) are not supported on mobile applications: RightClick, DoubleClick, LongClick, SetText and Hover.

  • UFT Developer 2021: When working with iOS mobile applications, the following is not supported: 

    • Running steps that include text input from the AI Inspection window.

    • Recording steps that include text input.

Back to top

Technologies - general

  • When using the getSnapshot method, you can save the snapshot as a .png file only.
  • On Windows 10, if you have only the German language pack installed, the Keyboard.sendString method sends some special characters incorrectly.

    Workaround: Install the English language package in addition to the German one.

Back to top

Web technology

This section describes known issues when working with UFT Developer on various web browsers.

Chrome and Edge Chromium

  • The FireEvent OnBlur event is not supported.
  • If a browser is open and has an alert message box displayed prior to the start of a UFT Developer test run, you must manually close the message box before starting the run.
  • Using the Forward method when the current browser page is about:blank throws an exception and fails the test.

    Workaround: when on an about:blank page use the Navigate method instead of the Forward method.

  • Sometimes, after a browser page loads, operations on the page fail. For example a WebTable.SelectCell method may fail to select the cell.

    Possible cause: The site continues to load data after the page is loaded, and the operation performed requires an object that is not ready.

    Workaround: Instead of opening the browser using BrowserFactory, open the browser using a system process and attach it using BrowserFactory.

    For example: 

    new ProcessBuilder("C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe","<MyURL>").start();
    Browser browser = BrowserFactory.attach(new BrowserDescription.Builder().title("<URL Title>").type(BrowserType.<TypeOfBrowser>).build());

IE mode on Edge Chromium

Supported in UFT Developer 2021 R1 and later:

In your test, you must add a Sync or Thread.sleep() step, after launching the browser using the Edge Chromium type and navigating to the application's URL. This extra time is required for your web page to be fully loaded in IE mode before trying to run test steps on it.

Headless Chrome

  • If you run a UFT Developer test on Headless Chrome on a Mac, make sure that your test closes the browser by the end of the run. Otherwise, you cannot open Chrome again until you manually kill the Headless Chrome process.

  • SAPUI5-based applications are not supported on headless Chrome.

  • Menu, TabStrip, and TreeView objects are not supported.

  • Cross-domain iFrame objects are not supported.

  • The following operations are not supported:

    • Drag-and-drop operations

    • Browser Dialog operations: HandleDialog, HasDialog, GetDialogText

    • ImageUtils operations

    • Browser.ClearCache

    • BrowserFactory.GetAllOpenBrowsers

    • WebFile.Set()

    • VRI

  • BrowserFactory.Attach. You can attach only to the first tab for each browser. You cannot attach to a tab opened from the web page or by an Open New Tab command.

Internet Explorer

  • When using Internet Explorer 11 on a computer with UAC enabled:

    If a step in the test navigates from a protected-mode zone to a non-protected-mode zone, the navigation step succeeds, but any subsequent step fails.

    Workaround: Reattach to the browser by calling BrowserFactory.Attach and then continuing with the browser that is returned.

  • When running tests in parallel on Internet Explorer 11, snapshots for controls received by the findChildren method do not appear in the run results report.
  • When recording on Internet Explorer on a computer with UAC enabled, whenever you navigate from a protected-mode zone to a non-protected-mode zone, an additional browser-launch step is recorded.

Edge Legacy

  • UFT Developer can work with Microsoft Edge Legacy browser only when launched with the Edge Agent for Functional Testing.
  • For UFT Developer to work with the Edge Legacy browser, UAC must be enabled.

  • UFT Developer has changed the way that the Microsoft WebDriver program (required for the Edge Agent for Functional Testing) is used. For details on the required steps to perform, see the Set up Microsoft Edge Legacy for UFT Developer (Windows only).

Multiple instances

You cannot open more than one instance of the Edge browser. This includes multiple BrowserFactory.Launch methods without closing the previous instances, or other methods that create a new browser instance such as Browser.OpenNewTab

Frame or iFrame objects

You cannot spy on or run steps on Frame or iFrame objects, or any elements inside these objects, using Microsoft Edge.

Unsupported methods

The following methods are not supported in Microsoft Edge:

  • FullScreen()

  • DeleteCookies()

  • File.SetValue()

PhantomJS

Menu, TabStrip, and TreeView objects are not supported.

The following operations are not supported:

  • Drag-and-drop operations
  • Browser Dialog operations: HandleDialog, HasDialog, GetDialogText
  • WebFile.Set() operation
  • ImageUtils operations
  • VRI

Safari

Functionality and Settings

  • Web pages that modify the browser's JavaScript functionality (for example, a web page that replaces the JSON object) may cause UFT Developer to behave unexpectedly.

  • The font and color properties for link objects contain different values in different browsers.

  • If you have multiple Safari users defined, you must delete all users.

  • When using the OIC, the multi-object spy mode is not supported on Safari.

  • Safari does not work on Mac using a remote access window.
  • You cannot use the test recorder to record test steps on applications in Safari.

Test Objects, Methods and Properties

  • When using Safari, the innertext, outertext, innerhtml and outerhtml property values may differ from other browsers. Therefore, using these values in parameters may cause the steps to fail.

  • The following test objects, methods, and other Web-specific functionalities are not supported in Safari:

    • ViewLink test object

    • about://* pages

    • Browser.Home method

    • Browser.FullScreen method

    • Browser.Object method

    • Modal or modaless dialog boxes
    • Developer Tools pane. (Running steps or Safari while the Developer Tools pane is open is supported.)
    • Dialog boxes opened by the browser, such as Alert, Confirmation, or Prompt messages.

    • WebXML test object (and, accordingly, XML checkpoints and output value steps).

    • Web-based environments, such as Web-based SAP, Siebel, Java, or .NET Web Forms.

Other

  • Web 2.0 test objects or Web Add-in Extensibility-based test objects are not supported on Safari

  • The following test objects and test object methods are not supported when running on Safari:

    • WebFile.Set method

    • Browser.ClearCache method

    • Browser.DeleteCookies method

    • Drag & Drop methods (on all Web test objects)

    • Web test objects located inside iFrame controls with a blank or about:blank SRC value.

  • During a run session, steps that click on a Web object that is supposed to open a new browser tab fail to open the new tab.

    Workaround: Disable the popup blocker in Safari. (Safari > Preferences > Security, clear the Block pop-up windows check box).

  • In certain configurations, the Object Identification Center and test runs do not work properly on the first browser tab that is opened.

    Workaround: Select the Auto Proxy Discovery protocol in your network settings:

Firefox

You may want to remove unused OpenText UFT Agent extensions from Firefox manually:

  • The Firefox extension is not removed after you uninstall UFT Developer.

  • The old extension is kept in Firefox after you upgrade UFT Developer and a new extension is installed.

UFT Developer 2023 and earlier: The extension is named Micro Focus UFT Agent.

Attributes property (C#) or getAttributes property (Java)

In some cases, the Attributes collection returned by Attributes property (C#) or getAttributes (Java) may be different between Internet Explorer and other browsers such as Chrome or Firefox.

Navigating to a new page

If you perform a step that navigates to a new page immediately followed by an image capture operation such as OCR operations, image verifications or comparisons (VerifyImageMatch, VerifyImageExists, CompareImage, LocateImage) or the GetSnapshot method, the step may fail.

Workaround: Add a browser.Sync() step before your image capture operation.

SAPUI5

If the SAPUI5 add-in is loaded (selected in Settings > Engine tab ), UFT Developer cannot recognize Web TreeView, Menu, or TabStrip test object types.

Back to top

Java technology

Working with JavaFX in Java 11

To use UFT Developer with JavaFX applications in Java 11, perform the following steps on the computer running your application:

  1. Download the JavaFX module and store it locally.

    Caution: Make sure the path to the JavaFX module does not contain any spaces.

  2. Set the following environment variables.

    • PATH_TO_FX = <JavaFX module location>\lib.

    • In PATH, add %PATH_TO_FX%.

    • JDK_JAVA_OPTIONS = --module-path %PATH_TO_FX% --add-modules=javafx.controls,javafx.fxml,javafx.base,javafx.swing,javafx.media --add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED --add-opens javafx.base/com.sun.javafx.event=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED --add-opens javafx.base/javafx.event=ALL-UNNAMED --add-opens javafx.graphics/javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/javafx.scene=ALL-UNNAMED

Working with JavaFX in Java 12 or later

To use UFT Developer with JavaFX applications in Java 12 or later, perform the following steps on the computer running your application:

  1. Download the JavaFX module and store it locally.

    Caution: Make sure the path to the JavaFX module does not contain any spaces.

  2. Set the following environment variables.

    • PATH_TO_FX = <JavaFX module location>\lib.

    • In PATH, add %PATH_TO_FX%.

  3. We recommend not running a command line window and your application at the same time. Therefore, launch the application from a batch file instead of using a command line that specifies the module path and dependencies:

    In the folder containing your application's .jar file, create a .bat file containing the following command: 

    start javaw --module-path="%PATH_TO_FX%" --add-modules={all modules required by your application} --add-opens {specify opens for modules if required} -jar <Application_Name>.jar

    Example:

    start javaw --module-path="%PATH_TO_FX%" --add-modules=javafx.controls,javafx.fxml,javafx.base,javafx.swing,javafx.media --add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED --add-opens javafx.base/com.sun.javafx.event=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED --add-opens javafx.base/javafx.event=ALL-UNNAMED --add-opens javafx.graphics/javafx.stage=ALL-UNNAMED --add-opens javafx.graphics/javafx.scene=ALL-UNNAMED -jar JavaFX.jar

    Save the .bat file and run it.

Installing Java on a Windows machine with UFT Developer

When re-installing or upgrading the JRE on a Windows machine with UFT Developer installed, you might encounter error 1603 preventing the JRE installation to complete.

This can be caused by an interference between the UFT Developer Java environment variables and the Java installer.

To successfully complete the installation, rename the UFT Developer Java environment variables, perform the JRE installation and restore the variable names.

To temporarily rename the UFT Developer Java environment variables: 

  1. On your Windows Desktop, right-click My Computer or This PC and select Properties.

  2. Select the Advanced tab.

  3. Click the Environment Variables... button.

  4. Look for the following environment variables both under the user variable list and the system variables list and edit their names:

    • _JAVA_OPTIONS

    • Java_Tool_Options

    • IBM_Java_Options

  5. Install the JRE.

  6. Once the installation is completed, change the environment variables names back to their original names.

Java 9

When working on Mac versions Sierra or later, the UFT Developer tray icon is not displayed. To start and stop the UFT Developer runtime engine and to open the Settings dialog box, use command line scripts as described in the relevant topics. For details, see Customize UFT Developer runtime engine settings and Start/Stop the runtime engine.

Back to top

.NET Windows Forms and WPF technologies

Windows Forms support

UFT Developer 2023 and later:

.NET 5 and 6 are supported as a Technical Preview.

Some objects supported in earlier .NET versions, such as PropertyGrid, ToolBar, Table, and StatusBar, will not be identified in these new versions.

To support these test objects, you can try using UIA Pro.

WPF ComboBox / WPF List test object

You cannot use the following to create the test object descriptions of WPF ComboBox or WPF List test objects:

  • C# properties: Items, SelectedItem, or SelectedItems
  • Java methods: getItems, getSelectedItem, getSelectedItems
WinForms Button test object

UFT Developer cannot identify a WinForms Button test object if WindowId is the only property in its test object description.

WinForms Edit object

Before performing a Select operation on a WinFormsEdit object, you must first perform a Click operation on it.

Back to top

Oracle technology

For UFT Developer to recognize Oracle application objects, you must install and load both the Oracle Add-in and the Web Add-in.

Back to top

Standard Windows technology

  • The ListViewItem.EnableLabelEditing method works only if it is preceded by an ActivateItem step.
  • In some cases, the application you are testing may have an integrity level higher than the UFT Developer test run. In such cases, run your test with Administrator privileges and/or open the UFT Developer runtime engine in Administrator mode.

Back to top

SAPUI5 technology

  • When spying on an SAPUI5 list box, the Object Identification Center (OIC) displays the control type as Unknown.

  • AgGrid and UIGrid objects are not supported in CEF and Headless Chrome.

Back to top

Terminal Emulator technology

  • The GetVisibleText()method from TestObjectBase does not work as expected for Terminal Emulator technology because of the third party library for text recognition (OCR) used by UFT Developer. This issue is known for other technologies as well.
  • SendKeys(Keys.ENTER) is not supported for TeTextScreen. To send the Enter key, use the Keyboard class. For details, see Send keystrokes to the AUT.

  • SetCursorPos and the properties current row and current column are not supported for TeTextScreen.

  • When highlighting Terminal Emulator test objects on IBM Host On-Demand or IBM i Access-Client Solutions, the highlighted location for some objects might be shifted.

    Workaround: Configure the text area and text screen settings in the Terminal Emulator Configuration Wizard. Run <UFT Developer Installation>\bin\TeConfigWiz.exe to open the wizard, and then proceed to the Configure Emulator Screen Settings page. For details, see Configure Emulator Screen Settings Page, in the UFT One Help Center.

Back to top

Testing mobile applications

General issues

  • When a property with an empty value is used in a test object description, the test object is not identified in the Object Identification Center, nor in the test during the test execution.

  • Validate on iOS devices only works if the test object properties used for validation do not include MobileCenterIndex or Container.

  • When opening several tabs in a browser on a mobile device, only the first tab opened is recognized by the UFT Developer engine.

  • When running a Web test on a mobile device, if a modal dialog box displays on the browser, the test pauses and eventually times out without completing.

  • Mobile Center supports identifying an object by its parents only if the parent is part of the object description. This means that if the parent is not recommended as an identification property, you cannot add the parent property to help identify the object.

  • Radio button controls that are not defined as part of a radio button group are not supported in UFT Developer.

  • Testing on the SAP Fiori native browser is currently not supported when parallel test execution is enabled (default) in UFT Developer.

    Workaround: If you want to run tests on the SAP Fiori native browser, disable parallel testing on mobile devices.

    To disable parallel testing on mobile devices:

    1. In a text editor, open a new file.

    2. Copy and paste the following code:

      {
        "labManager" : {
            "useLocalLabManager": true,
            "environments": ["web"],
         }
      }
      
    3. Save the file as config.json in the <UFT Developer Installation>\lwe\lightweight-engine\config\ folder.

User interface issues

  • On Windows, when selecting a device using the Digital Lab (UFT Mobile) dialog box, the device is not released when the dialog box is closed.

    Workaround: To release the device, you must manually restart the UFT Developer runtime engine.

  • When connected to an iOS device, you cannot use the Object Identification Center to spy on a Mobile TabStrip object.

    Workaround: Create the object description or application model test object manually. See the UFT Developer SDK Reference for a list of available identification properties.

  • The Object Identification Center (spying objects) is not supported when emulating a device using Google Chrome's Device Mode.

  • When using the Object Identification Center to spy objects on Chrome or Safari browsers, if more than one tab is open on the browser, you can only spy the latest tab opened (the one on top).

  • When using the Object Identification Center for spying objects, unable to identify calendar and list in unpackaged applications.

Test object and method issues

  • Insight is not supported for the Application interface.

  • The Web.Frame object is not supported in Mobile browsers.

  • The following methods are not supported on iOS devices:

    Label.Tap() Stepper.Up()
    Label.LongPress() Stepper.Down()
    Pager.Set() TabStrip.Select()
    RadioGroup.Select() Table.Tap()
    Slider.SetPosition()
  • Device.SimulateIncomingSMS() and SimulateIncomingCall() are not supported.

  • Calling Mobile.EditField.getText for password fields, returns "encrypted text" instead of the actual value.

Back to top