43 Working with Workflow-Enabled Content

WebCenter Portal: Spaces includes the following types of workflows:

• Internally-defined workflows, available through the Worklist service, are discussed in Chapter 70, "Working with the Worklist Service." For example, space moderators receive a workflow notification in their worklists for space subscription requests, or when a new file is checked in or uploaded to the space. The Oracle Fusion Middleware Installation Guide for Oracle WebCenter describes how to install and configure internally-defined workflows for Spaces.

• Externally-defined workflows enabled in a Workflow server that comes with Oracle SOA Suite, also available through the Worklist service discussed in Chapter 70, "Working with the Worklist Service." The definition of these workflows is an administrative or development task in Oracle SOA Suite.

• Workflows defined on space folders that reside in Content Server. When a folder is assigned a workflow, any file (including wiki documents and blog posts) checked in or uploaded to that folder must be approved or rejected by one or more assigned approvers. Documents service task flows, Content Presenter, and the Oracle Workflow Queue portlet from the Universal Content Management Portlet Suite provide access to the workflow-enabled content. This chapter discusses this type of workflow.

  See Also:

  For more information about working with workflows in the Content Server user interface, see the "Working with Workflows" chapter in Oracle Fusion Middleware User's Guide for Oracle Content Server.

The following sections describe how to work with workflows on content in a space:

• Section 43.1, "What You Should Know About Content Workflows"

• Section 43.2, "Assigning a Workflow to a Folder in a Space"

• Section 43.3, "Viewing Files in Workflow"

• Section 43.4, "Viewing Workflow Status and File Information"

• Section 43.5, "Changing or Deleting a Workflow"

• Section 43.6, "Participating in a Workflow"

Audience

This chapter is intended for Spaces users who want to assign and manage workflows on folders in a space when the connected content repository is Content Server.

You must have Document Administration permission to define workflow settings. For information about roles and permissions, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

43.1 What You Should Know About Content Workflows

Workflows on content in Spaces are available only when the connected content repository is Content Server and your Spaces administrator has completed the prerequisite configuration.

See Also:

For more information, see:

• "Content Server Prerequisites" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal

• "How to Create a Content Repository Connection Based on the Content Server Adapter" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter Portal

A workflow provides for review and approval of a file before it is released to the system. The workflow notifies approvers through mail messages when they have a file to review and approve.

In Spaces, you can define workflows by assigning a workflow to a folder in a Documents service task flow. Out-of-the-box, Spaces includes three workflow types that you can assign to space folders (see Section 43.1.1, "Understanding Workflow Types"). These seeded workflows are available only to a folder in a space. They are not available to your personal folders in the Home space.

Once you assign a workflow to a folder in a space, Spaces automatically assigns the workflow to every file subsequently checked in or uploaded to the folder. Documents service task flows, the Content Presenter task flow, and the Oracle Workflow Queue portlet from the Universal Content Management Portlet Suite provide access to the workflow-enabled content.

In all Documents service task flows, any user with privileges to view the contents of a folder that is assigned a workflow can view the files while they are in a workflow, showing the pending changes. Content Presenter allows you to view both the published version of a content item (not showing the pending changes), and the pending changed version while it is in workflow. REST APIs, on the other hand, show only the published version of a file, and do not show the pending changes in unreleased versions of files that are in workflow.

The following sections provide conceptual information about workflow on files in Spaces:

• Section 43.1.1, "Understanding Workflow Types"

• Section 43.1.2, "Understanding Workflow Steps"

• Section 43.1.3, "Understanding Workflow Process"

43.1.1 Understanding Workflow Types

Spaces provides three built-in workflows for content in a space. These are single-step workflows that allow one or more approvers to approve, reject, or edit a file in workflow:

• AllApprover: A single-step workflow that requires all assigned approvers to approve the document to release it from workflow. Approvers of this workflow type are not able to edit the file while it is in worfklow.

• AllReviewer: A single-step workflow that requires all assigned approvers to approve the document to release it from workflow. Approvers of this workflow type may optionally edit the file.

• SingleApprover: A single-step workflow that requires only one assigned approver to approve the document to release it from workflow. Approvers of this workflow type are not able to edit the file while it is in workflow.

Note:

The seeded workflows are available only to a folder in a space. They are not available to your personal folders in the Home space.

For more information about configuring Content Server to enable the built-in workflows, see "What You Should Know About the WebCenterConfigure Component" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.

