Workflow Item Stuck in EDIT or GENWWW Status

4-52 Application Administrators Guide for Content Server can experience data corruption because the workflow’s data binder is being used by the service. A solution for this is to temporarily set the security group value into a temporary variable. Then clear the current security group value, make the call for the search results, then reset the security group back again. This should return the results being sought.

4.8.9 Suppressing Workflow Notifications

When a workflow step requires multiple approvers, a user who has already approved the document may be re-notified during a timed workflow update cycle. In order to prevent additional notifications, use the wfSetIsNotifyingUsers workflow function. Used in a workflow step in the script section of the workflow, it sets an internal flag to determine if workflow notifications will be sent out during the current document action check in, approve, update, and so on. The suppression is applied to both email and updates to the workflow in the queue. When used in combination with wfIsFinishedDocConversion, this function can suppress notification until conversion is finished. It does not prevent documents from advancing out of the auto-contributor step but it does stop updates of the workflow in queue and notification emails. These notifications are not lost. If the wfSetIsNotifyingUsers function is not used in a future workflow event to suppress notifications updates to workflow in queue and workflow mail then all users participating in the current step are notified. Additional functions which can be used in the script section are the following: ■ wfIsFinishedDocConversion, which returns a result indicating if the document will not be in GENWWW after the current document action ends. ■ wfIsNotifyingUsers, which returns a result indicating if the workflow is currently suppressing all workflow notification for this particular workflow event. See the Oracle Fusion Middleware Idoc Script Reference Guide for usage details for all of these functions.

4.9 Workflow Troubleshooting

This section provides solutions to several common workflow issues. ■ Workflow Item Stuck in EDIT or GENWWW Status on page 4-52 ■ Workflow Item Stuck in REVIEW Status on page 4-54 ■ Workflow Item Entered in Wrong Workflow on page 4-54

4.9.1 Workflow Item Stuck in EDIT or GENWWW Status

Symptom A content item in a workflow is in EDIT or GENWWW status, and no reviewers were notified by e-mail that action is required. Problem Inbound Refinery failed to convert the file properly. Managing Workflows 4-53 Recommendation 1. View the content items status in Repository Manager or the Content Items for Workflow page accessed from Content Manager, then Active Workflows and then Workflow_Name. For more details on the conversion failure, display the Content Information page. 2. Determine why the conversion failed: ■ If the problem was with Inbound Refinery or a conversion add-on product: a. Correct the problem so that the file will convert properly. b. Resubmit the file for conversion from Repository Manager or Content Information page. The content item will continue through the workflow. ■ If the problem was with a file in a criteria workflow and the content item is the only item in the workflow: a. Save a copy of the native file. b. Disable the workflow to release the content item. c. Delete the released revision using Repository Manager or the Content Information page. d. Correct the problem so that the file will convert properly. e. Check in the content item again so that it goes through the entire workflow process. ■ If the problem was with a file in a criteria workflow and there are multiple content items in the workflow: a. Save a copy of the native file. b. Delete the stuck revision using Repository Manager. You could disable the workflow, but all content items in the workflow would be released. c. Correct the problem so that the file will convert properly. d. Check in the content item again so that it goes through the entire workflow process ■ If the problem was with a file in a basic workflow and the content item is the only item in the workflow: a. Save a copy of the native file. b. Cancel the workflow to delete the revision from the system. c. Correct the problem so that the file will convert properly. d. Contribute the content item again to the Basic workflow so that it goes through the entire workflow process. ■ If the problem was with a file in a basic workflow and there are multiple content items in the workflow: a. Save a copy of the native file. b. Delete the stuck revision using Repository Manager. You could cancel the workflow, but all content items in the workflow would be deleted from the system. c. Correct the problem so that the file will convert properly. d. Contribute the content item again to the Basic workflow so that it goes through the entire workflow process 4-54 Application Administrators Guide for Content Server

4.9.2 Workflow Item Stuck in REVIEW Status