Actions are results of a Task which redirect workflows to the next step.
Depending on a task type, actions can be selected by users, or by the automated scripting operations. When an action is taken on a task, Emakin process engine continues to the next step of a workflow.
For an action you can configure following:
Name (Not visible on a diagram)
Name of an action. Name information is not visible to the users, and is only used to identify a task.
Caption
Caption of an action. Captions are shown to the users, and can be localized when it is needed.
Is Hidden ?
Check this field to hide action from users. Hiding an action may be useful for temporary disabling action, or selecting as deadline action to escalate the task.
Follow Action
Check this field to follow the action result. Following action result checks if the next step of a workflow is assigned to the same user, and if the same user is assigned, it automatically opens the next task without redirecting to the user work list.
Validation Group
Name of validation rule groups. Use semicolon ";" to specify multiple groups. If any rule in this group fails, action cannot be selected.
Comment Policy
Manages the comment feature on taking an action. In some cases, like rejecting a form, you can force the user to specify a rejection reason.
Three options are provided for the comment policy:
- Optional lets user decide whether to enter a comment.
- Required forces user to enter a comment.
- Hidden hides the comment panel.
Order
A number value used for ordering actions within other actions. Higher values put an action to last.
For an action you can configure also the following properties to change appearance from the context menu:
Click right mouse button on the action, action design pop-up will be opened. Click on the appearance title, and start changing the action properties.
Icon
Select an icon to show to the user.
Color
Select text color of an action caption.
Background Color
Select background color of an action caption.
Confirmation Message
Enter confirmation message to show to the user when action is selected. If not specified "Are you sure you want to select the action <action caption> ?" text is displayed.
Auto Select Rule
Auto select rule specifies the action to be automatically selected without any user action if the condition is met. Rule condition can be specified as a Decision Table or as a scripting expression.
Auto selecting action with a decision table
Following decision table specifies the selected action, without asking the user if the form field "Department" is set to a "Sales" or an "Accounting" value. All of the other values invalidate the rule.
Auto selecting action with an expression
If FEEL expression is preferred, expression can be specified as:
Same expression can also be written as a javascript expression, as following:
User Select Script
Script to execute just after the action is selected. This script is useful for performing operations after the action is selected.
This script is different from postwork because it runs on the client side, and it has a user context. For example applying a digital signature on the file attachment.
var format = 'X'; // X value is is default. BES, T, C, X, A values also can be used.
AltiKare.Signature.signFiles($Xml.SelectAll('Files/File'), format).then(function(result) {
if (result) {
// result.certificateName contains the name of signer
// result.certificateIssuer contains the issuer of signer certificate
// result.certificateSerialNumber contains the serial number of signer
// result.files.forEach(function(file) {
// file.sourceId contains source file id.
// });
}
$Complete(!!result);
});
Signing basic plain text and fetching the signature file.
AltiKare.Signature.signText('Hello !', true, 'BES').then(function(result) {
if (result) {
// result.certificateName contains the name of signer
// result.certificateIssuer contains the issuer of signer certificate
// result.certificateSerialNumber contains the serial number of signer
// result.files.forEach(function(file) {
// file.id contains the signature file id.
// });
}
$Complete(!!result);
});