43.1.2 Understanding Workflow Steps

The three workflows provided with Spaces (AllApprover, AllReviewer, and SingleApprover) each contain a workflow contribution step and an approval step. Different users will typically participate in each of the steps.

Table 43-1 Workflow Steps

Step Type	Description
contribution	This is the initial step of a workflow. In this step, the user who participates as the contributor is the Spaces user who submits the document or edits an existing document in a folder that has workflow enabled on it.
ApprovalStep	In this step, approvers can approve or reject the file. Editing is allowed by an approver during this step only if the workflow contains the step review the current revision or create new revisions' (in the seeded workflows, this applies only to the AllReviewer worfklow).

43.1.3 Understanding Workflow Process

The workflow process is as follows:

1. A document enters the workflow approval step by exiting the initial contribution step as a result of a new document upload or editing an existing document that was previously uploaded into a workflow-enabled folder. See Section 43.1.2, "Understanding Workflow Steps."

2. If any approver rejects a revision, it goes back to the most recent contribution step for editing.

3. When approvers approve a revision in the workflow, the content item is released to the system.

43.2 Assigning a Workflow to a Folder in a Space

With appropriate permissions (the Spaces administrator, or space members with Manage Configuration permissions), you can assign a workflow to a folder in a space when the connected content repository is Content Server. Once you assign a workflow to a space folder, Spaces automatically assigns the workflow to every file subsequently checked in or uploaded to the folder.

Out-of-the-box, Spaces includes three workflow types that you can assign to space folders (see Section 43.1.1, "Understanding Workflow Types"). These seeded workflows are available only to a folder in a space. They are not available to your personal folders in the Home space.

If you create a subfolder in a parent folder that is assigned a workflow, the subfolder automatically inherits the workflow assignment of the parent folder.

To assign a workflow to a folder:

1. On the Documents page or in a Documents service task flow in a space, create a new folder (see Section 41.7, "Creating a Folder"), or click in the row of an existing folder.

   Note:

   The Documents page is exposed in a space only with Content Server 11g. If the connected content repository is Content Server 10g, you can create a page in a space and add Documents service task flows to the page (see Section 41.4, "Adding a Documents Service Task Flow to a Page").

2. Click the View menu and choose Details, or right-click to display the folder's context menu and choose Details.

   The Basic properties pane for the folder opens (Figure 43-1).

   Figure 43-1 Folder Properties

   
   

3. From the File menu, choose Workflow Settings.

4. In the Workflow Settings dialog, select from the Workflow Name list (Figure 43-2) to apply a workflow to the folder.

   Note:

   The selections in the Workflow Name list are preceded with the Spaces installation name used during the installation procedure.

   Figure 43-2 Workflow Settings Dialog

   
   

   For information about the out-of-the-box workflows, see Section 43.1.1, "Understanding Workflow Types." Additional workflows may be listed if they have been defined in Content Server and added by the system administrator. For more information about defining workflows, see the "Working with Workflows" chapter in Oracle Fusion Middleware User's Guide for Oracle Content Server.

5. After selecting a workflow name, click Add Approvers (Figure 43-3).

   Note:

   Spaces does not support group names as approvers.

   Figure 43-3 Workflow Settings Dialog

   
   

6. In the Select User window, search for and select a user to whom to assign the workflow. Click OK. Repeat for all required approvers.

7. In the Workflow Settings dialog, click OK to save the workflow.

Every assigned approver receives a mail message to notify them that they are assigned to the workflow as document approvers. The format and contents of the mail message are controlled by how the system administrator installed and configured the Content Server.

With a workflow established on a folder in a space, Spaces automatically enters every file that is subsequently checked in or uploaded to the folder into workflow. If you want to assign the workflow to a file that was already in the space prior to the workflow being defined, you can save the file to your local file system, delete the file from the space, then reupload the file into the folder so that the file can inherit the workflow properties of the folder. See Section 41.8.1, "Uploading Files."

A workflow icon alongside a file in a Documents service task flow indicates that the file is assigned to a workflow (Figure 43-4). For more information, see Section 43.3, "Viewing Files in Workflow." Note that the only way to determine if a folder has a workflow defined on it is to view its workflow settings, as describedin the steps above.

Figure 43-4 Workflow Icon

43.3 Viewing Files in Workflow

