KB Version:

Learning Levels

Most Read

Announcements RSS Feed of Announcements

Create and Associate Workflows

With your site content and formats in place, you can create a specific workflow for content changes. Workflow definitions can be built either visually or by hand using XML. We will create a simple workflow visually. Like data definitions, workflows are defined as XML in the system area. Unlike data definitions, where the XML is transformed by the system to produce a form field in which a user enters data, the workflow definition is used by the system to involve assets in a quality assurance process. The steps below detail how to create and use standard workflows.

create and associate workflows chart

A. Create a Workflow Visually

To create a new workflow visually:

  1. Select Global from the top sites menu.
  2. Go to the Administration area, and select Workflow Definitions in the left navigation bar.
  3. Select the Worflow Definitions/common/1 step/Create Edit Copy workflow and click on the XML pane.
  4. View the source of the XML by right-clicking your mouse on the XML screen, selecting This Frame, and then selecting View Frame Source. Highlight the XML and copy it by pressing Ctrl-C.
  5. Back in the Cascade browser, select web from the top sites menu.
  6. Go to the Administration area, and select Workflow Definitions in the left navigation bar.
  7. Click on New Workflow Definition.
  8. For the Name field, type Edit Asset Workflow.
  9. For the Workflow Type, check Edit.
  10. Select all of the Applicable Groups, and click the green arrow to move them into the box on the right.
  11. For the XML field, press Ctrl-V to paste your previously copied XML.

    edit asset workflow

  12. Click Submit to save the new workflow definition.
  13. Select the Edit in Workflow Builder in the left navigation bar.
  14. You now have a visual interface showing multiple steps. For the second step, change the Step Label to Manager Review. In this interface, you can add and delete as many steps as necessary, assigning the appropriate user to each step.
  15. Click Submit to save the updated workflow.

B. Attach a Workflow Definition to a Folder

With your new workflow created, you need to attach it to a folder.

To attach a workflow definition to a folder:

  1. Go back to the Home area and browse to a folder where you would like the workflow enforced. We will choose our main site folder Base Folder.
  2. Click the Workflows tab.
  3. For the Add Workflow label, click the browse icon and select the workflow you just created – Workflow Definitions/Edit Asset Workflow.

    attach workflow

  4. Click the Submit button to save the changes to the folder.

The workflow definition is now attached to the folder. This means that an action taken on any asset in that particular folder will trigger the workflow process related to that action. For example, if a page is edited in that folder, an ‘Edit’ workflow associated with that folder will be invoked. Unless workflows are turned off at the folder-level or a user has bypass workflow permissions (based on user roles), users may not edit an asset in that folder without it passing through the selected workflow.

To test it out, edit a page in the folder without bypassing the workflow process.

C. Edit a Page without Bypassing the Workflow Process

To edit a page without bypassing the workflow process:

  1. Browse to a page for testing. We will select example.
  2. Click the Edit tab.
  3. Click on Advanced Options, which is located directly above the Submit button, and check the box that says Start Workflow (boxes that are already checked should remain checked). Note that this checkbox only appears unchecked for users with bypass privileges. The checkbox will be inactivated all for other users.

    start new workflow

  4. Click the Submit button to trigger the workflow screen.
  5. If there were other Edit workflows attached to the folder, you would be forwarded to an Available Workflows screen. Since you only have one workflow available, you are immediately forwarded into the Active Workflow screen, which is labeled Start Workflow: Edit Asset Workflow.
  6. In the Workflow Name field, you will see the name of the workflow definition you created. This can be customized to describe this particular workflow. Type My First Workflow.
  7. Click the Submit button to start the workflow.
  8. The server will trigger an email to the next user or group in the workflow process (assuming the SMTP has been previously set up correctly under Cascade Logo-> Preferences -> Email).

Now, if you are logged in as the user admin, you’ll see the new workflow appear on your Dashboard. To go to your Dashboard, click on Home in the top navigation menu. You can click on the new workflow from the dashboard or click on the Workflows tab, and then select the workflow to enter the active workflow screen and finish it.

workflow on dashboard

You can create as many workflow definitions as needed and attach them to different content folders and asset factories. Multiple workflow definitions ensure the right structured approval process takes place for different types of content.

Videos