Page History

 

Anchor
top top

A workflow determines the state(s) that a content item can have. The state of a content item determines whether it is visible on the frontend of your website, whether it can be edited and by whom, and so forth. A workflow also determines the order that states can be moved through. For example, consider the simple workflow "Planned - Published". When a content item is first created, it is in the "Planned" state. Content items in the "Planned" state are not visible on the website frontend. When the workflow state of a content item is changed from "Planned" to "Published", it becomes visible on the website frontend. Depending on your organization, you might want to create more complicated workflows that add intermediate steps such as "Ready for Review", "Review in Progress", "Review Completed" and so forth. As content items pass through different workflow states, specific roles have specific rights to modify a content item's settings and/or content. A workflow model also defines the order that the states must be transitioned through. For example, it can enforce the condition that a content item can only move from the "Planned" state to the "Ready for review" and not directly from "Planned" to "Published".

A workflow activity can have conditions assigned to it. A condition defines the properties a content item must have or the conditions it must meet in order to be able to transition from its current state to the following state. For example, you can add define the condiction condition that a content item must have a title before it can go from the "Planned" state to the "Published" state.

You can apply a workflow to content items of the following types:

• Page
• Page section
• Content repository Repository items
• Interactive Forms

 

 

In This Topic

Table of Contents
maxLevel 2 minLevel 2

 

 

...

Workflow Repository Model Versus Workflow Model

A single workflow can be used for different parts of a website, however, these parts may be maintained by different user roles. For this reason, you can define a kind of a generic workflow template, which is referred to as the "workflow repository model". At the outset, this template is not yet related to any user roles, pages, page sections or Content Repository items. From the workflow, you can create one or more workflow models. A workflow model does have user roles and has been assigned to one or more pages, page sections or , Content Repository items or forms. In a parent/child page hierarchy, you can specify whether the child pages inherit their workflow model from the parent page or whether they use another workflow model.

...

• Which activities exist within the workflow. An activity determines what actions can be performed within it, for example : creating a new page or modifying an article, for example.
• What the initial activity of a new page, page section, and Content Repository or form is ("Planned", for example).
• Which permissions are available for each activity. For example, an activity such as "Maintain planned object" allows for pages, page sections, Content Repository items and articles forms to be modified.
• The states the workflow contains.
• The actions the workflow contains, for example what activity the workflow transitions from when moving from one status to another.

...

The workflow model is assigned at the level of the content item. At this level, it also determines which roles are allowed to perform specific activities. Because items in the Content Repository are unstructured, individual Content Repository items of the same type, such as an article, each use a different workflow model. The workflow model "Planned - Published" comes standard with XperienCentral. It is possible to change this workflow model or to add new workflow models.

...

1. Navigate to Configuration > Workflow.
2. Click [New]. The message "Workflow is invalid. No activities defined" appears. You can ignore this message because the activities will be created in the following steps.
3. Enter a meaningful name in the "Name" field and then click [Apply].

Back to top 

...

States

A state is the position the content item is currently in. In XperienCentral the state of an object is either "Public" or "Not public". The list of current states appears in the "States" section:

 
Image Removed Image Added

When an object is in a "Public" state, it can be visible on the frontend of the website. When it is in a "Not public" state, it cannot be visible on the frontend of the website.

...

1. Select the "Delete" checkbox next to the state you want to delete:
   Image Removed
   
   Image Added
   
   
   
2. Click [Apply]. The state is deleted.
   
   

Back to top

...

Activities

An activity is a single step in a flow of activities, which, as a whole, is identified as a specific process within an organization. Examples of activities are "insert create new article", "delete page" and "review article". Each activity has a set of permissions assigned to it. Roles may be attached to activities in order to determine which roles are authorized to perform that specific activity. Multiple roles can be attached to an activity.

...

1. Click [Add New Activity]. The new activity will appear at the bottom of the list of the workflow model.
2. Enter a meaningful name for the activity in the "Activity Name" field.
3. In the "Permissions" section, select a permission from the drop-down list. These are the permissions that this activity is allowed to perform.
4. Click [Apply]. The permission ise added to the list. For example:
   
   Image Added
   
   
   
5. Repeat the steps above for each permission that you want to grant the activity. The permissions are added to the list. For example:
   Image Removed
   
   
   

