Use of Function: DialogBox

The function DialogBox displays a message, the buttons included in the dialog are controlled by an argument.

Syntax: DialogBox(Style, Title, Body[, Body])

Style (determines the buttons displayed; one of the following macros):

• M4_BTN_OK
• M4_BTN_OK_CANCEL
• M4_BTN_ABORT_RETRY_IGNORE
• M4_BTN_YES_NO_CANCEL
• M4_BTN_YES_NO
• M4_BTN_RETRY_CANCEL

Return value (one of the following macros):

• M4_OK
• M4_CANCEL
• M4_ABORT
• M4_RETRY
• M4_IGNORE
• M4_YES
• M4_NO

Note: For multiple language support use the function GetErrorString to identify the title and body.

Note: For execution in server, the function assumes the result M4_OK. However, make sure you use the function only in client.

[Workflow] With Deadline

A deadline is the date (with timestamp) by which the task must be completed. If the deadline is reached, the instance of the workflow expires.

A deadline can be defined at level of the workflow or at level of a status. The deadline can be defined either as an absolute date or relative to the instantiation of the workflow, the instantiation of the status or a variable.

If the deadline is reached, the instance of the workflow is cancelled automatically; the task(s) disappear form the active to-do list and the instance is shown in the workflow manager as finished (if positioning on the instance, the last active status is highlighted).

In case of a deadline defined at workflow level, an alternative workflow can be indicated that is instantiated when the deadline is reached (the current instance is cancelled and a new instance of the alternative workflow is instantiated).

In case of a deadline defined at status level (see image), an alternative transition can be indicated that is "fired" when the deadline is reached (the current status is cancelled and the status linked to by the alternative transition becomes active).

Note: If the state has a deadline associated, the number of days for the task to become critical can be defined.

Note: The concept of Workflow/Transition Associated to Cancellation is new in version 7.1 SP002 (of technology).