In this article

Overview

Use this Snap to create data objects in the SAP S/4HANA On-Premise instance.

SnapLogic Documentation > SAP S/4HANA Create > sap_s4hana_create_ui.png

Prerequisites

A valid account that supports SAP S/4HANA, with appropriate access permissions. See Configuring SAP S/4HANA Accounts.

Support for Ultra Pipelines

Works in Ultra Pipelines.

See Snap Support for Ultra Pipelines.

Limitations and Known Issues

The Snap does not support OData navigation link.

Snap Input and Output

Input/Output

Type of View

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 created and written into the SAP S/4HANA On-Premise instance.

Output

Document

Min: 0
Max: 1

Mapper Snap
Copy Snap
XML Formatter
JSON Formatter

Each document contains the response of the creation of new records in the On-Premise instance.

Snap Settings

Parameter Name

Data Type

Description

Default Value

Example

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 Create

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

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

Alternatively, you can define customized headers through Input Schema in combination with expressions. When using Input Schema, it is mandatory to define the HTTP request headers as expressions ('=' symbol enabled for Field name and Field value).

Field name

String

The field name of the customized HTTP request header.

N/A

If-Match

Field value

String

The field value for the above field in the customized HTTP request header.

N/A

W/"'82F636DC08F14D22260CE67E505C231D0D2ACD95'"

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

RetryInterval

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

Troubleshooting

Error	Reason	Resolution
You have an empty field in the Field name/value field for the Customized header.	The Field name/value field must not be empty for the Customized header.	Enter a valid Field name/value for the Customized header.
API object does not exist.	Allowed API object format is <API ID>(Description).	Locate and select an API Object from the drop-down list.
Entity does not exist.	The entered Entity is not found in the SAP S/4HANA server.	Locate and select the Entity from the drop-down list.
The input payload is not found.	The input payload is not found.	Fetch an input payload via Input Schema or input with the root key node Payload.
The input payload should be a JSON object.	The input payload is not passed as a JSON object.	Ensure that the input payload coming from the upstream Snap is a JSON object.

Additional Information

Here is some information to assist you while using the SAP S/4HANA Create Snap.

Snap General Behavior

The SAP S/4HANA Create Snap supports the following:

POST operation to create new data in the SAP S/4HANA On-Premise instance.
Customized HTTP Header. For more information, see Using Customized Headers (in SAP S/4HANA Read Snap).
Display of only the create-compatible input parameter set from the upstream input Snap.
Dynamic loading of API metadata with a Parent-child dependency structure. This means that you can:
- Select an API object from the API Object field to view only entities that are related to the API object and support POST queries (create operations).
- And then, select an entity to view and specify values for only create-compatible parameters related to this entity, in the input schema.

Input schema

The input schema for SAP S/4HANA Create Snap is divided into two parts: CustomizedHeader and Payload.

SnapLogic Documentation > SAP S/4HANA Create > SAP_S4HANA_CREATE_SCHEMA.png

You can define customized headers for your HTTP requests using either the CustomizedHeader schema and as expressions or Customized header fieldset to manually enter the customized header names with values. If using the CustomizedHeader schema, it is mandatory to define the name and values as expressions to ensure the names and values provided are delivered to the API.
Use the Payload schema for SAP S/4HANA Create Snap to define the input payload for an API call. This dynamically loads and represents all the parameters that you need for creating the data object (payload).
- If the upstream Snap can display the entire input schema like Mapper Snap, always select the Payload object in the schema to define your input payload in that Snap.
- If your input payload is a JSON object, ensure that the text Payload is included as the key in the parent of your input.

Schema settings

Parameter Name	Data Type	Description	Default Value	Example
CustomizedHeader	Array	Add customized HTTP request header to implement specific HTTP requests.	N/A	N/A
name	String	The field name of the customized HTTP request header.	N/A	If-Match
value	String	The field value of the customized HTTP request header.	N/A	W/"'82F636DC08F14D22260CE67E505C231D0D2ACD95'"
Payload	Object	Specify the input data parameters for the selected entities.	N/A	N/A

Using Customized Headers

See Using Customized Headers (in SAP S/4HANA Read Snap).

Examples

Create New Customer Material Data in SAP S/4HANA Instance

This Pipeline example demonstrates using a SAP S/4HANA Create Snap to create new material data at the SAP S/4HANA On-Premise instance.

The example assumes that you have configured and authorized a valid SAP S/4HANA Account (see Configuring SAP S/4HANA Accounts).

SnapLogic Documentation > SAP S/4HANA Create > sap_s4hana_create_example_pipeline.png

Download this Pipeline.

The following settings are defined for the SAP S/4HANA Create Snap to add customer material data from the SAP S/4HANA On-Premise instance it accesses.

API object: ZSD_F2499_CUSTOMER_MATERIAL_SRV_0001 (Customer Material)
Entity: C_CustomerMaterial_F2499

SnapLogic Documentation > SAP S/4HANA Create > sap_s4hana_create_example_ui_config_1.png

A successful validation or execution of the Snap gives the following output preview, showing the query results.

SnapLogic Documentation > SAP S/4HANA Create > sap_s4hana_create_example_output_view.png

A JSON Formatter Snap is connected to the SAP S/4HANA Create Snap to read and format its output data into standard JSON format.

A File Writer Snap is connected to the JSON Formatter Snap to save / write the JSON-formatted data into a file.

SnapLogic Documentation > SAP S/4HANA Create > sap_s4hana_create_example_file_writer.png

To view the output JSON file, you must SSH to the target directory and open the newly-created JSON file. The preview of the output JSON file can be seen below:

SnapLogic Documentation > SAP S/4HANA Create > sap_s4hana_create_example_output_file.png

Downloads

Download and import the Pipeline into SnapLogic.
Configure Snap accounts as applicable.
Provide Pipeline parameters as applicable.

Overview

Prerequisites

Support for Ultra Pipelines

Limitations and Known Issues

Snap Input and Output

Snap Settings

Troubleshooting

Additional Information

Snap General Behavior

Input schema

Schema settings

Using Customized Headers

Examples

Create New Customer Material Data in SAP S/4HANA Instance

Downloads

See Also