SAP UI

SAP UI node is used to automate SAP applications.

Pre-condition:

Enable GUI scripting in the SAP Logon application.
Create modules and familiarize the SAP Logon application using UI Learn.
Define the SAP Execution Execution Configuration in Jiffy.

1.1 Enabling GUI scripting:

Client
Server

1.1.1 Client Side:

Open the SAP Logon application.
In the Connections folder, double click on the connection required.
Click on the highlighted icon and choose Options.
In the Accessibility and Scripting drop-down, select Scripting.
In the User Settings section, check the Enable Scripting checkbox.

Note: Make sure that the rest of the checkboxes are unchecked to avoid prompts when Jiffy connects to SAP.
Click on the OK button to save.

1.1.2 Server Side:

Log in to the SAP server.
In the Connections folder, double click on the connection required and type the client, username and password..
In the T_CODE bar, enter the transaction code RZ11 and press the Enter key on the keyboard.

Note: Contact the administrator in case there is no authorization to do this.
Specify the Parametername as sapgui/user_scripting.
Click on the Display button.
In the Current Value of Parameter sapgui/user_scripting section, if the value of the Current Value field is FALSE, change it to TRUE.
Click on the Save button.
Specify the Parametername as sapgui/user_scripting.
Click on the Display button.
In the Current Value of Parameter sapgui/user_scripting section, if the value of the Current Value field is FALSE, change it to TRUE.
Click on the Save button.
Specify the Parametername as sapgui/user_scripting_set_readonly.
Click on the Display button.
In the Current Value of Parameter sapgui/user_scripting_set_readonly section, if the value of the Current Value field is FALSE, change it to TRUE.
Click on the Save button.
Specify the Parametername as sapgui/user_scripting_disable_recording.
Click on the Display button.
In the Current Value of Parameter sapgui/user_scripting_disable_recording section, if the value of the Current Value field is FALSE, change it to TRUE.
Click on the Save button.
Specify the Parametername as sapgui/user_scripting_force_notification.
Click on the Display button.
In the Current Value of Parameter sapgui/user_scripting_force_notification section, if the value of the Current Value field is FALSE, change it to TRUE.
Click on the Save button.
Restart the SAP Logon application to apply the changes.

1.2 Creating modules and familiarizing the SAP Logon application using UI Learn:

here

1.3 Defining SAP Configuration:

Note:

Task Design: Configurations -> SAP Execution Configuration

Login to Jiffy.
Navigate to Task Design -> Configurations -> SAP Execution Configuration.
Click on the Add button to define the configuration.
The following drop-down is displayed with two options:
- Create New: Use this option to create a new SAP configuration.
  Do the following to add new configuration:
  - Click on the Create New button to display the display the Add SAPUI Configuration window.
    
    Specify the details for the following fields:
    - Configuration Name: Name to be provided for the configuration and the specified name is used in the Properties section of the node.
    - Clusters: Select the required cluster from this drop-down.
    - App: Select the SAPUI related application from this drop-down. The SAPUI:1 application can be used as a default application.
    - Application Path: Path where the SAP application exists.
    - Connection String: URL of the application to be automated. This can later be changed accroding to the requirement of the app.
    - Click on the Save button.
  - Copy Existing: Use this option to copy from the existing configurations that are defined earlier.
    - Click on the Copy Existing button to display the Copy Configuration window.
    - Type the details of the required configuration in the above Search fields.
    - Select the required configuration from the filtered list.
    - Click on the Copy button.

Note:

SAP Configuration

Properties

Task Design

Designing a Task Using an SAP Node:

Use an existing task or create a new task based on the requirement.
Note: Refer Create A Task for more details on how to create a task and how to open an existing task.
Drag and drop the SAP UI node from the Objects -> UI section and connect the nodes.
Click on the SAP UI node and specify the properties:

Add the following details:
- Name: Name of the node. A default name is displayed in this field, which the user can edit according to the task and the intent of using the node.
- Description: A short note on the purpose of the node.
- Mark run Failure on Node Fail: When the Mark run Failure on Node Fail field is ON, if the node execution fails then the complete task execution is marked as fail.
- Run with User Config?: This functionality is now currently deprecated.
- Continue on Failure: When the Continue on Failure field is ON, even if the node fails, the execution will continue to the next node. When the Continue on Failure field is OFF, if the node fails, the execution will not continue to the next node.
- SAP App Configuration: Select the required configuration from the SAP App configuration drop-down. For more details click here.
- Run Mode: The user can select any one of the following options from the Run Mode drop-down:
  - Run if locked: The task runs even if the machine is locked.
  - Unlock and run: Unlocks the machine and runs the task.
