Versions Compared

Key

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

...

The Snap does not support OData navigation link.

Snap Views

Type

Format

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

Snap Settings

Info
  • Asterisk (*) - indicates a mandatory field.

  • Suggestion icon ((blue star)) - indicates a list that is dynamically populated based on the configuration.

  • Expression icon ((blue star))- indicates whether the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ((blue star) ) - indicates that you can add fields in the field set.

  • Remove icon ((blue star)) - indicates that you can remove fields from the field set.

Field Name

Type

Description

Label*

Default ValueSAP S/4Hana Cloud Create
ExampleSAP 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 ValueN/A
ExampleAPI_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
ExampleA_Supplier

String

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

Subentity

Default ValueN/A
Exampleto_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. 

The Snap provides the Customized Header in the input schema to help you to define the customized headers to the UI using the expression function. You can also manually enter the customized header names with values on the UI Customized header fieldset. If you provide only the customized header names or values using schema, but not link to the UI using the expression, the names or values you have entered will not be delivered to the API.

Field Name

Default ValueNone.
ExampleIf-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 Value300
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 Value0
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 Value0
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 ValueValidate & 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.

Troubleshooting

Error

Reason

Resolution

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

Additional information

The following contents provide some helpful information to assist you while using the SAP S/4HANA Create Snap.

...

The Payload schema helps you define the input payload for the API call via Create Snap. It loads all the parameters that you need for the data object creation. If there is a Mapper Snap or a Snap that displays the entire input schema, then use payload schema to drind the input payload. Otherwise, in the input JSON object, always include "Payload" text as a key in the parent of the input. 

...

Schema Settings 

Parameter Name  

Data Type

Description

CustomizedHeader

Default ValueN/A
Example: N/A

Array

Add customized HTTP request header to implement specific HTTP requests. 

name

Default ValueN/A
Example: If-Match

String

The field name of the customized HTTP request header.

value

Default ValueN/A
Example: W/"'82F636DC08F14D22260CE67E505C231D0D2ACD95'"

String

The field value of the customized HTTP request header. 

Payload

Default ValueN/A
Example: N/A

Object

Specify the input data parameters for the selected entities.

Usage of Customized header

...

See the example below for a defined custom header. 

...

Example

Creating

...

new customer material data in SAP S/4HANA Cloud

The example assumes that you have configured and authorized a valid SAP S/4HANA Cloud Account. The following SAP S/4HANA Cloud Create Snap and Pipeline shows how you can create new material data at the SAP S/4HANA Cloud instance using the API object API_CUSTOMER_MATERIAL_SRV_0001 (Remote API for Customer Material) and the entity A_CustomerMaterial.

...

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

Image Removed
Image Added

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

Image Modified

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.

Image Removed
Image Added

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.

Image Removed
S4HanaCreateFilePreview.PNGImage Added

Download this Pipeline

Downloads

Info
  1. Download and import the Pipeline into SnapLogic.

  2. Configure Snap accounts as applicable.

  3. Provide Pipeline parameters as applicable.

Attachments
patterns*.slp, *.zip
sortByname

...