Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Use this Snap to update a data object in the SAP S/4HANA On-Premise instance.

Image RemovedImage Added

Prerequisites

...

See Snap Support for Ultra Pipelines.

Limitations and Known Issues

...

Input/OutputType of ViewNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document

  • Min: 1
  • Max: 1
  • Mapper Snap
  • Copy Snap
  • JSON Parser

Each input A document contains with data that must be updated and written into the indicates the entities to be filtered and retrieved from SAP S/4HANA On-Premise instance for the selected entity.

Output

Document

  • Min: 0
  • Max: 1
  • Mapper Snap
  • Copy Snap
  • XML Formatter
  • JSON Formatter

Each A document contains the response of the update operationcontaining the entity data retrieved from a SAP S/4HANA On-Premise instance.

Snap Settings

Parameter NameData TypeDescriptionDefault ValueExample 

Label

String

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

N/A

SAP S/4HANA Update

API object

String

Required. Select the API that you want to access in SAP S/4HANA On-Premise instance. This drop-down list contains APIs available for the S/4HANA account configured in the Snap, each with a short description.

N/A

ZCRM_BUPA_ODATA_0001 (Odata Services for Business Partner)

Entity

String

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

N/A

AccountCollection

SubentityString/Expression/Suggestion

Specify or select a subentity corresponding to the entity chosen above.

N/AMainContact

Customized header

Use this field set to add customized HTTP request headers for implementing specific HTTP requests other than the ones listed in the Using Customized Headers section (SAP S/4HANA Read Snap). Only one customized header can be specified in each row. Click  to add a new row in this table and define the values accordingly.

This field set comprises the following fields:

  • Field name
  • Field value

Field name

StringThe field name of the customized HTTP request header.N/AIf-Match

Field value

StringThe field value for the above field in the customized HTTP request header. N/AW/"'82F636DC08F14D22260CE67E505C231D0D2ACD95'"

Key parameter

Required. This field set enables you to specify the key parameters for a specific entity. Providing values for all key parameters in the drop-down list enables SAP S/4HANA to identify a unique record. 

Info

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  to add a new row in this table and define the values accordingly. 

This field set comprises the following fields:

  • Field name
  • Field value

Field name

StringSpecify the key Parameter (reference parameter) fields.N/AaccountID

Field value

StringSpecify 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.N/ATEST_001
Disable datatype conversionCheckbox/ExpressionSelect the checkbox to disable the datatype conversion for values of key parameters and filters.Deselected Selected
Updating methodString

Optional. Specify the type of update to be made for the records in SAP S/4HANA On-Premise instance. The available options are:

  • Replace: Replaces the entire existing record with the new data record. All values will get updated. Use this option for updating values in the entire record.
  • Merge: Merges the new values in the existing record. Use this option to update one or more values in an existing record.
ReplaceMerge

Input navigation level

Integer

Select the depth of navigation for your input schema. 

0

1

Connection details

Use this section of Snap Settings to specify the connectivity parameters: timeout, retry count and retry interval. 

This field set comprises the following fields:

  • TimeOut
  • Maximum request attempts
  • RetryInterval

TimeOut

Integer

Required. Enter, in seconds, the duration for which the Snap must try to establish connection with SAP S/4HANA On-Premise instance. If the connection cannot be established within this duration, the Snap times out, writes the event to the log, and waits until the specified RetryInterval before attempting to reconnect.

300

120

Maximum request attempts

Integer

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

0

5

RetryIntervalRetryInterval 

Integer

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

0

10

Snap Execution

String

Indicates how the Snap must be executed. 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.

Execute only

Validate & Execute 

...

Insert excerpt
SAP S/4HANA Snap Pack
SAP S/4HANA Snap Pack
nopaneltrue

...