Skip to main content
Version: Current

Find SAP Business Object

Description​

Finds Business Objects available within a specified SAP OData service.

Use this activity to discover SAP Business Objects at runtime instead of selecting a specific Business Object while designing the workflow.

Specify the Service Name containing the Business Objects and optionally provide a Search Term to narrow the results.


Common settings​

Use Process Data to bind supported inputs to workflow values or upstream outputs. See Common Activity Features for shared execution, error-handling, and output-persistence settings. Availability depends on the activity.

Design-Time Configuration​

Display Text​

A user-defined name for the activity, displayed on the workflow canvas to help identify its purpose.

Connection Name​

The configured SAP connection used to access the SAP system.

The connection determines the SAP system and the OData services available to the activity.

If you have not yet created or configured an SAP connection, see SAP Connection.

Service Name​

The SAP OData service in which to search for Business Objects.

You can provide the service name directly or configure it dynamically using Process Data.

For dynamic service discovery, the service information returned by the Find SAP Service activity can be used to provide the required Service Name.


OData Version​

Specifies the OData protocol version used when discovering Business Objects from the specified SAP service.

OptionDescription
AutoAutomatically determines the appropriate OData version based on the configured connection URL. This is the default option.
OData V2Uses the OData V2 protocol.
OData V4Uses the OData V4 protocol.
tip

Use the default Auto option unless you specifically need to use OData V2 or OData V4.

Timeout​

Maximum HTTP request duration in seconds. The default 0 uses the selected connection's timeout. Set a positive value to override it for this activity.

Search Term​

An optional value used to search for Business Objects within the specified SAP service.

The activity searches for Business Objects containing the specified term.

For example, specifying:

purchase

returns Business Objects containing purchase in their searchable information.

The search term can be provided directly or configured dynamically using Process Data.

If no search term is provided, the activity returns the available Business Objects discovered within the specified SAP service.


Execution settings​

Configure Wait All Incoming when execution paths converge, and On Error for failure handling. Select Inherit where available to use the workflow-level error policy.

Output​

Business Objects​

A collection of SAP Business Objects found within the specified SAP OData service.

When a Search Term is provided, the collection contains the Business Objects matching the specified search criteria.

Each Business Object in the collection contains the following information:

PropertyDescription
NameTechnical name of the SAP Business Object.
Display NameDisplay name of the SAP Business Object.

The returned Business Objects collection can be used by downstream activities through Activity Outputs.

Remarks​

The selected SAP connection must have permission to read the relevant service metadata. A Search Term narrows the returned collection; leave it empty to list the available results in scope. Inspect the collection before selecting an operation or object.

Example: Use a discovery result​

Configure the connection and Service Name, enter a Search Term if needed, and run. Iterate over Business Objects and bind the selected item's Name to Get Records → Business Object.