You are reading the documentation for an outdated Corteza release. 2023.9 is the latest stable Corteza release.

Organizing your Workflows

To help you maintain and expand on larger projects, we have prepared a document outlining the style guide and best practices. In addition to the document, you can use the swimlane swimlane visual element to group steps based on their purpose.

A swimlane swimlane is a purely visual element and does not affect the execution of a workflow. In smaller workflows that perform simple, singular operations (such as notifying administrator about a client sign-up or logging changes) swimlanes do not make much sense and may even reduce the clarity. For larger projects however, swimlanes can be an orderly addition as they help you visually group smaller steps into larger operations and thus allow you to understand what a specific part of the workflow does.

Example

Let’s first build a basic example; on the case record page, we wish to have a button that changes the status of the case from pending to accepted.

organizing 1
Figure 1. The screenshot shows the base workflow definition.

Let us expand the requirement by notifying the related client and the CRM administrator about the change.

organizing 2
Figure 2. The screenshot shows the upgraded workflow definition.

Another great feature is the possibility of tracking the changes using an audit log. To do this, you need to create a new record for the audit log module.

organizing 3
Figure 3. The screenshot shows the upgraded workflow definition.

We could keep going, but I think we can already see that this will become unmaintainable in the future. To help us group steps by their purpose by using a swimlane swimlane.

organizing 4
Figure 4. The screenshot shows the refactored workflow with swimlanes to group operations.