SAP S/4HANA Cloud Update

In this article

Overview

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

Snap Type

SAP S/4HANA Cloud Update Snap is a WRITE-type Snap that updates data objects in the SAP S/4HANA Cloud instance

Prerequisites

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

Support for Ultra Pipelines

Works in Ultra Pipelines

Limitations

None.

Known Issues

The Snap does not support 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 data that must be updated and written into the SAP S/4HANA Cloud instance for the selected entity.

Output

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Copy Snap

  • XML Formatter

  • JSON Formatter

Each document contains the response of the update operation.

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 Pipelines.

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 Update
ExampleSAP S/4Hana Cloud_Update

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: None
ExampleAPI_BUSINESS_PARTNER_0001 (Remote API for Business Partner)

String/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: None
ExampleA_Supplier

String/Suggestion

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

Subentity

Default Value: None
Exampleto_SupplierCompany

String/Suggestion

Add a subentity for the entity choosen.

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. 

The Snap provides the CustomizedHeader in the input schema to help you define the customized headers to the UI using the expression function. You can also manually enter the customized header names with values on the UI Customized header fieldset. If you provide only the customized header names or values using schema, but not link to the UI using the expression, the names or values you have entered will not be delivered to the API.

Field Name

Default Value: None
ExampleIf-Match

String/Expression

Specify the field name of the customized HTTP request header.

Field Value

Default Value: None
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 allows 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.

Only one key parameter can be specified in each row. Click plus to add a new row in this table and define the values accordingly. 

Field Name

Default Value: None
Example: userId

String/Expression

Specify the reference parameter in this field.

 

Field Value

Default Value: None
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.

 

Updating method

Dropdown list

Specify if the Replace or the Merge method should be implemented for updates.

  • By Replace, it is able to replace an entire old record to new.

  • By Merge, it is able to overwrite a new update to old records and merge them together.

Connection Details

Use this field set to specify the connectivity parameters.

Connection Timeout

Default Value300
Example: 500

Integer/Expression

Specify the duration in seconds for which the Snap must try to establish a connection with SAP S/4HANA Cloud. 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.