Kentico CMS 6.0 Developer's Guide

Using a workflow

Using a workflow

Previous topic Next topic Mail us feedback on this topic!  

Using a workflow

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

This example explains how the workflow process works from the perspective of content editors. It requires the system to be configured as described in Defining a workflow.

 

Creating a new document

 

1. Sign in to CMS Desk as Alice and create a news item in the /News section:

 

News title: My first news item

Release date: <click Now to get the current date>

News summary: Some summary

News text: Some text

Publish from-to: leave the fields blank

 

Click Save. After the document is saved, you can see that there is the ApproveSubmit to approval action displayed in the document menu:

 

devguide_clip0392

 

2. Before we submit the document to approval, we will preview it for a final check. Click Preview in the main toolbar and you will see exactly what the document will look like on the live site. After doing so, go back to the editing form and click the ApproveSubmit to approval button.

 

The document has been moved to the Approval step and it is now waiting for approval by some member of the PR Managers role and Alice can no longer edit it. Also, a notification e-mail is sent to all members of the PR Managers role.

 

Approving the document

 

With the document submitted to approval, we can switch to the PR Manager's perspective and approve it.

 

3. Sign out of CMS Desk and sign in again as Bob. Go to My desk -> Pending. You should see the new document listed as in the screenshot below.

 

devguide_clip1299

 

4. Click the document, which will open it for editing in CMS Desk -> Content -> Edit. You can now preview and optionally edit it.

 

If you were not satisfied with it and wanted Alice to re-work it, you could click Delete Reject to return it back to the Edit step. For the purpose of this example, we will approve it by clicking the Approve Publish button. Once you approve the document, it gets published on the live site. A notification e-mail is sent to Alice so that she knows the document has been published if configured as described in E-mail notification in workflow process.

 

 

 

Tip 1: Approval/rejection comments

 

When you're approving or rejecting the document, you can go to Properties -> Workflow, add additional comments and click Approve.

 

 

 

Tip 2: "Documents waiting for my approval" and "Recent documents"

 

Each user can find a list of documents waiting for their approval in My desk -> Pending.

 

Similarly, the user who submitted the document can see the document status in My desk -> Recent.

 

Archiving the document

 

If you want to archive the document so that it's no longer displayed on the live site, but it remains in the  content tree and in Kentico CMS database, you can go to the Properties -> Workflow dialog of the document and click the Archive button. This can be performed in any workflow step, unless the document is already archived.

 

Workflow history

 

In the Properties -> Workflow dialog, you can also see the workflow history, i.e. a list of all workflow status changes made throughout the document's lifecycle. With each status change, you can see its exact date and time, final workflow step and the user who performed the action and the actual type of action that was performed.

 

devguide_clip0618

 

 

 

Workflow and permissions

 

Once you enable workflow, the user needs to be authorized to edit the document and to manage the document in the give workflow step.

 

The users with permission "Manage workflow" can approve/reject any document in any workflow step, even if they are not authorized for the given workflow step. This permission can be set in the Site Manager -> Administration -> Permissions section, in the permission matrix called Modules: Content.