GUI Field Extractor

This activity allows you to fetch data from a SAP thick client application.

This activity must be used inside an Application activity or the system displays an error.

Using GUI Field Extractor Activity

1.    Make sure that the prerequisites for using SAP Recorder activity is met.

2.    In the Canvas Tools pane, click Process Components to expand the tool and view the associated activities.

3.    Drag the Application activity and drop on to the Flowchart designer area.

 

 

4.    In the Application Type list, select SAPApps. Application type that has at least one application added to it appears in the drop down list.

5.    In the Select An Application list, select the SAP application you want to automate. You can add a SAP application that is already configured in Automation Studio or add a new application at this level.

6.    Double click the Application activity to open the activity container.

7.    In the Canvas Tools pane, click SAP Thick Client to expand the tool and view the associated activities.

8.    Drag the GUI Field Extractor activity and drop in the Application activity.

 

 

9.    Click the (Capture a Field) icon to capture the steps that you want to perform within the SAP application.

 

NOTE:  

·        Launch SAP application before you start using the activity else the Capture a Field icon remains disabled.

·       You must keep the relevant page of SAP application open before capturing the steps.

 

   

 

The SAP Logon pop message appears.

10.  Click OK to close the message box and to configure the field.

 

 

The SAP application appears. The area where the cursor is present gets highlighted within red box.

11.  Move the cursor to the area you want to capture and then click.

12.  In the GUI Field Extractor activity, click the (Settings) icon. The Field Properties panel appears. The fields that are mandatory to be filled are highlighted with red box.

 

 

13.  Enter details of all the mandatory fields and other relevant fields as per your requirement.

14.  Close the panel to save the details entered.

The fields are configured and the GUI Field Extractor activity is created.

 

NOTE:  

A single GUI Field Extractor activity captures a single field of a SAP application. You need to use multiple GUI Field Extractor activities to capture multiple field of a SAP application

GUI Control Behavior Field Properties

The properties of Control Behavior of GUI Field Extractor are listed in the following table and can be edited in the Control Behavior pane.


Property Name

Usage

Control Behavior

Action

Actions that can be performed on a web based application. Available options are:

·       Control Exists- Checks availability of the UI element on a SAP window.

·       Extract Value- Extracts the value of the selected area.

·       Extract Cell Value- Extracts the value of the selected cell.

·       Get Row Count- Provides the total count of the row.

·       Get Node Text- Provides the text value of the node.

Interaction

The corresponding interaction set against the selected action.

Field Properties

Variable Name

User defined name of the variable that stores the captured value.

Data Type

The type of the data captured.

Is CView

Is applicable only for AssistEdge Engage. Appears if Action selected is Control Exists.

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

Identify

Control Id

Identifier of the UI element. It is useful for locating elements that has a unique id associated with it.

Control Type

Type of the UI element selected.

 

GUI Field Extractor Properties

The properties of GUI Field Extractor activity are listed in the following table and can be edited in the Property 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 SAP Field Extractor. You can change the name as required.

SessionId

A numeric property to indicate which session id of the SAP is used to perform the action. It is used in case of multiple session scenarios of SAP. For example, when a new session is opened on some action in first SAP session.

Default value is set to 0.

On This Page Hide

   

   Related Topics

Step-By-Step Guide to Use GUI Field Extractor to Extract Name of the Purchasing Organization