Deleting Activities

To delete an activity, click [Delete] to the right of the activity name:
Image Removed follow these steps:

1. Select the "Delete" checkbox next to the activity you want to delete. For example:
   
   
   Image Added
   
   
   
2. Click [Delete]:
   
   
   Image Added
   
   
   The activity is deleted.

Back to top

...

Actions

Actions determine the flow between statuses. When the status of a content item is changed from one to another, an action determines which activity becomes the new active activity. When the new activity becomes active, its set of permissions determines what tasks can be performed on content items. With every state change, a content item becomes subject to a new activity. An activity may have multiple subsequent activities, but only one activity can be chosen as the next step in the workflow. A workflow action defines a source activity, a destination activity and the condition of the transition. Workflow actions are defined in the "Actions" section of an activity, where the source activity is the current activity, the destination activity is the "Go to activity" and the condition is the "When changed to the status" field.

...

1. Click [New Action].
2. Select a state in the "When changed to status" drop-down list.
3. Select an activity from the "Go to activity" drop-down list.
4. Click [Apply]. For example:
   Image Removed
   
   Image Added
   
   
   

Deleting Actions

To delete an action, follow these steps:

1. Select the "Delete" checkbox next to the action you want to delete. For example:
   Image Removed
   Image Added
   
   
2. Click [Apply]. The action is deleted.

Back to top

...

Conditions

A condition controls defines the circumstance(s) under which a content item is allowed to go transition from one workflow state to another. The condition is based on a specified specific property or condition belonging to a content item. For example, a condition can prevent a content item from going transitioning from the "Planned" to the "Published" state if it does not have a title or if it does not have an expiration date assigned to it. A condition can be global and apply to all content types or you can select the specific content type to which it applies.

...

1. Click the "Conditions" link or [New Condition].
2. Select the content type that the condition applies to from the drop-down list.
3. Select the condition from the drop-down list.
4. Click [Apply]. The "Conditions" link will change to reflect the number of conditions that have been defined. For example:
   Image Removed
   
   Image Added
   
   
5. Repeat the above steps for each condition you want to add.
   
   

Deleting Conditions

To delete a condition from an action, follow these steps:

1. Select the "Delete" checkbox to the right of the condition. For example:
   Image Removed
   Image Added
   
   
   
2. Click [Apply]. The condition is deleted.

Back to top

 

...

Copying a Workflow

It is possible to copy a workflow. This is useful in cases where you want to create a new workflow that differs slightly differs from an existing workflow. This allows you to quickly and easily duplicate all activities, states, conditions, and so forth within a workflow and then modify the parts of it that you want to. To do so, follow these steps:

1. Select the workflow that you want to duplicate from the workflow repository model drop-down list. The properties of the workflow appear below.
2. Click the [Copy] button to the right of the drop-down list. A copy of the workflow is created. By default the name is "Copy of [name of workflow]".

Back to top

...

Publishing the Workflow

Select "Is published" when the workflow is completely configured so you can start applying the repository model to content items.

Back to top 

...

Workflow Example

In this section, an example workflow is created containing the following states:

• Planned (Nonnon-public)
• Ready for review (Nonnon-public)
• Reviewed (Nonnon-public)
• Published (Publicpublic)

This figure is closely related to the state transition figure above, however, instead of states, this figure shows the activities for each state.


Image Added
Image Removed  

The activities are:

• Maintain Planned Object — used for content items that have just been created and still need to be completed. These content items are invisible to the website visitors.
• Maintain Ready for review Object — used for content items that need to be approved by the reviewer. These content items are invisible to the website visitors.
• Maintain Reviewed Object — used for content items that have been approved by the reviewer. These content items are not visible to the website visitors.
• Maintain Published Object — used for content items that have been approved by the main editor. These content items are public and are visible to the website visitors.

...

• Assign a workflow to an object (page, page section or Content Repository item).
• Add roles to activities.

Back to top 

...

Troubleshooting

This section describes the common errors that can occur while working with workflows.

...

Error message: Workflow is invalid. No activities defined
How to solve: No activities have been created yet. This message will disappear when activities have been created. Back to top

 

Publishing the Workflow

Select "Is published" when the workflow is completely configured, so you can start applying the repository model to content items. 

Back to top