Progress bar

A progress bar is a graphical control element used to visualize the progression of extended operations. The operation is divided into steps and is accompanied by a textual representation.

To implement a progress bar, add the progressid parameter to the call. You should generate the parameter's value yourself. It should be unique for the session and may contain digits and/or letters (we recommend timestamp).

Call the progress.get function with the elid parameter set to progressid.

The following XML will be returned:

XML:

<doc ...>
  <action>product.install</action>
  <start>1376013950</start>
  <last>1376013971</last>
  <now>1376013974</now>
  <steps>6</steps>
  <done>4</done>
  <comment>Uploading package list</comment>
  <tparams>
    ...
  </tparams>
</doc>

To calculate percents, use values of the steps (total number of steps) and done (number of steps completed) elements. A comment is taken from the comment element.

The start element indicates the time when the operation started, last - when the previous step was completed, now - current request time.