Snap Type:

Write

Description:

This Snap provides the ability to update data from SAP S/4HANA application.

Prerequisites:

An SAP S/4HANA Basic Auth Account

Support and limitations:

Ultra pipelines: Supported in Ultra Pipelines.

Spark mode: Not supported in Spark mode.

Account:

This Snap uses account references created on the SAP S/4HANA Account page of SnapLogic Manager to access to the endpoint. See SAP S/4HANA Basic Auth Account for information on setting up this type of account.

Views:

Input
This Snap has at least one document input view.

Output
This snap has at most one document output view.

Error
This Snap has one optional error view and might produce documents in the view if errors are returned from the S/4HANA application.

Settings

Label:

Required. The name for the Snap. You can modify this to be more specific, especially if you have the same Snap more than once in your pipeline

API object:

Required. This property enables you to define the API that you want to access. This field will be populated dynamically with the list of APIs available in the S/4HANA system configured in the account snap. Users are allowed to choose an API Object from suggestion dropdown. The entity is shown as API Object name (Short description) in the dropdown.

Example: ZCRM_BUPA_ODATA_0001 (Odata Services for Business Partner)

Default value: [None]

Entity:

Required. This property enables you to define the Entity or Endpoint of an API. This field will be shown dynamically from different users’ accounts from the suggestion dropdown based on the API Object that you selected.


Example: AccountCollection

Default value: [None]

Customized header:

Add customized HTTP request header to implement specific HTTP requests. For more details, please see the Additional Information - Usage of Customized header.

 

Example: If-Match: W/"'82F636DC08F14D22260CE67E505C231D0D2ACD95'"

Default value: [None]

Key parameter:

Required. This property enables you to specify the key fields to a specific entity.

In case you provide one key parameter, you need to provide them all if multiple keys are found in the dropdown list. Key parameters are only to be used for retrieving specific records. So all of them need to be provided. In case you want to a filter (e.g: normal select); then use filter instead.

Example: accountID

Default value: [None]

TimeOut:

This property enables you to set the connection timeout duration in seconds.

Default value: [300]

Pass through:

This property enables you to "pass through" the data from an incoming document and merge it into the new document being written to the output. If selected, the input document will be passed through to the output view under the key 'original'.

Default value: Selected

Connection details:

Connection timeout
Required. This property enables you to set the connection timeout duration in seconds.
Default value: [300]

 

Number of retries
Required. This property enables you to set the maximum number of re-connections in case of connection failure or timeout.
Default value: [3]

 

Retry interval (seconds)
Required. This property enables you to set the time interval in seconds between reconnections.
Default value: [1]

Execute during preview:

This property enables you to execute the Snap during the Save operation so that the output view can produce the preview data.

Default value: Not selected

For more information on how to define JSON-formated input data in the OData based API, see OData Version 2.0 Protocol.

The general behavior of SAP S/4HANA Update Snap

  • Supports PUT operation to Update data from the SAP S/4HANA Server.

  • 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 Update 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 field. only this selected API-object related and Update supported (PUT operation supported) entities will be displayed. After selecting an entity, only this selected entity related and Update supported (PUT operation supported) parameters will be shown in the dropdown field of Key parameter and input schema.

Notice that Key parameters will be labeled by '*' in the Input schema.

Additional Information

Usage of Customized header

See this link: Description of Usage of Customized header.

Example

The example assumes that you have configured & authorized a valid SAP S/4HANA Basic Auth Account. The following SAP S/4HANA Update Snap and pipeline show how you can update material data for a specific data entry at the SAP S/4HANA server via API object ZSD_F2499_CUSTOMER_MATERIAL_SRV_0001 (Customer Material) and Entity C_CustomerMaterial_F2499.

Configuring an SAP S/4HANA Update Snap to update information for an existing material data entry

Implementing an example pipeline to update information for an existing material data entry

A successful validation or execution of the Snap gives the following output preview showing the results from API response

Downloads

Snap Pack History