About Task Acknowledgement (ACK) Messages
- Natalie Gesin (Deactivated)
- Kinga Huszno
- Dmitry Donosiyan (Unlicensed)
The Run Task Request can be either acknowledged or rejected by server. The message sent back to user has the following structure:
Elements of XML | Description |
|---|---|
<EagleML
eaglemlVersion="2-0"
eaglemlType="TaskAcknowledgement"
xsi:schemaLocation="http://www.eagleinvsys.com/2011/EagleML-2-0 eagleml-main-2-0.xsd"
xsi:type="TaskAcknowledgement"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.eagleinvsys.com/2011/EagleML-2-0"> | Root Node. Its content is fixed |
<header>
<messageId>B41D0J51DFFIMKCY</messageId>
<sentBy>http://www.eagleinvsys.com/</sentBy>
<sendTo>www.client.com</sendTo>
<creationTimestamp>2014-11-30T08:55:11-05:00</creationTimestamp>
</header> | Message Header section. messageId node must be unique sentBy is a constant sentTo is a constant creationTimestamp – message generation time |
<taskIdentifier>
<correlationId>unique_correlation_id</correlationId>
<businessTaskId>EGLWS_RPT_20141130</businessTaskId>
</taskIdentifier> | Task Identifier section. correlationId is a required node and must be unique businessTaskId is a required node and should describe the task. It can be a constant |
<isNegative>true</isNegative> | Task EJM status. If the value is “true”, current EJM Task is not started and the failure reason is described in the next section. |
<reason>
<reasonTypeEnum>ERROR</reasonTypeEnum>
<reasonCode>1</reasonCode>
<description>Attempt to insert duplicate correlation ID 'RPT_20141130'. The value has been adjusted to 'RPT_20141130_DUP1'.</description>
</reason> | Reason Section. reasonTypeEnum is a constant reasonCode is a number, representing error code description contains error details |
The most important elements are <isNegative> and <reason>, as they carry the information about acknowledgement status and the reason for its rejection in case it was rejected.