This article describes how the Workflow Management feature works and how to use it.

In this article:

Table of Contents Placeholder

How It Works

The Workflow Management feature activates a workflow process where all publishes to the Prod require approval. Users without permission to publish to Prod can submit a publish request to Prod for approval by users with permission to publish to Prod. If approved, the changes will go to Prod, otherwise no publish occurs. While a version is pending approval, only approvers will be able to save changes to it. For this reason it is important for submitters to always perform a Save as when publishing to Prod.

Familiarize yourself with the following terms and how they apply to Workflow Management when using this feature:

  • Disabled
    When Workflow Management is disabled (default setting), the Prod publish target is only available to users with permission to use it.
  • Enabled
    When Workflow Management is enabled, the Prod publish target becomes available to any user with either the Publish to Dev or Publish to QA permission.
  • Submitter
    Users that submit requests to publish to Prod are called submitters. When a submitter submits a version to publish to Prod, it is sent to a queue of pending publishes where it must be reviewed before it will actually publish.
  • Approver
    Users with the Publish to Prod permission are notified of the pending request and can approve or decline the submitted version. These users are called approvers.

Workflow

The workflow from submitter to approver is as follows:

  1. A submitter performs a Save as and selects Publish To: Prod.
    The saved changes are not actually published to Prod, but instead are sent to a queue to await review.
  2. An email is sent to all approvers notifying them of the pending publish to Prod request.
  3. Any approver can log into the account/profile to review the pending publish and take one of two actions:
    • Approve – the changes are approved and the version is published to Prod.
    • Decline – the changes are denied and no publish occurs.

Setting Up Workflow Management

The following sections describe how to enable Workflow Management from the Publish Settings screen and then adjust User Permissions by updating user permissions for your submitters and approvers.

Enable Workflow Management

Use the following steps to enable Workflow Management for your profile:

  1. Click Save/Publish.
  2. Click Configure Publish Settings in the upper right corner.
    The Publish Configuration dialog displays. (Learn More)
  3. In Version Workflow section, scroll down to Workflow Management and click On.
    WhiteUI_TiQ_PublishWorkflowManagement_Publish Configuration Dialog.png
  4. Click Save.
    The Save/Publish dialog displays.
  5. Click Save As.

    It is important for the approver that the submitter uses Save As versus Save. If the submitter selects Save, the current version becomes locked for all submitters.

  6. Enter a new title and descriptive notes.
  7. Click one or more publish environments.
    WhiteUI_TiQ_PublishWorkflowManagement_SaveAs_Publish.png
  8. Click Publish.

Adjust User Permissions

The workflow process is dependent on two types of users: submitters and approvers. The following sections describe how to adjust user permissions for each type of user.

Submitter Permissions

Submitters are users that cannot publish directly to Prod. Their changes must be approved through the workflow process. Submitters must have the Publish to Prod Environment permission removed. The Publish to QA Environment and Publish to Dev/Custom Environment settings should remain checked.

Use the following steps to adjust user permissions for a submitter:

  1. Expand the user drop-down list in the upper right corner, and click Manage Users.
    The User Manager dialog displays. (Learn more).
  2. Click a checkbox to select an existing user or add a user and click Edit/View User Permissions.
    WhiteUI_TiQ_PublishWorkflowManagement_ClickEditViewUserPermissions.png
    A new dialog displays.
  3. Click the Select Profiles radio button and leave the default value of the current profile in the profile list.
    WhiteUI_TiQ_EditViewUserPermissions_SelectProfiles_EditProfileList.png
  4. Click Next.
  5. Ensure that Publish to Dev/Custom Environment and Publish to QA Environment remain checked.
  6. Uncheck Publish to Prod Environment and then click Next.
    WhiteUI_TiQ_PublishWorkflowManagement_EditViewUerPermissions_Uncheck Publish to Prod.png
  7. Click Finish.
  8. Click Close to close the Edit/View User Permissions dialog.
  9. Save and Publish your changes.

Approver Permissions

Approvers are users that can publish directly to Prod and are responsible for reviewing pending publishes to Prod. Approvers must have the Publish to Prod Environment permission enabled. Due to the fact that all approvers receive email notifications each time a request for publish is submitted, it is best to limit the number of approvers in your profile.

Use the following steps to adjust user permissions for an approver:

  1. Expand the user drop-down list in the upper right corner, and click Manage Users.
    The User Manager dialog displays. (Learn more).
  2. Click a checkbox to select an existing user or add a user and click Edit/View User Permissions.
  3. Click the Select Profiles radio button and leave the default value of the current profile in the profile list.
  4. Click Next.
  5. Check Publish to Prod Environment and then click Next.
  6. Click Finish.
  7. Click Close to close the Edit/View User Permissions dialog.
  8. Save and Publish your changes.

Workflow Example

Once you have enabled Workflow Management and set the publish permissions for your users, you are ready to see it in action. The following example shows the workflow process when Workflow Management is enabled.

Submitting a Publish Request

When a submitter makes changes, they save and publish to the Dev and QA environments freely and then an approver approves the change and published to Prod.

A submitter uses the following steps to submit a request to publish to Prod:

  1. When changes are complete, click Save/Publish.
  2. Click Save As.
  3. Enter version notes.
  4. From the Publish Locations, select Prod - Approval Required

    prod_approval_required.jpg

  5. Click Publish.
    A red box displays next to the Save/Publish button indicating that the publish is pending approval.
    Approver Request.png
    After a Save as and a request to publish to Prod has been sent, submitters may no longer make changes to that pending version until the request has been approved or declined.

Approving or Declining a Publish Request

After a user has submitted a publish request, all approvers receive an email similar to the following regarding the request. Follow the instructions in the email and then navigate to the console to review the request.

WhiteUI_TiQ_PublishWorkflowManagement_TealiumIQNotification for Approver.png

Use the following steps to approve or decline a publish request:

  1. In the sidebar, go to iQ Tag Management.
  2. Click the red box next to the Save/Publish button indicating the number of publish requests awaiting your review.
    The pending requests dialog displays.
  3. Click an entry to approve or decline.
    The publish notes and action buttons display.
  4. Mouse-over a the request to view the version notes.
    Approving_Request.png
  5. Click Approve or Decline.
    • If you click Approve, the Save/Publish window displays and prompts you to save and publish as normal. Ensure that you select the Prod environment before publishing.
    • If you click Decline, the request is declined and an email is sent to the requestor for further action.
  6. Click Close.