You can view files in workflow and view workflow details in a Documents service task flow, Content Presenter task flow, or in an Oracle Workflow Queue portlet:

• Section 43.3.1, "Viewing Workflow Files in a Documents Service Task Flow"

• Section 43.3.2, "Viewing Workflow Files in a Content Presenter Task Flow"

• Section 43.3.3, "Viewing Workflow Files in a Workflow Queue"

43.3.1 Viewing Workflow Files in a Documents Service Task Flow

On the Documents page or in a Documents service task flow in a space, a workflow icon alongside a file in a Documents service task flow indicates that the file is assigned to a workflow (Figure 43-5).

Figure 43-5 File in Workflow Showing Workflow Icon

Note:

The Documents page is exposed in a space only with Content Server 11g. If the connected content repository is Content Server 10g, you can create a page in a space and add Documents service task flows to the page (see Section 41.4, "Adding a Documents Service Task Flow to a Page").

To view a file that is in workflow:

1. Click the file name to open the file in the Document Viewer preview pane.

   The Document Viewer preview pane displays workflow controls to show that the file is in workflow (Figure 43-6). The preview of the file shows the pending changes.

   Figure 43-6 Document Viewer Preview Pane Showing File in Workflow

   
   

2. To view further details about the workflow, click Details to display the workflow information in Content Server (Figure 43-7).

   Figure 43-7 Workflow Information in Content Server

   
   

   Note:

   To enable the availability of the workflow Details link in the Document Viewer preview pane, both of the following two requirements must be met:

   • You must access the Spaces application through Oracle HTTP Server (OHS) to expose Content Server and the Spaces application under the same host and port. For information about setting up OHS as the front-end to Spaces, see "Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.

   • Spaces must be connected to a Content Server repository, with the webContextRoot parameter set to a Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

3. If you are an approver or reviewer for the file, click Approve or Reject to indicate the result of your review of the file. These links are active only when the file is pending approval. If you reject the file, enter the justification for your rejection. For other ways to approve or reject a file, see Section 43.6.1, "Approving or Rejecting a File in Workflow."

   Note:

   To edit a file in workflow, the file must be associated with a workflow that contains the step review the current revision or create new revisions and you must be an approver for the workflow. The seeded workflow that meets these requirements is AllReviewers.

When a file in workflow is approved, it is released from workflow, and the workflow icon no longer displays for the file (Figure 43-8). If you edit the file and make further changes, it will return to workflow.

Figure 43-8 File Released From Workflow Showing No Workflow Icon

When a file in workflow is rejected, it remains in workflow, returning to the contribution step. It must be updated by the file owner for the Approve and Reject controls to display.

43.3.2 Viewing Workflow Files in a Content Presenter Task Flow

You can view content items displayed in Content Presenter while they are in a workflow, including Site Studio contributor data files displayed in a Site Studio region template. As long as the content item has at some point had Released status in Content Server, you can display the content item in Content Presenter. Then, if a revision of the content item is pending in workflow, Content Presenter allows approvers for the content item to toggle between the published version and the version in workflow in page edit mode or in-context edit (contributor) mode, and also provides links to approve or reject the item in workflow, and view additional details about the item.

To view a file in workflow in Content Presenter:

1. Add a Content Presenter task flow to a page (see Section 40.2, "Adding a Content Presenter Task Flow to a Page"), selecting the file that is in workflow.

2. To view the current workflow state of the file in Content Presenter, view the page in edit mode (Figure 43-9), or view the file in in-context edit (contributor) mode (Figure 43-10).

   Content Presenter displays workflow controls to show that the file is in workflow. The initial view of the the file shows the published version of the file.

   See Also:

   To view the page in edit mode, or view the file in in-context edit (contributor) mode, respectively, see:

   • Section 17.3.1, "Entering and Exiting Page Edit Mode"

   • Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow"

   Figure 43-9 Page Edit Mode: Workflow Controls in Content Presenter

   
   

   Figure 43-10 In-Context Edit (Contributor) Mode: Workflow Controls in Content Presenter

   
   

3. To view further details about the workflow, click Details to display the workflow information in Content Server (including workflow name, steps performed, action performed, date of action, and who performed the action).

   Note:

   To enable the availability of the workflow Details link in the Document Viewer preview pane, both of the following two requirements must be met:

   • You must access the Spaces application through Oracle HTTP Server (OHS) to expose Content Server and the Spaces application under the same host and port. For information about setting up OHS as the front-end to Spaces, see "Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.

   • Spaces must be connected to a Content Server repository, with the webContextRoot parameter set to a Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

