Java Automation
Overview
Clicknium Java automation is based on Java Access Bridge to support recording function, locator and all operations on UI elements.
During recording, if you are recording a 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 learn locator concept first. For Java automation, the attributes defination is in the following table:
| Name | equals | contains | startWith | endWith | regex |
|---|---|---|---|---|---|
| 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:
| Name | Description |
|---|---|
| Name | name of the user interface |
| BoundingRectangle | the coordinates of the rectangle that completely encloses the element |
| States | states of elements such as enabled, visible, showing, focusable |
| IndexInParent | the index of current UI element in parent element |
| IsKeyboardFocusable | whether the UI element can accept keyboard focus |
| IsEditable | whether the UI element is editable or not |
| IsOffscreen | whether the UI element is visible on the screen(true when the control is not visible; otherwise false) |
| ProcessId | the process identifier (ID) of this element |