Snap type: | Write | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Description: | This Snap writes an SAP IDoc to the configured SAP server. Because IDocs are processed asynchronously on the server, Polling interval and Polling timeout are additional configurations that define how to get the processing status. Expected upstream Snaps: The Control record fields of the IDoc Write Snap input view can be mapped using an upstream Mapper Snap. Expected downstream Snaps: The Snap will output one document for every IDoc write operation, hence any document processing Snap can be used down stream. Expected input: Document that conforms to the input view schema of the Snap. The input view schema is provided to an upstream Mapper Snap based on the selected service object. Expected output: Document which represents the record structure of the retrieved IDoc record output definition. Each IDoc write record is represented as one document on the output view.
| ||||||||||||
Prerequisites: | |||||||||||||
Support and limitations: |
| ||||||||||||
Account: | This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See SAP Account for information on setting up this type of account. | ||||||||||||
Views: |
| ||||||||||||
Settings | |||||||||||||
Label | 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. | ||||||||||||
IDOC | Required. The SAP IDoc type to write. Example: MATMAS01 Default value: [None] | ||||||||||||
IDOC Extension type | The IDoc Extension Write type is an extension of an associated IDOC type. If the IDoc specified in the "IDOC" Setting needs to be written with a specified custom extension type, provide a valid extension type in addition to the valid IDOC type with which the custom type is associated. The Snap displays an error in the following cases:
Example: ZMATMAS01 OR Z_MATMAS01 Default value: [None] | ||||||||||||
Success codes | Required. This property defines the comma-separated status codes (with a leading 0) that are considered to be successful for the Snap execution.
Default value: 01,03,06,08,10,11,13,14,16,18,22,24,30,32,33,,35,38,39,41,50,53,55,62,64,66,69,70,71,73,75
| ||||||||||||
Polling interval | This property defines the polling interval in seconds for obtaining the IDoc processing status. At each polling interval, the Snap checks the status of the IDoc processing. A value of 0 indicates no polling for the IDoc processing status. Example: 5 Default value: 5 Maximum: 60 | ||||||||||||
This property defines the polling timeout in seconds for obtaining the IDoc processing status. If the timeout occurs while waiting for the status, the Snap displays a SnapExecutionException. Example: 300 Default value: 300 Maximum: 1800 | |||||||||||||
Max request attempts | Required. The maximum number of SAP connection attempts in case of a failure. When 0 is entered, the Snap tries for infinite times for the connection. Default value: 3 | ||||||||||||
Request retry interval | The time in seconds to wait before retrying the request. Default value: 5 | ||||||||||||
Route errors | Writes configuration errors to the error view. If the error is non-recoverable, especially connection errors such as exception handling would be routed to the error view with relevant information. Default value: Not selected | ||||||||||||
|
|
Info | ||
---|---|---|
| ||
To load a new or updated IDoc, the cache needs to be cleared for the Snaplex. Instead of restarting the JCC to access the refreshed metadata, running the following pipeline (download) can help clear the cache. This pipeline informs all nodes in the Snaplex that their respective SAP metadata cache is stale. This action can take a moment to propagate to all nodes in the Snaplex. A Snap in a node, on the next run, will automatically clear the cache for the given node, display the IDoc version, and populate the current schema. |
Examples
We will provide one example that executes an SAP IDoc write operation for a given input.
First we provide the input to the SAP IDoc Write Snap, as defined below.
The SAP IDoc Write Snap is configured as:
Which results in:
Downloads
Attachments | ||||||
---|---|---|---|---|---|---|
|
Insert excerpt | ||||||
---|---|---|---|---|---|---|
|