Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Snap Type:

Write

Description:

This Snap provides the ability to create data objects in SAP S/4 HANA 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]

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 Create Snap

  • Supports POST operation to create new 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 Create 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 and only this selected API-object related and Create supported (POST operation supported) entities will be displayed. After selecting an entity, only this selected entity related and Create supported (POST operation supported) parameters will be shown 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 Create Snap and pipeline show how you can create new material data 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 Create Snap to create a new material data entry

Image Removed

Image Added

Image RemovedImage Added

Implementing an example pipeline to create a new material data entry using SAP S/4HANA Create Snap

Image RemovedImage Added

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

Image RemovedImage Added

Downloads

Attachments
patternsSAPS4HANAOnPremise_1.0.0_CreateSAP_S4HANA_ZSD_F2499_CUSTOMER_MATERIAL_SRV_0001_C_CustomerMaterial_F2499_TC1_CREATE_DEMO_2020_03_05.slp

Snap Pack History

Expand