- Lock After Run: Locks the machine after the node execution.
- Variables: Click on the Variables button to select the input variables and to create an output variable to assign the output of the UI event values.
  - To create an output variable, go to Output Variables tab.
  - Type the required name of the output variable in the first text box and then select the type of the output variable from the drop-down. The output variable type can be either List or Table.
    Note:If the Table option is selected, define the table structure by clicking on the Table Def button on the right-hand side of the screen. For more details, click here.
    To get the table data and store it in a Variable, the user must create a variable as Table with multiple column options (As of now in the task that is provided as an example, there is only one column, so select the SingleColTable).
  - Click on the Save button.
- Take Screen Shots: The user can select either Always or On Error option.
  If the user selects Always, then the user can see the screenshot of every UI event step output in the form of images (SAP application) after a run.
  If the user selects On Error, the user can see the screenshot of the step which is failed. In case of any popup messages or any crash on the application, the user can identify it from the screenshot. These images can be passed to next node for further process, for example, to send an email by attaching the screenshot of failure.
- Close Application: After completion of SAPUI run, then it will close the SAP application that is launched during the execution of the task when the Close Application toggle button is in ON position. When the user wants to retain a SAP application to perform actions on it, then select the Close Application toggle button must be in OFF position.
- Close Application On Error: If it is ON, then the application or SAPsite which is launched during execution will close in case of any error in the flow of execution.
Double click on the SAP UI node to display the Edit UI dialogue box.
The Edit UI dialogue is now displayed with default UI Event option in the first drop-down. This drop-down allows the user to select any of the following options:
- Set Screen: Select the required module from this drop-down. All the controls of a SAPpage are grouped together as a module during familiarization, for example, all the login SAP page controls are grouped in login module.
- UI Event: All the familiarized UI controls are displayed in this drop-down.
- UI Component: Click here for details on UI components.
- Set Variable: There is an option to set a variable inside the UI node. The value to be set can either be a new variable or an existing variable (output variable created in the Properties tab).
- Custom Expression: Jiffy provides a feature to allow users to create custom Python expressions and use them in the UI nodes steps. The Custom Expressions need to be uploaded to Jiffy Repository (Repository -> Custom Expressions). Once it is uploaded, it is available in the drop down of Custom Expressions option.
  Note: The expressions must be written in IronPython script.
- Default Expression: These are Jiffy provided python expressions for the commonly used functions. For example: Concat, Capitalize, Add days etc. Click here, for information on SAP UI related expressions.
Select the Set Screen option in the Edit UI window.
Based on the configuration selected in the Properties of SAP UI node, all the modules that are familiarized under that application type (application is added while configuration is defined) appears in the drop-down. For more details on the SAP UI controls and familiarization, click here.
Select the required module.
Note: The user must create the steps according to the manual flow of work so that the automation will run as expected.
Select the UI Event option and then select the required UI control for the specific module. The drop-down corresponding to UI control contains the following options:
- Clear: Clears the existing content in the field.
- Click: When the required UI action to be performed is a “click on the UI control” then select this option.
- DoubleClick: When the required UI action to be performed is a “double-click on the UI control” then select this option.
- Exists: Used to check whether the UI event exists or not.
- GetText: Used to get the text value of any UI event.
- Input: Used for providing inputs to an UI event, for example: Username
- InputPassword: Used for for inputting password to an UI event.
- Keyboard: Use this option when any key has to be pressed from the keyboard, for example: Enter key.
Click on the Save button in the Edit UI dialog after designing all the steps.
Click on the Trail Run icon.
Select the SAP UI node and click on the Book icon to view the Result of execution screen.

Using various data structures in tasks with SAP node after familiarization

3.1 Tree:

param1: The tree node name appearing in SAP.
param2: This function is currently depricated.
lookup_type: This defines what the input parameters are given to identify the element.
Syntax: lookuptype,comparisontype,ignorecase
Example: nodekey,startswith,false OR nodetext,startswith,false