IDoc Acknowledgment
Use the IDoc Acknowledgment activity to update the IDoc status in the SAP system. The IDoc status can be updated for either positive or negative acknowledgments.
The ALEAUD message type along with the basic ALEAUD01 type is used for updating the IDoc status in the SAP system. Even though the ALEAUD01 IDoc supports the sending of multiple IDoc status updates, an ALEAUD01 IDoc is sent for each IDoc, which has to be updated in the SAP system.
General Tab
On the General tab, establish a connection to the SAP system.
The following table lists the configurations on the General tab of the IDoc Acknowledgment activity:
| Field | Visual diff | Module Property? | Description |
|---|---|---|---|
| Name | Yes | No | Specify the name to be displayed as the label for the activity in the process. |
| SAP Connection | Yes | Yes | Select the SAP Connection shared resource when you click
 .
The SAP Connection shared resource establishes connections between the plug-in and the SAP system. If no matching SAP Connection shared resources are found, click Create Shared Resource to create one. For more information, see Creating and Configuring an SAP Connection. |
Description Tab
On the Description tab, enter a short description for the IDoc Acknowledgment activity.
Input Tab
On the Input tab, specify detailed information about the IDoc status that you want to update in the SAP system.
The following table lists the input elements on the Input tab of the IDoc Acknowledgment activity:
| Input Item | Data Type | Description |
|---|---|---|
| idocStatus | String | (Optional) The status of the IDoc that you want to update.
If the value is not populated, the default value is 39 and it can be used for both negative and positive acknowledgments. Other statuses can be used at your discretion or according to the SAP system requirements. For more information, see Implementing Configurations for Acknowledging Outbound IDocs from the TIBCO Environment. |
| statusCode | String | (Optional) The status code of the IDoc that you want to update.
If the value is not populated, the default value is TIB. |
| idocNumber | String | (Required) The number of the IDoc that you want to update. |
| msgType | String | (Required) The message type of the IDoc that needs to be updated in the SAP system. |
| client | String | (Optional) The client in the SAP system for posting the status to the IDoc.
If the value is not populated, the default value of client is the client associated with the specified SAP Connection shared resource. |
| senderPort | String | (Required) The IDoc number that has to be updated in the SAP system. |
| senderPartnerNumber | String | (Required) The sender partner number in the IDoc control record for posting the ALEAUD IDoc to the SAP system. |
| receiverPort | String | (Required) The receiver port in the IDoc control record for posting the ALEAUD IDoc to the SAP system. |
| receiverPartnerNumber | String | (Required) The receiver partner number in the IDoc control record for posting the ALEAUD IDoc to the SAP system. |
| successMessage | String | (Optional) The success message.
If successMessage is mapped to a value, a positive acknowledgment is sent to the SAP system. Note: If the success message specified in this field has more than 150 characters, only the first 150 characters of the success message are displayed in the SAP system.
|
| errorMessage | String | (Optional) The error message.
If errorMessage is mapped to a value, a negative acknowledgment is sent to the SAP system. Note: If the error message specified in this field has more than 150 characters, only the first 150 characters of the error message are displayed in the SAP system.
|
- If you specify values for both the successMessage and errorMessage input elements at run time, a negative acknowledgment is sent to the SAP system.
- If you do not specify values for both the successMessage and errorMessage input elements at run time, no acknowledgment is sent to the SAP system, and the IDoc status in the SAP system is not updated.
Output Tab
On the Output tab, find the IDoc acknowledgment results.
The following table lists the output elements on the Output tab of the IDoc Acknowledgment activity:
| Output Item | Data Type | Description |
|---|---|---|
| TID | String | Displays the TID corresponding to the ALEAUD IDoc used for updating the IDoc status in the SAP system. |
Fault Tab
In the Fault tab, you can find the error codes and error messages of the IDoc Acknowledgment activity. For more information, see Error Codes.
The following table lists error schema elements on the Fault tab of the IDoc Acknowledgment activity:
| Error Schema Element | Data Type | Description |
|---|---|---|
| msg | String | Displays the error message. |
| msgCode | String | Displays the error code. |