SAP package

The SAP package contains actions to automate tasks and processes on a SAP application.

The SAP package enables you to perform the following tasks:

Reduce the time required to combine data from disparate systems.
Eliminate human error and increase efficiency.
Increase the number of transactions processed.
Deliver real-time information to various stakeholders.
Enhance decision-making through comprehensive reports.

Note: In SAP Connect action, the Session name field cannot be shared with TaskBots or any other bots.

Prerequisites

Log in to the SAP GUI before capturing objects because the SAP Logon screen is not supported for object capture.
Enable GUI scripting and accessibility.
See Enabling Scripting on the Client Side, Enabling Scripting on the Server Side, and Enabling Accessibility settings.
Ensure that one of the following SAP GUI for Windows is installed on the devices that you use to automate SAP-related tasks and to run these tasks:
- SAP GUI 750 with patch 9
- SAP GUI 760 with patch 0
- SAP GUI 760 with patch 1
- SAP GUI 760 with patch 5
- SAP GUI 770 with patch 6
Note: If SAP GUI 760 with patch 0 is installed on your device, you cannot use the SAP Grid view control Set Table cell text and Get Table Cell Text actions because of an issue with SAP GUI 760 with patch 0.
Install a Scripting Tracker or a similar tool to retrieve the field path of the SAP object.

Before you start

Perform the following actions within the SAP package as part of using the set of available actions:

Establish a connection with the SAP application using the Connect action.
Log in to the SAP application using the SAP GUI application. Then use the Connect action from the SAP package to use this connection and assign a session name. Use this same session name for the other actions.
Use the actions to automate a task.
After you have automated all the SAP-related tasks, terminate the connection to the SAP application using the Disconnect action.

Actions in the SAP package

The SAP package includes the following actions:


Action	Description
Check/uncheck checkbox	Selects or clears a check box. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Action option, select Check, Uncheck, or Toggle.
Click	Performs a click operation. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object.
Click menu	Clicks a menu item by text or index. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Select option, select Name or Index to specify the name or index of the menu item.
Connect	See Using Connect action for SAP.
Disconnect	Terminates the connection to the SAP application. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action.
Double click	Performs a double-click operation. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object.
Expand	Expands the item by text or index. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Select option, select Text or Index to specify the text or index of the item.
Export table	See Using Export table action.
Get cell count	Gets number of cells in a table or grid. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to a variable field, specify the variable.
Get children name	Gets children control names. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to list variable field, specify the list variable.
Get children text	Gets the text associated with children control. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to list variable field, specify the list variable.
Get column count	Gets number of columns in a table or grid. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to a variable field, specify the variable.
Get row count	Gets number of rows in a table or grid. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to a variable field, specify the variable.
Get selected item	Gets selected item index from a combo box, page tab, or a tree view control. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to a variable field, specify the variable.
Get status	Gets status of a radio button or check box. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to a variable field, specify the variable.
Get table cell index	Gets table cell index for text. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Search text field, specify the text. Select the Case sensitive search option to specify a case-sensitive search. Select the All occurrences check box. In the Assign the output to a variable field, specify the variable.
Get table cell text	Gets table cell text by index. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Row field, specify the number of row from which you want to get the text. In the Column field, specify the number of column from which you want to get the text. In the Assign the output to a variable field, specify the variable.
Get text	Gets text from a text box, label, or status bar. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to a variable field, specify the variable.
Get total item	Gets total item from a combo box, page tab, or tree view control. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Assign the output to a variable field, specify the variable.
Left click	Performs a left-click operation. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object.
Right click	Performs a right-click operation. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object.
Select item	Selects an item by text or index. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Select option, select Text or Index to specify the text or index of the item.
Select radio option	Selects a radio button. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object.
Send virtual key	Sends a virtual key. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Select list, select a key. See Virtual keys in SAP GUI.
Set table cell text	See Set table cell text.
Set text	Sets the text in an editable field. In the Session name field, enter the session name you used to connect to the SAP application in the Connect action. In the Field path field, specify the location or a string variable that contains the location of the object. In the Field value field, specify the text. Note: You can set the fields to any value, including blank values, for example, text field or date field. Select the Append text check box.

Automation 360