Example Workflow Builder Walkthrough
In this example, we are going to build a workflow that is initiated when a user creates, copies, or edits an asset, which an Administrator must then edit, approve and publish, send back to the initial user for editing, or delete.
- In the Administration area, select Workflow Definitions and then Workflow Builder.
- For the Workflow Name field, type “Example Workflow”.
- The first step listed is the Initialization step. Steps can be added by clicking the plus sign or removed by clicking the minus sign. The order of steps may also by altered by clicking on the up and down arrows.
- The Step Identifier name must be entered in lower case with no spaces. For this first Initialization step, we will keep the default value, “initialize”.
- The Step Label is what the user will see to identify the step in the workflow. We will keep the default value, “Initialization” for this field as well.
- Select “system” for the Step Type. This means that the step is automatically performed in the CMS without user interaction.
- As previously stated, an action is required to move to the next step. Actions may be added by clicking “Add Action” at the bottom right of each step. For this Initialization action, we will keep the default fields for action identifier and action label, “initialize” and “Initialization”, respectively.
- The transition chooser allows you to choose which step will be active upon completion of the current step. We will select the default value, “Next Ordered Step”.
- Because the next step will request the attention of an Administrator, we want to ensure that this user is aware that the asset is awaiting approval. To do this, we will add a trigger to email that user. In the bottom right corner of the initialization action, select “email” from the Add Trigger chooser and then click the plus sign.
- The new trigger will appear below the action. Click “Add Parameter”. Parameters can be added or deleted by clicking the plus or minus signs next to each parameter.
- Type “mode” into the name field and “notify” into the value field to tell the system to notify the next user in the workflow.
- The next step in this workflow will be the Administrator Approval step. Type “admin-approval” for Step Identifier and “Administrator Approval” for Step Label.
- Select “transition” for Step Type, which means that this step requires user interaction for its completion.
- This step may be assigned to a user or a group. We will keep the default assignment of the user “admin”.
- Ensure that the box for Allow Reassignment is checked. This allows the initial user to select a user other than admin to approve his or her asset. We will restrict the reassignment choices to those with the Administration role by selecting the corresponding radio button and selecting Administrator from the chooser. Any lower level roles selected will also allow users of higher level roles to be selected for reassignment.
- Type “admin2” in the box for “Escalate To” and choose “72” and “hours” for the “Escalation Period” data. This means that this step will be automatically reassigned to the user “admin2” if the originally selected user has not responded to this step after 72 hours.
- We will add an action to this step to reject the asset to the initial user. For the action below this step, type “reject-to-initial-user” for Action Identifier and “Reject to Initial User” for Action Label.
- Select “assignToWorkflowOwner” for Add Trigger and click the plus sign.
- Because of the various possible results of the Administrator’s action, we will need to create Unordered Steps. Scroll to the bottom on the page and click “Add Unordered Step”.
- Type “edit-by-initial-user” for Step Identifier and “Edit by Initial User” for Step Label.
- Select “edit” for Step Type, to indicate than only an edit may be performed.
- Select User for Default assignment and click on the user icon to select the user name of the original content author. In our case, we will select “simple”.
- Check the box for “Allow Reassignment” and select the radio button next to group. Click the group icon and select “marketing”. This step may now be reassigned to anyone in the Marketing group.
- Click Add Action on this step.
- After the asset has been edited by the initial user, we want to send it back to the Administrator for approval again. Type “send-back-for-approval” for Action Identifier and “Send Back For Approval” for Action Label.
- Select “Administrator Approval” from the Transition chooser to return to that step upon the completion of the edit.
- Add another email trigger for the Administrator just like the previous one, with “mode” for name and “notify” for value.
- Scroll back up to the Reject to Initial User Action under the Administrator Approval Step. Choose the newly created unordered step, “Edit by Initial User” from the chooser for Transition.
- We want to add a second Unordered Step to allow the Administrator to have the option to edit the asset directly. Scroll back down to the Unordered Step that was just created and click the plus sign in the upper left corner to add another step.
- Type “admin-edit” for Step Identifier and “Administrator Edit” for Step Label.
- Choose “edit” for Step Type and User for Default Assignment. Click the user icon and select “admin”.
- Click Add Action. We will again transition to the Administrator Approval Step.
- Type “send-to-approval” for Action Identifier and “Send To Approval” for Action Label.
- For Transition, select Administrator Approval. Because the Administrator just edited the asset, he or she knows it needs to be approved, so we do not need to set up an email trigger.
- Scroll back up to the Administrator Approval step and add another action to transition to the Unordered Step that was just created.
- For Action Identifier, type “go-to-admin-edit”. For Action Label, type “Go to Administrator Edit”. Choose the step Administrator Edit from the transition chooser.
- We will now add another action to the Administrator Approval step for content approval. Click Add Action and type in “approve” for Action Identifier and “Approve” for Action Label.
- Choose “Next Ordered Step” for Transition.
- One final action is needed for this step to allow the Administrator to delete the asset. Click Add Action once again and type “delete” for Action Identifier, “Delete” for Action Label, and choose “Finished” for Transition.
- Once the asset has been approved, it must go through a Finalizing step, which will merge it into the system, before it can be published. Scroll down to see that the Finalizing step is automatically set up next with default values in the Workflow Builder, including a Finish Workflow action with Merge and Email triggers. The completion of the Finalizing system step will trigger the Publishing step, which is also already set up with default values and a Completed action with Publish and Email triggers. We can leave all of the values for the Finalizing and Publishing steps as they are pre-set in the system.
- The final default step in the Workflow Builder is the Finished step. Every workflow must have a Finished step to indicate that all steps, actions, and triggers in the workflow are finalized. The asset associated with the workflow is then no longer to be considered in workflow any longer and is returned to a normal state.
- Now that the workflow is complete, scroll to the bottom of the page and click Submit.
- You will be forwarded to the main Edit Workflow tab where you may enter the name, location, and applicable groups.
- For Workflow Type, check the boxes for Create, Edit, and Copy.
- For Instance Name, select the radio button for Auto-name.
- Select all groups under Applicable Groups and click the arrow to move them into the selected box.
- On this screen, advanced users may also directly edit the XML for the workflow or upload an XML file. Click Submit to save your new workflow.
Videos
Last modified on Mon, 17 Sep 2007 10:15:15 -0400
Top / Previous / Up / Table of Contents