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 Cloud 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 SAP S/4HANA Cloud instance.

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.

Label*

Default Value: SAP S/4Hana Cloud Create
Example: SAP S/4Hana Cloud_Create

String

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: N/A
Example: API_BUSINESS_PARTNER_0001 (Remote API for Business Partner)

String/Expression/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: N/A
Example: A_Supplier

String

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

Subentity

Default Value: N/A
Example: to_SupplierCompany

String

Add a subentity for the entity chosen.

Customized Header

Use this fieldset 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. 

Field Name

Default Value: None.
Example: If-Match

String

Specify the field name of the customized HTTP request header.

Field Value

Default Value: None.
Example: '82F636DC08F14D22260CE67E505C231D0D2ACD95'

String

Specify the field value for the above field of the customized HTTP request header. 

Connection Details

Use this field set to specify the connectivity parameters.

Connection Timeout

Default Value: 300
Example: 500

Integer

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 RetryInterval before attempting to reconnect.

Maximum Request Attempts

Default Value: 0
Example: 2

Integer

Specify the maximum number of attempts the Snap should make to perform the selected operation in case of connection failure or timeout.

Retry Interval

Default Value: 0
Example: 2

Integer

Specify the time interval in seconds between the two successive retry requests. A retry happens only when the previous attempt resulted in an exception.

Snap Execution

Default Value: Validate & Execute
Example: Execute only

Dropdown list

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.

There is 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 server.

Locate and select the Entity from the drop-down

CustomizedHeader

Default Value: N/A
Example: N/A

Array

Add customized HTTP request header to implement specific HTTP requests. 

name

Default Value: N/A
Example: If-Match

String

The field name of the customized HTTP request header.

value

Default Value: N/A
Example: W/"'82F636DC08F14D22260CE67E505C231D0D2ACD95'"

String

The field value of the customized HTTP request header. 

Payload

Default Value: N/A
Example: N/A

Object

Specify the input data parameters for the selected entities.

The configuration of the SAP S/4HANA Cloud Create Snap is shown below:

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

Finally, a JSON Formatter Snap and a File Writer Snap are applied to format and record data in a new file. The figure shows the configuration of the File Writer.

To view the newly created file, you must SSH to the target directory and open the newly-created file.

The following image shows the preview of the result output JSON file.