State (Workflow)

images/download/attachments/78259364/Zustand_Diagramm__EN.png

A state can have a form.

If a waiting time is set in the state, the workflow job is ended when this time is exceeded. Before that, (local) final actions can be executed.

If the transition check is triggered, a transition to a subsequent state is searched for.

Settings


images/download/attachments/78259364/cc7.png


(1) A language key can be specified here. If it is defined in the dictionary, its value (matching the language in which you logged in) is used instead of the name of the state. The icon on the right can be used to select a key directly from the dictionary.

(2) Here you can specify any URL that contains documentation of this state, which can be called via (3). You can use (4) to insert system constants into the URL.

(5) If this option is used, the system immediately proceeds to the transition check as soon as this state is reached. In this case, no form (6) is used and no user interaction is necessary (recognisable by the dotted boundary line of the state).

images/download/attachments/78259364/Automatischer_Zustand_EN.png

If the first transition check is unsuccessful, it is automatically repeated cyclically, but only if a waiting time is also set and until the waiting time is exceeded (see section below). See also sections Workflow and Automated Workflows (examples).

images/download/attachments/78259364/State_Wait_EN.png

(6) A form can be defined for each state. This is displayed for authorised users when the workflow job is in this state.

images/download/thumbnails/78259364/form_state_x.png

If no form is defined in a state and (5) is not set, the workflow job remains stuck in this state when it reaches it. The transition check must then be triggered externally. This behaviour can specifically be used if you want the workflow job to remain waiting in the background, so to speak. If later a certain event occurs, e.g. the run of a profile, this profile can then trigger the workflow job again. See section Interactive Workflows (examples) (→ sleeping states).

images/download/attachments/78259364/Formular_Zustand_EN.png

Exceeded Waiting Time/Final Actions


If a waiting time is set in the state, the workflow job is ended when this time is exceeded. Before that, (local) final actions can be executed. Note: See workflow variable VAR_SYS_WF_TERMINATED.

In addition, the waiting time can be used for the immediate transition check (5) to continue checking cyclically after the initial check until the waiting time is exceeded.

Start State


The start state is only the first state, the entry point. Otherwise, it is like a normal state (except for the round shape) and can occur in all the variations described above for normal states.

images/download/thumbnails/78259364/start_state_no_form.png

End State


A final state has no outgoing transition. The behaviour of end states is different from that of normal states.

Once an outgoing transition is present, the end state automatically becomes a normal state.

images/download/thumbnails/78259364/end_state.png

State and Subsequent State


As soon as a workflow job changes to a state (when the workflow job is started or after a successfully executed transition of a predecessor state), it remains in this state until a triggered transition check finds a valid transition. The workflow job then changes to the subsequent state connected with this transition. In addition, actions may be executed.