Previous Page Arrow Next Page Arrow

3.11 Tracking Payload

SData defines a standard tracking payload to allow a service consumer to monitor the progress of an asynchronous operation that it has initiated. The tracking payload is always associated with a 202 Accepted status code. It tells the client the operation has been accepted and is in progress. The contents of the tracking payload allows the consumer to feedback the operation’s progress to the user. For example by updating a progress bar.

Here is an example of SData tracking payload:

<tracking xmlns="http://schemas.sage.com/sdata/2008/1" >
  <phase>Archiving FY 2007</phase>
  <phaseDetail>Compressing file archive.dat</phaseDetail>
  <progress>12.0</progress>
  <elapsedSeconds>95</elapsedSeconds>
  <remainingSeconds>568</remainingSeconds>
  <pollingMillis>500</pollingMillis>
</tracking>

The elements of the tracking payload are now described:

Element Description
phase End user message describing the current phase of the operation.
phaseDetail Detailed message for the progress within the current phase.
progress Percentage of operation completed.
elapsedSeconds Time elapsed since operation started, in seconds.
remainingSeconds Expected remaining time, in seconds.
pollingMillis Delay (in milliseconds) that the consumer should use before polling the service again.
SData providers MAY expose asynchronous operations. If they do, they MUST use this tracking payload in their 202 responses.

Previous Page Arrow Next Page Arrow