Approval Workflows

Approval workflows adds governance to commentaries submitted on any stream, application or sheet before it is visible to application end users.

The review process can include one or multiple steps of approval, and involve one or multiple users and/or groups. When a commentary is submitted for approval, Qommentary will notify all users involved in the worklow and coordinate the approval process until the author is notified that the commentary has been approved or rejected (with optional comments).

Creating an approval workflow

1. Click on Create button

2. Type in a name and description (optional)

3. Click on Create button

Editing an approval workflow

1. Click on the pencil icon next to the workflow you wish to edit

2. Click on the Edit button

3. Update the required details and click on the Save button

Deleting an approval workflow

1. Click on the Trash icon next to the workflow you wish to delete

2. Click on the Delete button to confirm

Duplicating an approval workflow

1. Click on the pencil icon next to the workflow you wish to duplicate

2. Click on the Duplicate button

3. Rename your duplicated workflow and click on the Create button

Adding resources to an approval workflow

When you create an approval workflow, it acts like a template which you can apply to multiple resources within Qlik Sense. Resources have a hierarchical structure:

+ Qlik Sense (root)
    + Stream
        + Application
            + Sheet

By adding resources to an approval workflow template, you're applying a sign-off process to that resource level which will also be applicable to it's children resources.

Example: Your Finance team uses a Monthly Performance Management application to write commentary on specific KPIs which need explanation. You created a Finance Performance Mgnt Workflow and applied it to the Monthly Performance Management application. You also added the CFO and yourself as the mandatory reviewers.

Now any commentary which is created within the application will go through the sign-off process and will not be publicly readable until the approval workflow has been completed.

Alternatively, if you wish to apply this workflow to all applications published in the Finance stream, you can add the Finance stream resouce to the workflow (instead of the application).

To add resources to an approval workflow, follow these steps:

1. Click on the Add resources button

2. Navigate the Resources Tree and check one or multiple streams, applications or sheets

3. Once you're done, click on the Add button

Currently you can assign one workflow to a resource. Once the workflow has been assigned, the checkbox will be ticked and disabled to other users.

Workflows applied to children resources will take presedence over parent resources.

Removing resources from an approval workflow

1. Edit a workflow from the list

2. Click on the Trash icon next to the resource you would like to remove

Adding steps to an approval workflow

When a commentary is submitted for approval, Qommentary will send email notifications to all users involved in the first step of approval.

Once the first step is approved, if the workflow has a single step of approval, a final notification will be sent to the author and the commentary would be ready to be published. Alternatively, if the workflow has multiple steps of approval, notifications will be sent to all users involved in the next step.

If at any point in time the workflow is rejected, a notification will be sent to the author an the commentary may be recalled and updated before re-submitting for approval.

To add steps to your workflow, please follow these steps:

1. Click on the Add step button 2. Add users and/or groups required to approve the current step

Check the All must approve option if you require all users involved in the current step to approve. By default, the first user who approves the commentary will complete the step.

3. Click on the Add button 4. Repeat the process if you wish to add more steps to the approval workflow