Altova MobileTogether Designer

Progress Update

Home Prev Top Next

The Progress Update action (see screenshot below) is used (i) to pass a value to the $MT_Progress variable and (ii) to trigger the OnProgressUpdate event of subpages that have been designed to show the progress of server actions.

MTDProgressAction

The following are the key points:

 

The Value setting is the value that will be passed to the $MT_Progress variable. In the screenshot above, the value that is passed will move from 1 to 10 for each iteration of the loop. In this way, the $MT_Progress variable will continuously hold the current status of the iterations through the loop. While iterating through a loop is straightforward, you must choose, for your set of actions, a suitable value to indicate the progress of the actions.

Bear in mind that each time the Progress Update action is executed, the OnProgressUpdate event of the subpage that will show the progress (see Progress Show Subpage) will be triggered. Each time this event is triggered the value of $MT_Progress will contain the current value supplied by the Value setting of the action.

The Limit Update Frequency setting sets the number of milliseconds between updates that trigger the OnProgressUpdate event of the subpage. If the action is expected to be executed with a high frequency, then this setting can specify that only those that occur at the specified frequency will trigger the OnProgressUpdate event of the subpage. For example, if the action is expected to be executed five times a second (or once every 200 ms), then you can set this option to 1000 ms so that the update is sent only once every second.

 

See the Progress Indicator tutorial for an example of how to use this action.

 

MobileTogether extension functions

MobileTogether provides a range of XPath extension functions that have been specifically created for use in MobileTogether designs. Some functions can be particularly useful with specific actions. For example, mt-available-languages() returns the languages in which the solution is available and could, for example, be used with the Message Box action. If a function is especially relevant to this action, it is listed below. For a full list of extension functions and their descriptions, see the topic MobileTogether Extension Functions.

 

© 2018-2024 Altova GmbH