Workflow Definition Events

The events that occur for the workflow definition commands are shown in the following lists in the sequence that they occur.

Execute transition event sequence

Reassign Managers event sequence

Reroute event sequence

Occurs when a workflow definition transition is executed.

The new version of the document is created between the BeforeExecuteTransition and the AfterExecuteTransition event. For the first transition in the workflow, this means that in the BeforeExecuteTransition event and all preceding events, the Document object in script refers to the released revision of the document. In the AfterExecuteTransition event and subsequent events, the Document object refers to the new revision in the workflow.

As a result, all changes made to the Document object (to property values, for example) in script in the events up to and including the BeforeExecuteTransition event will change the released revision and will not be revoked if the workflow is revoked.

To prevent unexpected changes to the released document, we recommend avoiding making changes to the Document object in the events up to and including the BeforeExecuteTransition event.

Syntax

DocCWFEvent_*ExecuteTransition(Batch, Transition, Person, Manager, Comment)

Remarks

This set of events is intended to support user input to a batch process using the Batch.Confirmation Method and its related methods and properties as follows:

• The user initiates a workflow transition on a batch of documents

• DocCWFEvent_PreInitializeExecuteTransition event is executed and any changes to the event parameters are ignored. Not supported by PowerUser.

  Any batch scope confirmations are shown at this time.

• DocCWFEvent_InitializeExecuteTransition is executed and any changes to the event parameters are processed.

  Any batch scope confirmation results can be queried in script.

• For each document in the batch:

  • DocCWFEvent_PreBeforeExecuteTransition is executed and any changes to the event parameters are ignored. Not supported by PowerUser.

    Any document scope confirmations are shown at this time. The document name is visible to the user.

  • DocCWFEvent_BeforeExecuteTransition is executed and any changes to the event parameters are processed.

    Any document scope confirmation results can be queried in script.

  • DocCWFEvent_AfterExecuteTransition is executed and any changes to the event parameters are ignored.
  • DocCWFEvent_TerminateExecuteTransition is executed and any changes to the event parameters are ignored.

Occurs when a new revision is created by a transition of the workflow.

Syntax

DocCWFEvent_*NewRevision(Batch, Transition)

Occurs when a workflow is rerouted to a state other than a default destination state.

Syntax

DocCWFEvent_*Reroute(Batch, State, Person, Comment)

Occurs when property pages are shown by a transition of the workflow.

Syntax

DocCWFEvent_*Wizard(Batch, Transition, Comment)