Skip to main content

Java Automation

Overview

Clicknium Java automation is based on Java Access Bridge, supply recording function, generate locator and all operations on one element.
During recording, if you choose Java application, for example some ERP Java client, Clicknium will use Java automation to record the element. You need install Java extension first. Currently, the Java extension is compatible with Java 1.6 or above.

Locator attributes

You can get locator concept first, for Java automation, the attributes defined are as the following:

NameequalscontainsstartWithendWithregex
Name
Yes
Yes
Yes
Yes
Yes
ClassName
Yes
Yes
Yes
Yes
Yes
IsDirectChild
Yes
No
No
No
No
AccessKey
Yes
No
No
No
No
Index
Yes
No
No
No
No

Locator samples

We use one java swing sample application to show locator samples

  • awt component
<Application processName="javaw" filePath="javaw.exe" version="1.3" />
<Java className="frame" isDirectChild="True" name="SwingSet2" />
<Java className="root pane" isDirectChild="True" />
<Java className="layered pane" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="page tab list" isDirectChild="True" />
<Java className="page tab" isDirectChild="True" name="Internal Frames Demo" />
<Java className="panel" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="desktop pane" isDirectChild="True" />
<Java className="internal frame" isDirectChild="True" name="Frame 4 " />
<Java className="AWT component" isDirectChild="True" />
  • menu Themes
<Application processName="javaw" filePath="javaw.exe" version="1.3" />
<Java className="frame" isDirectChild="True" name="SwingSet2" />
<Java className="root pane" isDirectChild="True" />
<Java className="layered pane" isDirectChild="True" />
<Java className="menu bar" isDirectChild="True" name="Swing demo menu bar" />
<Java className="menu" isDirectChild="True" name="Themes" />
  • toggle button
<Application processName="javaw" filePath="javaw.exe" version="1.3" />
<Java className="frame" isDirectChild="True" name="SwingSet2" />
<Java className="root pane" isDirectChild="True" />
<Java className="layered pane" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="tool bar" isDirectChild="True" />
<Java className="toggle button" index="3" isDirectChild="True" />
  • text input
<Application processName="javaw" filePath="javaw.exe" version="1.3" />
<Java className="frame" isDirectChild="True" name="SwingSet2" />
<Java className="root pane" isDirectChild="True" />
<Java className="layered pane" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="page tab list" isDirectChild="True" />
<Java className="page tab" isDirectChild="True" name="Internal Frames Demo" />
<Java className="panel" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="desktop pane" isDirectChild="True" />
<Java className="internal frame" isDirectChild="True" name="Internal Frame Generator" />
<Java className="root pane" isDirectChild="True" />
<Java className="layered pane" isDirectChild="True" />
<Java className="panel" isDirectChild="True" />
<Java className="panel" index="3" isDirectChild="True" />
<Java className="text" isDirectChild="True" />

Java element properties

By find_element on one Java locator, you can get one Java element, you can get properties of the element by get_property, Clicknium Java support the following properties:

NameDescription
Namename of the user interface
BoundingRectanglethe coordinates of the rectangle that completely encloses the element
Statesstates of elements such as enabled, visible, showing, focusable
IndexInParentthe index of current UI element in parent element
IsKeyboardFocusablewhether the UI element can accept keyboard focus
IsEditablewhether the UI element is editable or not
IsOffscreenwhether the UI element is visible on the screen(true when the control is not visible; otherwise false)
ProcessIdthe process identifier (ID) of this element