Java Connector (Former)

This Java Connector has been replaced by the Java Native Connector, and is disabled by default. If you enable this Java Connector, the Java Native Connector is disabled.

Enable the Java Connector

The Java Connector is disabled by default. To work with existing projects that use this connector, you must manually enable the connector.

To configure the former Java connector:

  1. Open the configuration file %appdata%/Nice_Systems\AutomationStudio\RTClient.exe.config in a text editor.

  2. Add in the parameter shown in red underline below.

    <screenGeneralConfig Polling_Interval="1100" " UseJavaFormerConnector ="true"  EnableSiebelConnector="true" EnableChromiumNetExtension="true" EnableChromiumWpfExtension="true" EnableDelphiWin32Extension="true" Active_Instance="false" Recognize_All="true" Same_Process="false" Remove_Project_Timeout="10" useBHO="false">
    <FunctionConfiguration>
    <add name="WindowFromPoint" displayName="WindowFromPoint" key="iexplore" />
    <add name="WindowFromPoint" displayName="WindowFromPoint" key="a_csm" />
    <add name="WindowFromPoint" displayName="WindowFromPoint" key="a_csm32" />
    </FunctionConfiguration>
    </screenGeneralConfig>

Connector Features

The built-in Java connector provides the following features:

Configure the Connector

No configuration is required for the Java Connector. This connector is enabled by default.

Capture a Screen Element

The procedure for capturing a screen element from a Java application is the same as for all screen elements. See Capture a Screen Element.

Edit a Screen Element

The Edit Screen Element window opens after capturing a screen element. This screen allows you to customize how the screen element is treated and identified. See Edit a Screen Element.

Information specific to Java application screen elements is provided below.

Element Hierarchy

The element hierarchy for a captured Java application element is as follows:

  • Root branch for the Java Process

    • Windows Form (see Win32 Connector)

      • Java Frame element(s)

        • The Java screen element you captured. (This element might be listed as a sub-element of another element, for example, a Group Box. Multiple levels are possible.)

See View the Element Hierarchy.

Screen Element Types Supported

The screen element type values available differ between levels in the hierarchy.

Type

Screen Element Types

Java Screen Element

  • JSwing General

  • JSwing Edit

  • JSwing Text Area

  • JSwing List Box

  • JSwing Table

  • JSwing Tab

  • JSwing Button

  • JSwing Check Box

  • JSwing Combo

  • JSwing Radio Button

  • JSwing Tree

  • JSwing Menu

  • JSwing EditPane

  • JSwing MDI Frame Container
Java Frame

  • JSwing General

Form

Any of the types from:

Java Process

  • Process

Recognition Properties Supported

The recognition properties available differ between levels in the hierarchy.

Property

Description
My Window Class Name is Provides the name of the class to which the specified Java physical object belongs.
My Window Z Order is

Indicates the window's position in a stack of overlapping windows. This window stack is oriented along an imaginary axis, the z-axis, extending outward from the screen. The window at the top of the z-order overlaps all other windows. The window at the bottom of the z-order is overlapped by all other windows.

When an application creates a window, the system puts it at the top of the z-order for windows of the same type. You can change the z-order by activating a different window. The system positions the active window at the top of the z-order for windows of the same type. When a window comes to the top of z-order, so do its child windows.
My Window Relative Location is

Enables you to identify a window, based on the location of its parent window. The format for this property's value is YYYYXXXX, where YYYY indicates the Y offset and XXXX indicates the X offset (including a leading zero) from the parent window.

For example, the 1110269 value indicates that the window location has an offset of (269,111) from its parent window.
My Window Visibility is

Gets a value that indicates whether the physical object is currently visible or hidden.

When the window is visible the physical object is recognized.

When the window is hidden the physical object is destroyed until the window becomes visible again.
My Window Name is Provides the name of the Java physical object.
My Window Descendant Count Is Counts the number of descendant windows/elements below the Java screen element.

Property

Description
My Process Name is Process name of the process in the process tree.
My Process Level is Process level in the process tree. Useful in a scenario where the application has more than one process on different levels.
My Parent Process Name is not Self property provides the name of the process, which can’t be a parent process (the process one level higher).

Main Relation Type

The element's main relation type is displayed in the Edit Screen Element window, but cannot be changed.

This section is not displayed for the Java process.

See Identify an Element's Main Relation Type.

Multi Instance Support

The Java connector provides support for multiple instances of a JAVA application.

You can specify which instance of the application to relate to if multiple instance of the same application are open.

Multi instance support differs between levels in the hierarchy.

Type

Multi Instance Support
Java Screen Element Optional, inactive by default.

Java Frame Element

Optional, inactive by default.

Java Process

Active by default, cannot be deactivated.

See Set Multi Instance Behavior

Screen Element Assets

Each screen elements has its own properties, functions, and events. These are visible in the Assets Panel.

For information on screen element assets, see here.

Monitor Screen Elements in Debug Mode

When in debug mode, you can view and modify the values of a screen element's properties.

For example, a tab's text can be viewed during debug.

See Monitor Screen Elements in Execution Mode.