Deskzilla application allows users to customize the bugs workflow by defining a set of actions which can be applied to a bug or a number of bugs. The actions (for example, Resolve As, Reassign, Close, etc) are defined in the XML file and can be accessed through the Workflow drop-down menu on the Bugs Toolbar.
Below is the explanation of the XML file structure and tags used to define new workflow actions, which will allow you to create new actions and modify the existing ones.
File structure
...
Default Workflow
TBD
Actions
The action tag is used to define the action and its preconditions.
...
Below is the explanation of the action script syntax.
Conditions
| Anchor | ||||
|---|---|---|---|---|
|
Bugs must meet specific conditions to be eligible for the action. These conditions are defined outside the action tags using the condition tag and then used in the action element.
...
| Tip |
|---|
The Workflow.xml file uses the same syntax as the Query Builder for conditions definition, so the statements can be created in the Query Builder and then copied to the XML file. |
Action Script
Action script is provided in the set tags and defines a number of changes that are made to the bug as a result of the action (the action that defines no changes does not make sense, but is valid). Each script element defines which field of the bug is altered and how.
...
When the action is selected from the Workflow combo box the modified field is shown to user in the Action window with its new value and in the read-only mode.
askAddTextElement
| Anchor | ||||
|---|---|---|---|---|
|
The tag adds a text value and is shown as the text box in the Action window.
...
This tag can only be used to add comments to a bug and should be used as shown in the example.
Content of askAddTextElement defines the text box label. Content of checkbox defines the label shown next to the "private comment" checkbox, which defines if the comment is visible to other users. Content of both tags can be filled with any text.
askAddNotEmptyTextElement
This tag is the same as askAddTextElement, but makes the comment mandatory. The action cannot be completed unless the comment is specified.
askReference
| Anchor | ||||
|---|---|---|---|---|
|
This tag prompts a user to select a single enumeration value. It is shown in the Action window as a combo box populated with the possible field values with the editing option disabled.
...
This element supports additional exclude tags which remove the specified values from the values list.
askEditableReference
This tag works as the askReference tag, but allows user to type in new values and is shown as a standard combo box in the Action window where a user can either select an existing value or type in a new value. The exclude tags are not supported for this element.
askString
This tag prompts a user to change the value of the text field when the action is performed by specifying the new value in the text box.
...