Delete Records
Description
Deletes one or more records from an SAP Business Object based on specified filter conditions.
The activity uses SAP OData APIs and supports SAP systems that expose OData services, including SAP S/4HANA Cloud and SAP S/4HANA On-Premises environments.
Use the Filter tab to define the conditions that identify the records to delete.
Common Capabilities
Process Data Support
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
The SAP OData service containing the Business Object from which you want to delete records.
The available services are retrieved based on the selected SAP connection.
Business Object
The Business Object containing the records you want to delete.
The available Business Objects depend on the selected Service.
OData Version
Specifies the OData protocol version used to communicate with the selected SAP service.
| Option | Description |
|---|---|
| Auto | Automatically determines the appropriate OData version based on the configured connection URL. This is the default option. |
| OData V2 | Uses the OData V2 protocol to communicate with the SAP service. |
| OData V4 | Uses the OData V4 protocol to communicate with the SAP service. |
Use the default Auto option unless you specifically need to force the activity to use OData V2 or OData V4.
Timeout
Specifies the maximum amount of time, in seconds, that the activity waits for the SAP OData request to complete.
If the request does not complete within the configured duration, the activity times out.
Wait All Incoming
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
Defines how the workflow behaves if this activity encounters a runtime error.
Supported strategies include:
- Fault
- Continue
- Suspend
- Retry
Filter
The Filter tab allows you to define the conditions used to identify the SAP Business Object records to delete.
The available fields for defining filter conditions depend on the selected Business Object.
Filter values can be provided directly or configured dynamically using Process Data.
Ensure that the filter conditions identify only the intended records before executing the activity.
A filter that matches multiple records may result in multiple records being deleted.
When deleting a specific record, use fields that uniquely identify the record whenever possible.
Output
Error Message
Contains information about any error encountered while deleting the records.
This output can be used by downstream activities to inspect or handle errors as part of the workflow.
Remarks
-
The selected SAP connection must have access to the configured OData service.
-
The available Services depend on the OData services exposed by the connected SAP system.
-
The available Business Objects depend on the selected Service.
-
The fields available in the Filter tab depend on the selected Business Object.
-
The authenticated SAP user must have permission to delete records from the selected Business Object.
-
Use appropriate filter conditions to ensure that only the intended records are deleted.
-
When deleting a specific record, use a unique identifier or a combination of filter conditions that uniquely identifies the record.
-
SAP may prevent deletion based on business rules, record dependencies, or other validations configured in the SAP system.