Using the workflow update tool

Use the workflow update tool to add a workflow to existing items that aren't already workflow enabled.

You must first enable the workflow update tool by adding the following parameters to the WCM WCMConfigService service using the WebSphere® Integrated Solutions Console:
  1. Log in to the portal as an administrator.
  2. Open the following URL in the browser and specify which workflow you want to apply and the library containing the items you want to apply the workflow to:
    http://[HOST]:[PORT]/wps/wcm/myconnect/?MOD=workflowenablement&library=libraryname&workflow=workflowname&fix=true
    Note: If the "library" parameter is omitted, the default library that has been configured in the WCM WCMConfigService service is used.
    Note: If the "&fix=true" parameter is omitted, the tool will run in read-only mode and generate a report.
Specifying a workflow stage:
You can specify the workflow stage to move the updated items to by adding &workflowstage=workflowstagename to the URL. The stage specified here must have a status of published. You cannot assign items to stages with a status of draft. If not specified, items will be assigned to the first stage with a status of published.
Preserving dates:
You can preserve the last modified date of items updated by the Workflow update tool by adding &preserve_dates=true to the URL used to run the Workflow update tool.
Restricting which items types to fix:
You can restrict which objects types are processed by adding &restrictOn=itemtype to the URL used to run the Workflow update tool. For example:
  • content
  • style for presentation templates
  • template for authoring templates
  • taxonomy
  • category
  • SiteArea
  • Cmpnt for components
If not specified, all object types will be fixed.
library
Enter a library name. If the library parameter is omitted, the default library that has been configured in the WCM WCMConfigService service using the WebSphere Integrated Solutions Console.

To run this tool against all libraries you instead use &alllibraries=true. If you have a large number of libraries, this may take a long time to run, so it may be better to run this tool against individual libraries instead of all libraries.

Unlocking items:
To force locked items to be unlocked while running the tool, add &forceUnlock=true to the query. This setting defaults to true.
Restricting which items types to fix:
To prevent your server timing out before the workflow update tool has finished, you can specify &sessionTimeOut= to the URL. This is defined as the number of seconds before a session will timeout. For example: &sessionTimeOut=36000 . The default session timeout is 14440 seconds.

Running the tool on a virtual portal

There are two methods available when running the tool on a virtual portal:
Using the URL context of a virtual portal:
If your virtual portal has a URL context, you can add this to the URL
http://[HOST]:[PORT]/wps/wcm/myconnect/[url_context]?MOD=workflowenablement&fix=true
Using the hostname of a virtual portal:
If your virtual portal has a hostname you can add this to the URL
http://[Virtual_HOST]:[PORT]/wps/wcm/myconnect?MOD=workflowenablement&fix=true