SAP S/4HANA Cloud Delete

In this article

Overview

You can use this Snap to delete data objects in the SAP S/4HANA Cloud.

Snap Type

SAP S/4HANA Cloud Delete Snap is a WRITE-type Snap that deletes the data objects from SAP S/4HANA Cloud.

Prerequisites

A valid account that supports SAP S/4HANA Cloud instance, with the appropriate access permissions. Learn More: SAP S/4HANA Cloud Accounts.

Support for Ultra Pipelines 

Works in Ultra Pipelines

Limitations

None.

Known Issues

The Snap does not support the OData navigation link.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

 

 

  • Min: 1

  • Max: 1

  • Mapper Snap

  • Copy Snap

  • JSON Parser

Each input document contains the key of the selected entity that must be deleted from the SAP S/4HANA Cloud instance.

Output

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Copy Snap

  • XML Formatter

  • JSON Formatter

Each document contains the response of the deletion in the SAP S/4HANA Cloud instance.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab. The available options are:

  • Stop Pipeline Execution: Stops the current Pipeline execution when the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the rest of the records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in s.

Snap Settings

  • Asterisk (*) - indicates a mandatory field.

  • Suggestion icon () - indicates a list that is dynamically populated based on the configuration.

  • Expression icon ()- indicates whether the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ( ) - indicates that you can add fields in the field set.

  • Remove icon () - indicates that you can remove fields from the field set.

Field Name

Type

Description

Field Name

Type

Description

Label*

Default ValueSAP S/4Hana Cloud Delete
ExampleSAP S/4Hana Cloud_Delete

String

Specify the name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline.

API object*

Default Value: N/A
Example: API_BUSINESS_PARTNER_0001 (Remote API for Business Partner)

String/Expression/Suggestion

Select the API that you want to access in SAP S/4HANA Cloud instance. This dropdown list contains APIs available for the S/4HANA account configured in the Snap, each with a short description.

Entity*

Default Value: N/A
Example: A_Supplier

String/Expression/Suggestion

Select a business object (the Entity or Endpoint) for the API Object chosen above.

Subentity

Default Value: N/A
Example: to_SupplierCompany

String/Expression/Suggestion

Add a subentity for the entity chosen.

Customized header

Use this field set to add customized HTTP request headers for implementing specific HTTP requests other than the ones listed in the Additional Information - Usage of Customized header section of this page. 

Field name

Default Value: N/A
Example: if-match

String/Expression

Specify the field name of the customized HTTP request header.

Field value

Default Value: If-Match
Example: 82F636DC08F14D22260CE67E505C231D0D2ACD95

String/Expression

Specify the field value for the above field of the customized HTTP request header. 

Key parameter

Use this field set to specify the key parameters for a specific entity. Providing values for all key parameters in the dropdown list enables SAP S/4HANA to identify a unique record.

Key parameters are NOT the same as filters which can return multiple records. To use a filter like normal select, use the parameters at the Filter records section instead.

Field name

Default Value: N/A
Example: userId

String/Expression

Specify the reference parameter in this field.

Field value

Default Value: N/A
Example: TestUser

String/Expression

Specify the value for the reference parameter in this field. The data type—String, Integer, Boolean, or any other—depends on the Field name you specified for the parameter.

Connection details

Use this field set to specify the connectivity parameters.

TimeOut*

Default Value: 300
Example: 300

Integer/Expression

Specify the duration in seconds for which the Snap must try to establish connection with SAP S/4HANA Cloud server. If the connection cannot be established within this duration, the Snap times out, writes the event to the log, and waits until the specified Retry Interval before attempting to reconnect.

Maximum request attempts*

Default Value: 300
Example: 300

Integer/Expression

Specify an integer value to set the maximum number of reconnection attempts that the Snap must perform, in case of connection failure or timeout.

Retry Interval*

Default Value: 0
Example: 3

Integer/Expression

Specify the duration in seconds for which the Snap must wait between two reconnection attempts, until the number of retries is reached.

Snap Execution

Default Value: Execute only
Example: Validate & Execute

 

Dropdown list

Select an option to specify how to execure the Snap. Available options are:

  • Validate & Execute: Performs limited execution of the Snap (up to 50 records) during Pipeline validation; performs full execution of the Snap (unlimited records) during Pipeline execution.

  • Execute only: Performs full execution of the Snap during Pipeline execution; does not execute the Snap during Pipeline validation.

  • Disabled: Disables the Snap and, by extension, its downstream Snaps.

Troubleshooting

Error

Reason

Resolution

Error

Reason

Resolution

There is an empty field in the Field name/value field for the Customized header.

The Field name/value field must not be empty for the Customized header.

Enter a valid Field name/value for the Customized header.

API object does not exist.

Allowed API object format is <API ID>(Description).

Locate and select an API Object from the dropdown list.

Entity does not exist.

The entered Entity is not found in the server.

Locate and select the Entity from the dropdown

Additional Information

The following content provides some helpful information to assist you while using the SAP S/4HANA Cloud Delete Snap.

The General Behavior of SAP S/4HANA Cloud Delete Snap

  • Supports Delete operation to Delete data from SAP S/4HANA Cloud instance.

  • Supports customized HTTP Header. For details please see the Additional Information - Usage of Customized header.

  • Supports the input schema by which it is allowed to display the Delete supported input parameter set from the upstream input snap.

  • Supports dynamic metadata loading, by which it is allowed to load the API metadata with a Parent-child dependency structure.
    Select an API object from the API Object dropdown. Note after selecting an API object, only entities that can be deleted are suggested in the entity field.  And after selecting an entity, only relevant parameters will be displayed in the Key parameter dropdown field.

The Key parameters are labeled with a '*' in the Input schema.

Usage of Customized header

For this Snap Pack, setting customized HTTP headers is allowed. SAP S/4HANA Cloud contains a large number of API objects and entities. It is also possible to create customized API objects and entities in SAP S/4 HANA. For some entities, specific HTTP headers might be required. Example: If-Match and Etag. In the current release, only a few commonly used HTTP headers are predefined in the Snap. You can however add any custom or specific HTTP headers to fulfill your requirement. The following headers are already defined in Snap: Content-type, Cache-Control, Authorization, Accept, X-CSRF-Token, and Cookie.

Since the header parameters Content-type, Cache-Control, Authorization, Accept, X-CSRF-Token, and Cookie are already internally handled by the Snap, do not provide them in these fields.

An example of a defined custom header is given below:

Example

Deleting the Customer Material Data from SAP S/4HANA Cloud

The configuration of the SAP S/4HANA Delete Snap is shown below.

 

A successful validation of the Snap displays the following output preview, indicating the deletion of the data object.

 

Download this Pipeline

Downloads

Snap Pack History