Java Applications

This activity allows you to automate the actions performed on the Java application such as testing Java applications or performing operations on the UI.

The supported files types are - JAR, JNLP (Java Network Launch Protocol) and Java  Applet.

Prerequisites

  • Install Java (JDK, v ) on the system where the automation process workflow needs to be created and where the automation would run.
  • Configure the required Java application in  Automation Studio where you want to perform the automation. Below are the minimum required properties for configuring the intended Java application. If you want to define remaining properties, refer JavaApps section. To configure Java application with minimum required properties:
  1. In the Admin menu, add an application of Application Type - JavaApps.

 

 

  1. Browse and select the required .jar file.
  2. In the Application Properties panel:
    • Enter the URL of the JNLP file/applet in the JarFilePath/URL field.
    • Enter the time out duration of the application launch in the Launch Time Out (in secs) field, if the JavaAppType is JNLP Applications or Applet.
  3. In the Environment Type list, select the type of environment of the added Java application.
  4. Click the  (Save Properties) icon to save the application.
    The Java application is configured.

Using Java Application Activity

  1. In the Canvas Tools pane, click Process Components to expand the tool and view the associated activities.
  2. Drag the Application activity and drop on to the Flowchart designer on the Canvas area. The validation error symbol disappears when required inputs are provided in the correct format.

 

 

  1. From the Application Type list, select JavaApps. You must have at least one application added for it to appears in the list.
  2. In the Select An Application list, select the configured Java application that you want to automate. Alternatively, you can add a new Java application at this point of time. To add a Java application:
    1. In the Select An Application list, click Add New Application. The Add New Application dialog box appears.

       

  3. In the Application Type field, select the required application type of the Java application you want to configure in Automation Studio. Available options are:
    • JavaApps
    • JavaApps - JNLP
    •  JavaApps - Applet
  4. In the ApplicationName field, enter a desired name of the Java application.
  5. If JavaApps is selected, enter the file path along with the file name and extension of the required JAR file in the JarFilePath field.
  6. If JavaApps - JNLP is selected, enter the URL of the JNLP file in the URL field.
    1. Enter the time out duration of the application launch of the JNLP file in the Launch Time Out(in secs) field.
    2. Enter the window title of the JNLP window in the Launch Window Caption field.
  7. If JavaApps - Applet is selected, enter the URL of the Java applet in the URL field.
    • Enter the time out duration of the application launch of the Java applet in the Launch Time Out(in secs) field.
  8. In the Environment Type list, select the type of environment of the Java application. Available options are:
    • EVENT_BASED
    • WINDOW_CLASS_BASED
  9. Click SAVE. The web application is added.
  10. Click the (Settings) icon to launch the Java MODE interface. The configured Java application appears along with Java MODE interface.

 

 

  1. Click the (Play) button to capture the steps that you want to perform within the Java application. The Play button changes to the (Recording) button.
  2. Hover over the field that you want to capture. The field gets highlighted with the blue box.

 

 

  1. Click the highlighted area. The Field Properties panel of the Java MODE appears. The fields that are mandatory are highlighted with red box.

 

 

  1. In the Action list, select the action that you want to perform on the captured area. Other mandatory fields change depending on your selection from the drop down list. Enter the required details. Refer Field Properties table to know more about the available fields and their respective properties.
  2. Click the  (Save) icon to configure the fields.
  3. Repeat steps 13 through 17 to capture all the steps involved in the process. The configured field is saved and starts appearing in the Saved pane of the Field Properties panel. You can edit or delete these steps in the Saved pane, if required.
  4. Click the  (Save configured field and return to studio) icon to save the field that you configured and return to the Studio menu.
    The fields are configured and the Application activity for Application Type- JavaApps is created.

Java Mode Control Behavior and Field Descriptions

The properties of the JAVA MODE are listed in the following table:

 

Property Name

Usage

Control Behavior

Search Path

 

Interaction Behavior

Action

