About Workflow Status Definitions

Workflow status definitions are defined in message keys and are used in a Task Sequence document.

Workflow status definitions are created in a copy of the webform iReviewMessages_enUS in the Messages folder, located in the

Administration cabinet. These definitions populate fields in Task Sequence documents you customize for workflow definitions.

Important: Do not modify the Astoria-supplied message documents. Any changes you make are subject to being replaced the next time your system is upgraded. Instead, make a copy of the webform to customize for your organization.

A pair of Message Keys in the webform contain message strings listing the series of workflow statuses, in order. Statuses are separated by the pipe character (|) with no spaces.

Note: You may create multiple message files that contain definitions for the statusChoices and statusChoice Values message keys. However, only the most recent message file controls the message key definitions. There is at most only one value used by the system for a message key.

statusChoices

The statusChoices message key string displays the Current Status and New Status choice fields in dialogs connected to changing workflow status.

The first status might be <none>, followed by |. (This displays as <none>.) Next in the string come the statuses, in the general order they occur. For example, the entire string might look like this:

&lt;none&gt;|Edit|Review|Approve|Publish|Translate

statusChoiceValues

The statusChoice Values message key string provides the internal name corresponding to a displayed statusChoices string. These states are not displayed to users. They should never change once they have been defined.

The first status must be initial, followed by |. Using the example string for statusChoices above, the entire message string might look like this:

initial|Edit|Review|Approve|Publish|Translate

Specifying the Order of Status Choice Values

You may wish to specify the order of status choice values, indicating which status choice values are "higher" or "lower" than other choices. This is valid only if your application document's Set workflow status on referenced documents specifies an option other than Off. For details, see Setting Workflow Status on Documents Referenced by a Map.

Note: This feature only has effect when you change status on a topic, not a map.

You can specify the order by including letters and numbers in the statusChoiceValues strings. Since these are internal names, they are not seen by users in dialogs. For example, the entire message string might look like this:

initial|Edit(W1)|Review(W2)|Approve(W3)|Publish(W4)|Translate(W5)