Input

Document

Min: 0
Max: 1

• Mapper

Document that conforms to the input view schema of the Snap. The document attributes are matched to the SAP BAPI metadata, and the matching attributes are provided to the BAPI program at execution, and any non-matching attributes are ignored.
The attributes can be tabular and structured or scalar. The Snap makes an API call for each document. If there is no input document, the Snap calls the BAPI with no input data.

Output

Document

Min: 1
Max: 1

• JSON Splitter

• Mapper

• Any document processing Snap

Document which represents the record structure of the retrieved BAPI output definition. The documents are populated using the result data of each BAPI call for each document passed into this Snap. If the Snap has no input document, only one output document result is created. 

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. Learn more about Error handling in Pipelines.
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.

Label*

Default Value: SAP Execute
Example: SAP BAPI Create Orders

String

Specify a unique and meaningful name for the Snap.

BAPI List configuration

Use this field set to configure the list of BAPIs to return. This field set contains the following fields.

BAPI List config key

Default Value:OBJECTTYPE
Example: RELEASED_FUNC

Dropdown list

Select a key to configure the BAPI list that is being returned. The available options are:

• OBJECTTYPE

• SHOW_RELEASE

• BAPIS_POTENTIAL

• BAPIS_NEW

• BAPIS_OLD

• RELEASED_BAPI

• RELEASED_FUNC

BAPI List config value

String

Define a value to configure the BAPI list that is being returned. Learn more about object types.

BAPI*

Default Value: N/A
Example: BAPI_MONITOR_GETLIST

String/Expression/Suggestion

Specify the BAPI on the SAP server to be executed. This is the ABAP name. 

Start Stateful Call Sequence

Default Value: Deselected

Checkbox

Select this checkbox to create a stateful session for calling one (or more) BAPIs. A Session ID is required if you want to create a stateful call sequence.

Commit after BAPI execute

Default Value: Deselected

Checkbox

Select this checkbox to end the stateful session and commit when no exception is raised; otherwise, the BAPI controls the commits.

Session ID

Default Value: N/A
Example: xyz987

String/Expression

Specify the string to identify a specific session.

All Snaps in a specific stateful call sequence must be in the same session ID, and there should be only call sequence running in a session at a time. If you do not provide any session ID, the Snap runs in its own session.

Date conversion format

Default Value: yyyyMMdd
Example: yyyyMMdd

String/Expression

Specify the format to convert string input values into SAP date/datetime fields in SimpleDateFormat.
If you do not specify any value, then no conversion is done and the SAP client displays an error when an input view string is mapped to SAP date/datetime field.

Output date time as Text

Default Value: Deselected

Checkbox

Select to output date and time as a String data type instead of a DateTime object.

Error handling

Use this field set to define the error path and values for handling errors. If any error paths and their error values match a corresponding value in the output document, then the document is routed to the error view (if enabled), or the Snap fails (if the error view is disabled).

If you do not define the error handling, the Snap will not by default fail or route anything to the error view if the RETURN[*].TYPE value is 'E'.

Error path

Default Value: $RETURN[*].TYPE
Example: $RETURN[*].TYPE

String/Expression

Specify the error path to which the errors should route.

Error value

Default Value: E
Example: R

String/Expression

Specify the value for the error.

Max request attempts*

Default Value: 3
Example:5

Integer

Specify the maximum number of SAP connection attempts to make in case of a failure. When you specify 0, the Snap makes infinite connection attempts. 

Request retry interval

Default value: 5
Example: 5

Integer

Specify the time in seconds to wait before retrying the request.

Route errors

Default value: Deselected

Checkbox

Select this checkbox to write configuration errors to the error view. If the error is non-recoverable, the errors (especially connection errors such as exception handling) are routed to the error view with relevant information.

Reload Function Metadata

Default value: Deselected

Checkbox

Select this checkbox to reload the metadata (latest schema) for the current BAPI function before executing the BAPI function.

Round to SAP decimal*

Default state: Deselected

Checkbox

Select this checkbox to round the decimal value to match the number of decimal places defined in the SAP target field. This prevents a conversion error if the number of decimal places exceeds the value defined in SAP.

If you deselect this checkbox and the Snap tries to write a decimal value that either exceeds the length or the number of decimal places defined in the SAP packed decimal field, a conversion error is displayed.

Snap Execution

Default value: Execute only
Example: Validate & Execute

Dropdown list