DriveWorks Pro 18: Update Form UI [send feedback...]

Update Form UI

The Update Form UI Task will force an update to the form data.

This is useful when Specification Macros consist of more than one potentially long running task.

Using this task will allow some feedback mechanism to be presented to the user after each task is complete. Typically a form would not update until all tasks have finished.

For example a macro that consists of the tasks:

  • Send HTTP Request

    and

  • Copy Folder

Could have the potential for each to take more than a few seconds for each to complete.

Using the Update Form UI task it is possible to inform the user once each of the long running tasks are complete.

For example the tasks added to the macro could appear in the following event flow:

Each Drive Constant task would set the same constant to different values, such as:

  • The first Drive Constant tasks sets the constant to MacroStarted.
  • The second Drive Constant tasks sets the constant to SendHTTPComplete.
  • The third Drive Constant tasks sets the constant to CopyFolderComplete.

A control on the user form would respond to each update of the constant changing to present the user with feedback.

Placing the Update Form UI task after the Drive Constant Value tasks would trigger the recalculation of the form data.

The final Drive Constant Value task does not require a following Update Form UI task, as the form will automatically update once the macro is complete.

Properties

Property NameDescription
TitleChanges the Title (not the name) of the task.

Using the Task in a Specification Macro

This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.

Outputs are only available within Specification Macros. Currently Outputs are not available for Specification Flow.

Status Outputs

This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs in the Task Node Outputs section of Specification Macros Task Node.

The status output navigation is as follows:

Success

  • Form UI was updated.

Success with Warnings

  • N/A - should never get fulfilled.

Failed (one of the following occurred)

  • General failure - Check the specification report for more details.

Table of Contents