Document

• Min: 0
• Max: 1

• Mapper Snap
• Copy Snap
• JSON Parser

A document with data that indicates the entities to be filtered and retrieved from SAP S/4HANA On-Premise instance. 

Document

• Min: 1
• Max: 1

• Mapper Snap
• Copy Snap
• XML Formatter
• JSON Formatter

A document containing the entity data retrieved from a SAP S/4HANA On-Premise instance.

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 Read

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

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 of this page. Only one customized header can be specified in each row. Click  to add a new row in this table and specify the values accordingly.

Field name

Field value

Key parameter

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. 

Field name

Field value

Filter records

This field set enables you to define how the response result be filtered based on the specified parameters (filter criteria).

Field name

Operation

Specify the comparison operator for the $filter field specified above from this drop-down list. Available options are: 

• Equals
• Not Equals
• Greater than or Equal
• Greater than
• Less than or Equal
• Less than
• Starts with
• Ends with

Field value

Condition

Select a value from this drop-down list to set the correlation between this filter criterion (row) and the next one (row), if being defined at all, to apply the filters for generating the final output. Available options are: 

• Or: To retrieve records that match either the current criterion or the next criterion.
• And: To retrieve only records that match both the current criterion and the next criterion.
• None: To specify that the current and the next criteria can be evaluated independent of each other in retrieving the records.

Output field selection

This field set enables you to select the fields to be included in the output. 

Element

Order by

This field set enables you to define the sort order for the records in the output. 

Element

Order by type

Depending on the field selected above, define whether the rows must be sorted in the ascending order or descending order. Available options are:

• Ascending
• Descending

Use this section of Snap Settings to customize the output set: the number of output entries and the index of the starting entry. Available options are:

• Output entry limit
• Output entry offset
• Is an active entity
• Count
• Allow empty result
• Pass through

Output entry limit

Integer

Specify the maximum number of entries that SAP S/4 HANA On-Premise instance must return in the output.

500

10

Output entry offset

Integer

Specify the record index starting from which SAP S/4 HANA On-Premise instance must return records in the output.

Use this property along with the Output entry limit to retrieve a specific set of entries in the output.

N/A

10

Is an active entity

Dropdown list

not available

true

Allow empty result

Checkbox

Select this checkbox to define whether output views can show empty result. If this check box is not selected, an error will be thrown when the output has no records.

Selected

Deselected

Connection details

Use this field set to specify the connectivity parameters: timeout, retry count, and retry interval.  This field set contains 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.

3

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.

1

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.

Validate & Execute

Execute only