Skip to main content
Version: Current

Find SAP Action or Function

Description​

Finds Actions and Functions available within a specified SAP OData service.

Use this activity to discover SAP OData operations at runtime instead of selecting a specific Action or Function while designing the workflow.

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

Common Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using variables from the Process Data drawer.

You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.

Learn more → Using Process Data

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 Actions and Functions.

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 Actions and Functions 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​

Specifies the maximum amount of time, in seconds, that the activity waits for the SAP request to complete.

If the request does not complete within the configured duration, the activity times out.

Search Term​

An optional value used to search for Actions and Functions within the specified SAP service.

The activity searches for operations containing the specified term.

For example, specifying:

purchase

returns Actions and Functions 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 Actions and Functions discovered within the specified SAP service.

Wait All Incoming​

Execution Control

Controls how this activity behaves when multiple incoming execution paths converge.

Determines whether the activity executes when:

  • Any incoming path completes, or
  • All relevant incoming paths complete before execution

Learn more → Execution Control

On Error​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include:

  • Fault
  • Continue
  • Suspend
  • Retry

Learn more → Error Handling

Output​

Operations​

A collection of SAP OData Actions and Functions found within the specified SAP OData service.

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

Each operation in the collection contains the following information:

PropertyDescription
NameName of the SAP OData Action or Function.
KindIndicates the type of operation, either Action or Function.
ServiceNameName of the SAP OData service that exposes the operation.
IsBoundIndicates whether the Action or Function is bound to a Business Object.
BindingEntitySetBusiness Object to which the operation is bound, when the operation is a bound Action or Function.
ParametersCollection of parameters defined by the Action or Function.

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

Error Message​

Contains information about any error encountered while searching for SAP Actions or Functions.

This output can be used by downstream activities to inspect or handle errors as part of the workflow.

Understanding Bound Operations​

An SAP OData Action or Function can be either bound or unbound.

A bound operation is associated with a particular Business Object. The IsBound property is set to true, and BindingEntitySet identifies the Business Object associated with the operation.

An unbound operation is not associated with a particular Business Object. The IsBound property is set to false.

This information can be used when dynamically identifying and invoking SAP operations at runtime.

Remarks​

  • The selected SAP connection must have access to the specified OData service.

  • Service Name identifies the SAP OData service in which Actions and Functions are searched.

  • The Actions and Functions returned by the activity depend on the operations exposed by the specified SAP OData service.

  • Search Term performs a term-based search within the available Actions and Functions.

  • Leave Search Term empty when you want to retrieve all Actions and Functions available within the specified service.

  • Use the Kind property to determine whether a returned operation is an Action or a Function.

  • Use IsBound and BindingEntitySet to determine whether an operation is associated with a specific Business Object.

  • The Parameters property provides the parameters defined by the corresponding Action or Function.

  • The authenticated SAP user must have sufficient permissions to access the specified OData service.

  • Use Find SAP Service when the required service must first be discovered dynamically.

  • Use the returned Operations collection when SAP Action or Function discovery needs to be performed dynamically at runtime.