It is the action or the interaction that can be performed on a Java application depending on the type of UI element as per the requirement. Available options are:

  • Set Text - Sets the user provided value of the UI element attribute and stores it as the value of the parameter. You must define the parameter in the Parameter bar before you start capturing the element.
  • Dock Window -
  • Click - Allows to left click the selected UI element.
  • Set Key Event Text -  Sets the user provided value of the keystroke event that occurred in the selected UI element attribute and stores it as the value of the parameter selected in the Text field. You must define the parameter in the Parameter bar before you start capturing the element. Alternatively, select the Is Default Value checkbox to set a default value of the keystroke event.
  • Get Text - Extracts the current value of the selected UI element such as, value of an input field , text box or the selected area.
  • Get Table Cell Value - Extracts the cell value from a table available in the Java application by indicating the row and column of the required cell.
  • Get Table Data - Extracts the table data in sting format with column and row details.
  • Get Table Selected Rows - Extracts the value from a table selected row available in the Java application.
  • Perform Table Click - Clicks the area on the table as per the specified row and column number.
  • Perform Table DoubleClick - Double clicks the area on the table as per the specified row and column number.
  • Perform Table Row Selection -
  • Get Tree Data - Extracts the data from the specified tree data structure in the XML format.
  • Get Tree Selection Paths - Extracts path of the selected node in the tree data structure.
  • Perform Tree Click - Clicks the tree data structure as per the selection path of a node.
  • Perform Tree DoubleClick - Double clicks the tree data structure as per the selection path of a node.
  • Perform Popup Click On JTree - Clicks the pop menu item.
  • Perform TabbedPane Select - Clicks the pane as per the specified pane title of the Java application.
  • Perform ComboBox Select Value - Selects the value for a combo box as per the specified name.
  • Perform ComboBox Select ValueAt - Selects the value for a combo box as per the specified index.
  • Perform Menu Item Click - Click the menu item as per the specified main menu and the sub menu.
  • Get RadioButton Status - Specifies if the radio button is checked or not.
  • Get RadioButton Text - Extracts the text of the radio button.
  • Select ListItem - Selects the list item as per the specified indices.
  • Is Exists - Checks if the UI element exists at the specified area. It returns a boolean value and is useful when working with dynamics controls.
  • Is Enabled - Checks if the UI element is enabled. It returns a boolean value.
  • Is Visible - Checks if the UI element is visible. It returns a boolean value.
  • Is Focused - Checks if the UI element is in focus. It returns a boolean value.
  • Request Focus - Sets the UI element into focus.
  • Insert JText Comp Text - Sets the user proved string value into the JText component as per the specified offset.
  • Button Enter - Performs the return action of the keybaord on the specified UI element
  • GridRowRobotEnter - Performs the return action of the keyboard.
  • CheckBox Click - Clicks the specified checkbox.
  • Perform Click  at Offset - Clicks at the specified X and Y coordinates.
  • Set Table Cell Value - Sets value in a field as per specified row and column number.
  • Select Radio Button - Selects the desired radio-button element from the given group.
  • Click Checkbox Action - Checks or un-checks the desired check-box element.
  • PopUp Click - Click the UI element which opens a pop-up menu.
  • Enter Click -

 

Interaction

The corresponding interaction set against the selected action.

Appears if Action selected is Set Text, Set Key event Text, Insert JTextComp Text, Set Table Cell Value, Select Radio Button

Text

Allows user input as a text.  You can select the parameter holding the required value defined in the Parameter bar. Alternatively, select the Is Default Value check box and specify the required text in the Text field to set the value as the default value.

Appears if the Action selected is Insert JTextComp Text.

Offset

The distance between the target item and the anchor.

Appears if Action selected is Get Table Cell Value, Set Table Cell Value.

Column Number

The column number that contains the required cell from the table.

Row Number

The row number that contains the required cell from the table.

Dock Window

This section appears only when Action selected is Dock.

Dock Action

When a link or button on the web page is opened in a new browser window, the Dock Action button enables the new window listed in the multimodal UI. You can select one of the windows in the multimodal UI to configure controls on the intended window.

Appears if Action selected is Click, Perform ComboBox Select Value or Perform ComboBox Select ValueAt, CheckBox Click

BlockingCall

Indicates that the current thread is blocked until the operation is executed. If it is not handled it can the application or the system itself.

Value

Allows user input of the value of the combo box set.  You can select the parameter holding the required value defined in the Parameter bar. Alternatively, select the Is Default Value check box and specify the required value in the Value field to set the value as the default value.

Appears if Action selected is Perform Menu Item Click.

Main Menu

The main menu where the required item needs to be clicked.

Sub Menu

The sub menu where the required item needs to be clicked.

Appears if the Action selected is Select ListItem.

ItemIndices

Index number of the selected item of the list.

Appears if the Action selected is Perform Click At Offset.

X Offset

Vertical offset on the Java application. The value must be entered in pixels.

Y Offset

Horizontal offset on the Java application. The value must be entered in pixels.

Appears if the Action selected is Click CheckBox Action.

Field Properties

Display Name

User specified display name of the action configured.

Appears if Action selected is Get Text, Get Table Cell Value, Get RadioButton Status. Get RadioButton Text, Get CheckBox Status. Get CheckBox Text, Is Exists, Is Enabled, Is Visible, Is Focused,

Is C-View

Is applicable only for AssistEdge Engage.

If selected, the field configuration captured in Automation Studio is visible in the Engage C-View tab.

Variable Name

User defined name of the variable that stores the captured value. You can define the variable name here itself or predefine it in the Parameter bar.

Variable Type

Type of the variable defined. Available options are:

  • Text - A sequence of character, either as a constant or a variable.
  • Numeric - An integer type that range from negative through positive.
  • Decimal - An exact numeric value defined by its precision and scale.
  • Boolean - A data type used for making decision. Can have only two values- true or false.
  • Data Table - A data type that stores tabular data.

  

Java Application Properties

The properties of a web application are listed in the following table and can be edited in the Properties grid on the right pane.

 

Property Name

Usage

Control Execution

Ignore Error

When this option is set to Yes, the application ignores any error while executing the activity.

If set to NA, it bypasses the exception (if any) to let the automation flow continue; however, it marks the automation status as failure, in case of an exception.

By default, this option is set to No.

Delay

Wait After

Specify the time delay that must occur after the activity is executed. The value must be in milliseconds.

Wait Before

Specify the time delay that must occur before the activity is executed. The value must be in milliseconds.

Misc

Breakpoint

Select this option to mark this activity as the pause point while debugging the process. At this point, the process freezes during execution allowing you to examine if the process is functioning as expected.

In large or complex processes, breakpoints help in identifying the error, if any.

Commented

Select this option to mark this activity as inactive in the entire process. When an activity is commented, it is ignored during the process execution.

DisplayName

The display name of the activity in the flowchart designer. By default, the name is set as the name of the selected application. You can change the name as required.