Workflow: Streamlining Document Transitions

A workflow in BizzStream Aero serves as an invaluable tool that empowers you to model and streamline your business processes with ease. Combining three key concepts - Transitions, Authorization, and Actions - workflows offer a comprehensive solution to optimize document handling.

Actions: Driving Document Transitions

Smooth transitions between statuses in a workflow are achieved through carefully configured actions. BizzStream Aero provides three types of actions, each designed for specific purposes:

1. User Actions

These actions can be triggered either by a user clicking a button or via REST requests. User actions actively engage users in the workflow, allowing them to initiate specific operations effortlessly.

2. Bulk Actions

Bulk actions are a powerful feature that enables performing actions on one or multiple documents simultaneously. This proves highly beneficial for handling operations in batch mode and streamlining repetitive tasks.

3. Scheduled Actions

Scheduled actions are essential for automating processes based on specific times or intervals. By reducing manual intervention, these actions ensure the timely execution of crucial tasks.

4. Event Actions

Event actions are triggered when an event of a particular type occurs. When an event action executes, the action rules are applied to each document that passes the filter.

Note: When defining the filter, it is possible to use information from the event info by using BizzStream expressions. For example, the filter _id = {{F["invoiceId"]}} uses the field invoiceId from the event's info object.

Each action type comes with a set of required properties that define its behavior within the workflow. Common properties include:

Property	Required	Purpose	Action Type
Label	Yes	This is what the end users see when they view a document.	All
Name	Yes	This is the name of the action in the database.	All
ID	N/A	This is autogenerated and is used to indicate which action should be available in a layout.	All
Success	No	This indicates whether a success message should be shown after the action was run successfully.	User
Transactional	No	If an action is transactional, the complete action will be rolled back if it fails at any point during the action.	Bulk
Active	No	If this is unchecked, the action will not run at all.	Scheduled, Event
Filter	No	The action will only affect documents that pass the filter.	Scheduled, Event
Timezone	No	This determines the time zone that should be applied to the action. If this is not set, UTC will be applied.	Scheduled
Schedule	No	This determines the specific time (or frequency) an action should run.	Scheduled
Event type	No	The type of the event that triggers an event action.	Event

Creating a Workflow

To create a workflow, you can leverage the workflow editor and the statuses configured in the Statuses & Permissions tab. Follow these simple steps:

1. Drag and drop one or more statuses from the left-hand side section onto the canvas.
2. Similarly, drag an action from the left-hand side section onto the canvas. As you do so, the properties pane on the right will automatically open.
3. Provide a descriptive Label for the action that will be visible to users. The Name will be generated automatically after you leave this field.
4. Click Save to finalize the action creation, and the properties pane will close.
5. Click on a status to select it.
6. Establish a connection between the status and the action by clicking on one of the black squares on the border of the status and drawing a line to the action. This connection ensures that the action will be available to users for documents in the status to which it is connected.
7. To create a transition, select the action and click on one of the black squares on its border. Then draw a connection to another status. This connection ensures that the document will be updated to the connected status after the action completes.

Action Rules: Enhancing Workflow Logic

To further enhance the logic of your workflow, you can add action rules to your actions. These rules enable you to define specific conditions under which an action should be executed. Here are some common properties of action rules:

Property	Required	Purpose
Label	No	This is what the end users see when they view a button in a layout.
Description	No	A text that describes the purpose of the action. This allows administrators to add notes to an action that describe the administrator’s intent.
Execute Condition	No	Using BizzStream expressions, conditions can be created to dynamically determine whether or not an action should be executed.

Available Rules per Action Type

Different types of actions support a variety of rules, allowing for fine-grained control over workflow processes:

Rule	User Actions	Scheduled Actions	Bulk Actions
Save Document	✓
Delete Document	✓		✓
Show Notification	✓
Send Push Notification	✓	✓	✓
Set Field Value	✓	✓	✓
Execute Script	✓	✓	✓
Render PDF	✓
Save PDF	✓	✓	✓
REST Call	✓	✓	✓
Send Email	✓	✓	✓
Go to URL	✓
Confirm Dialog	✓
Terminate	✓
Export Documents			✓
Import Documents			✓
Emit Event	✓	✓	✓

Permissions on actions

Viewing and editing of data in BizzStream documents is restricted by permissions set in access groups. For executing actions it is also possible to configure permissions in the workflow. In order to configure action permissions, you double-click the button on the connection between a status and an action. In the properties pane you can then select the user groups or access groups that can execute the action.

• For bulk actions you can select which user groups should be able to execute an action (i.e. click the button).
• For user actions you can select which access groups should be able to execute an action.

Tips

In the workflow editor there is plenty of space to build your workflow. For the best experience, take note of the following:

• You can zoom in and zoom out by scrolling in the workflow editor, using a pinch gesture on your track pad, or simply clicking the or buttons in the bottom-left corner of the workflow editor.
• To move within the editor, simply click and drag your cursor across the workflow editor.
• You can center your workflow in your view by clicking the button. The workflow editor will center your workflow and adjust the zoom level to fit it into view.
• To prevent accidentally moving statuses or actions around, you can lock/unlock the workflow. You can do this by clicking the button. Note that you will still be able to open the properties pane to configure permissions and actions.