SelectValue

Estimated reading: 4 minutes

The SAP SelectValue activity selects a specified item from a supported SAP selection control, such as a drop-down list, combo box, or list box. It uses SAP element information captured through Spy to identify the target control and select the requested item during workflow execution.

The activity must be used within an SAP Logon and uses the SAP session established by the parent activity.

Supported Controls

SAP SelectValue is intended for SAP controls that support item selection, including:

i. Drop-down lists
ii. Combo boxes
iii. List boxes
iv. Other SAP selection controls that expose selectable items

Support may vary depending on the control type and SAP application implementation.

Activity Canvas

The activity canvas allows you to identify the target SAP selection control and configure the item to select.

Select Element: Allows you to identify and capture the target SAP selection control using Spy. The captured element information is used to locate the control during execution.

Select By: Specifies how the item is identified within the selection control. choose from the dropdown.
Text: Selects an item based on its displayed text.
Index: Selects an item based on its position within the control.

Value: Specifies the displayed text or index of the item to select, depending on the selected Select By option.
When Text is selected, enter the displayed text of the required item.
When Index is selected, enter the numeric index of the required item.

Properties

Execution

Delay Before: Specifies the delay, in milliseconds, before the selection operation begins.

Delay After: Specifies the delay, in milliseconds, after the selection operation completes.

Offset X: Specifies the horizontal offset applied during interaction with the target element.

Offset Y: Specifies the vertical offset applied during interaction with the target element.

Use Anchor: Determines whether an anchor is used to help identify the target SAP element.
Checked: Uses the configured anchor to help identify the target element.
Unchecked: Identifies the target element without using an anchor.

Wait Time: Specifies the maximum time, in milliseconds, to wait for the target SAP control to become available before timing out.

Input

Select By: Specifies the method used to identify the item to select. The available options are Text and Index.

Value: Specifies the displayed text or numeric index of the item to select, based on the selected Select By option.

MISC

DisplayName: Specifies the activity’s display name. Customize it to identify the activity in the workflow.

SkipOnError: Specifies whether workflow execution continues when the activity encounters an error.
True: Continues workflow execution when an error occurs.
False: Stops workflow execution when an error occurs.
None: Uses the default value, False.

Version: Displays the current version of the activity.

OUTPUT

Result: Returns a Boolean value indicating the activity’s execution status.
True: The activity executed successfully.
False: The activity failed due to an unexpected error.

Selected Text: Stores the text of the item selected from the SAP control. Specify the value as a hardcoded string or a string variable.

SAP

SAP Id: Identifies the SAP session associated with the activity. It is retrieved automatically during execution.

How It Works

1. Execute the activity within an SAP Logon scope to use the established SAP session.
2. Use Spy to identify and capture the target SAP selection control.
3. Configure Select By and Value to specify the required item.
4. The activity locates the target control and waits for it to become available, subject to the configured Wait Time.
5. The activity attempts to select the specified item using the configured selection method.
6. The selected item’s text is stored in Selected Text, and the execution result is stored in Result.

Exception Handling

The selection operation may fail if:

a. The target SAP element cannot be identified.
b. The SAP session is unavailable.
c. The specified item cannot be found in the selection control.
d. The control does not support the selection operation.
e. The target control does not become available within the configured Wait Time.
f. An error occurs while performing the selection.

Errors are handled according to the activity’s error-handling configuration, including the SkipOnError setting.

Example

To select company code 1000 from an SAP drop-down list:

1. Use Spy to capture the company code selection control.
2. Set Select By to Text.
3. Set Value to 1000.
4. Execute the workflow.

The activity locates the control and attempts to select the item matching the specified text. The selected text is stored in Selected Text.

Alternatively, set Select By to Index and provide the item’s index when selection by position is required.

Share this Doc

SelectValue

Or copy link

CONTENTS
Robility Chatbot
Robility Assistant
Online