4. If you are a workflow approver, click Preview pending changes to preview the changes to the file, then Approve or Reject the changes in either page edit mode (Figure 43-11), or in-context edit (contributor) mode (Figure 43-12). These links are active only when the file is pending approval. If you reject the file, enter the justification for your rejection. For other ways to approve or reject a file, see Section 43.6.1, "Approving or Rejecting a File in Workflow."

   Figure 43-11 Page Edit Mode: Preview File in Workflow to Approve or Reject in Content Presenter

   
   

   Figure 43-12 In-Context Edit (Contributor) Mode: Preview File in Workflow to Approve or Reject in Content Presenter

   
   

When a file in workflow is approved, it is released from workflow, and the workflow controls no longer display in Content Presenter. If you edit the file and make further changes, it will return to workflow and the workflow controls will display again.

When a file in workflow is rejected, it remains in workflow, returning to the contribution step. It must be updated by the file owner for the Approve and Reject controls to display.

43.3.3 Viewing Workflow Files in a Workflow Queue

If you have Content Portlet Suite installed, you can add the Oracle Workflow Queue portlet to a page to list the files in workflow, along with details about each workflow. For information about how to deploy Content Portlet Suite, see Oracle Fusion Middleware Deployment Guide for Content Portlet Suite.

To add the Oracle Workflow Queue portlet to a page:

1. Create a new page in a space or go to the page where you want to add the portlet, and open the page in edit mode.

   See Also:

   For more information, see Section 51.7.2, "Creating a Page in a Space" and Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content to open the Resource Catalog.

3. Locate the Oracle Workflow Queue portlet in the Resource Catalog.

   Tip:

   The presence or location of the Oracle Workflow Queue portlet depends on how the Resource Catalog is configured. For example, in the default Resource Catalog, click Portlets, then <Host> Portlets to locate the Oracle Workflow Queue portlet.

4. Click Add next to the Oracle Workflow Queue portlet to add it to the page, then Close the Resource Catalog.

   On the page, the Oracle Workflow Queue portlet (Figure 43-13) displays a list of all the files in workflow assigned to you to approve or reject.

   Figure 43-13 Oracle Workflow Queue Portlet

   
   

In the Oracle Workflow Queue portlet, you can perform the following actions if you have appropriate permissions:

• In the Title column, click a file name to open it in its native application.

• In the Workflow Info column, click a link to display the Workflow Step Information pane, which provides steps required to complete the workflow, the current step, the number of approvals required, and the remaining reviewers. For more information, see Section 43.4.1, "Viewing Detailed Workflow Status."

• In the Actions column, click Approve or Reject to indicate the result of your review of the file. These links are active only when the file is pending approval. If you reject the file, enter the justification for your rejection. For other ways to approve or reject a file, see Section 43.6.1, "Approving or Rejecting a File in Workflow."

• In the Info column, click the Content Information icon to display the Content Info pane, which provides access to actions you can perform, file metadata information, and revision history. For more information, see Section 43.4.2, "Viewing Content Information and Actions."

43.4 Viewing Workflow Status and File Information

As an approver or owner of a file in workflow, you may want to get more information about the current state of the workflow, details about the file itself, or perform file management actions to update or share the file to advance its approval:

• Section 43.4.1, "Viewing Detailed Workflow Status"

• Section 43.4.2, "Viewing Content Information and Actions"

43.4.1 Viewing Detailed Workflow Status

To view the details of the workflow status of a file:

1. Go to the Oracle Workflow Queue portlet that lists the file.

   To add an Oracle Workflow Queue portlet to a page, see Section 43.3.3, "Viewing Workflow Files in a Workflow Queue."

2. In the Workflow Info column, click the workflow step link to display the Workflow Step Information pane (Figure 43-14), which includes the steps required to complete the workflow, the current step, the number of approvals required, and the remaining reviewers. For information about workflow steps, see Section 43.1.2, "Understanding Workflow Steps."

   Figure 43-14 Workflow Step Information

   
   

3. Click Back to return to the Oracle Workflow Queue portlet.

43.4.2 Viewing Content Information and Actions

To display a Content Info pane that provides details about a file in workflow and perform file management actions to update or share the file to advance its approval:

