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 Value: SAP S/4Hana Cloud Update Example: SAP 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 Example: API_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 Example: A_Supplier		String/Suggestion	Select a business object (the Entity or Endpoint) for the API Object chosen above.
Subentity Default Value: None Example: to_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 Example: If-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 Value: 300 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.