1. Go to the Oracle Workflow Queue portlet that lists the file.

   To add an Oracle Workflow Queue portlet to a page, see Section 43.3.3, "Viewing Workflow Files in a Workflow Queue."

2. In the Info column, click the Content Information icon to display the Content Info pane (Figure 43-15), which provides access to actions you can perform, file metadata information, and revision history. For more information, see "Content Information Page" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

   Figure 43-15 Content Info Pane

   
   

3. Optionally, from the Actions list, choose any of the following actions:

   • Check Out to check the file out so that you can lock it from changes by other contributors while you are making updates.

   • Update to display the Info Update Form, where you can update editable metadata of the file without creating a new revision of the file. Only the Spaces administrator, space members with Manage Configuration permissions, or file owners can edit the file properties. For more information, see "Info Update Form" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

   • Check in Similar to display the Content Check In Form, where you can update editable metadata of the file and check the file in to Content Server. Only the Spaces administrator, space members with Manage Configuration permissions, or file owners can edit the metadata properties. For more information, see "Content Check-In Form" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

   • Send link by e-mail to open your e-mail application with a new message that contains a link to the URL of the web-viewable file, which you can mail to other users with requests for input or review to further the approval of the file.

4. Click Back to return to the Oracle Workflow Queue portlet.

43.5 Changing or Deleting a Workflow

With appropriate permissions (the Spaces administrator, or space members with Manage Configuration permissions), you can change or delete the workflow assigned to a folder in a Documents service task flow when the connected content repository is Content Server.

To change or delete the workflow assigned to a folder:

1. On the Documents page or in a Documents service task flow in a space, click in the row of the folder.

   Note:

   The Documents page is exposed in a space only with Content Server 11g. If the connected content repository is Content Server 10g, you can create a page in a space and add Documents service task flows to the page (see Section 41.4, "Adding a Documents Service Task Flow to a Page").

2. Follow the steps in Section 43.2, "Assigning a Workflow to a Folder in a Space":

   • To change the workflow, choose a different workflow from the Workflow Name list, and optionally add or delete approvers.

   • To delete the workflow, choose <None> from the Workflow Name list.

     Note:

     If you change or delete the workflow assigned to a folder, the files that were previously in that folder remain assigned to the prior workflow. Only files that are subsequently checked in or uploaded to the folder inherit the new workflow settings.

43.6 Participating in a Workflow

The workflow process is as follows:

• A document enters the workflow approval step by exiting the initial contribution step as a result of a new document upload or the editing of an existing document that was previously uploaded into a workflow-enabled folder.

• If any reviewer rejects a revision, it goes back to the contribution step for editing.

• When a revision is approved at the last step in the workflow, the content item is released to the system.

The following sections describe how to work with a file through the workflow process:

• Section 43.6.1, "Approving or Rejecting a File in Workflow"

• Section 43.6.2, "Working with a Rejected Revision"

43.6.1 Approving or Rejecting a File in Workflow

As an assigned approver for a workflow, you will need to review and either approve or reject the files to which you are assigned. A file is released from workflow when it is approved in accordance with its workflow type (see Section 43.1.1, "Understanding Workflow Types").

To approve or reject a file in workflow:

1. View the files for which you are an assigned approver in either of the following ways:

   • In the Document Viewer preview pane, as described in Section 43.3.1, "Viewing Workflow Files in a Documents Service Task Flow."

   • In a Content Presenter task flow, as described in Section 43.3.2, "Viewing Workflow Files in a Content Presenter Task Flow."

   • In an Oracle Workflow Queue portlet, as described in Section 43.3.3, "Viewing Workflow Files in a Workflow Queue."

2. Click Approve or Reject to indicate the result of your review of the file. These links are active only when the file is pending approval. If you reject the file, enter the justification for your rejection.

When a file in workflow is approved, it is released from workflow, and the workflow icon no longer displays for the file (Figure 43-16). If you edit the file and make further changes, it will return to workflow.

Figure 43-16 File Released From Workflow Showing No Workflow Icon

When a file in workflow is rejected, it remains in workflow, but must be updated by the file owner for the Approve and Reject controls to display.

43.6.2 Working with a Rejected Revision

If a file in workflow is rejected, it remains in workflow and returns to the original submitter in the contribution workflow step. The contributor can then revise the file and save it. After saving, the file automatically moves back into the workflow approval step again to be approved or rejected by assigned approvers.