[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
Microsoft Windows SharePoint Services 3.0 raises the OnTaskChanged event activity when a Microsoft Windows SharePoint Services 3.0 task associated with the workflow is modified.
Microsoft Windows SharePoint Services 3.0 include several activities that streamline the process of creating, updating, completing, and deleting tasks associated with a workflow. You can also use event-based activities to receive notification when tasks have been created, changed, or deleted.
These activities provide access to the methods and events implemented by the SharePoint.Workflow.ITaskService interface.
The OnTaskChanged activity has the following properties:
(Name) Required string. The default is the default name of the activity.
AfterProperties Required Workflow.SPWorkflowTaskProperties. The SPWorkflowTaskProperties object contains the current task property values for any properties that were updated. This includes custom data stored in the Hashtable object returned by the ExtendedProperties property.
This property is empty for tasks that have been deleted.
.gif) Note: |
|---|
| The object specified in this property is only used as a container for storing task properties from Microsoft Windows SharePoint Services 3.0 when the event is fired. Its contents are not synchronized with the task. |
BeforeProperties Required Workflow.SPWorkflowTaskProperties. The SPWorkflowTaskProperties object contains the previous task property values for any properties that were updated. This includes custom data stored in the Hashtable object returned by the ExtendedProperties property.
Description Optional string. Use this property to enter a description of the activity.
Enabled Required Boolean. Use this property to specify whether or not this activity should be executed in the workflow.
Executor Required string. This property represents the user login name of the SharePoint user who created, changed, or deleted the task.
Invoked Optional method. Use this property to specify the method you want to run after this event occurs.
CorrelationToken Required Workflow.Runtime.CorrelationToken. For activities that affect the entire workflow, the correlation token should be bound to the correlation token of the OnWorkflowActivated activity. For tasks within the workflow, each specific task should have its own correlation token, which each related activity can use to access the same, task-specific information.
Roles Optional Workflow.ComponentModel.RoleCollection. This property is not used by Microsoft Windows SharePoint Services 3.0. Values entered for this property are ignored.
TaskId Required GUID. This property represents the GUID of the SharePoint task that was created, changed, or deleted.
InterfaceType This property specifies the interface used to implement the activity. Leave this property set to its the default value.
EventName This property specifies the method that implements the activity. Leave this property set to its the default value.
Concepts
Workflow Activities for Windows SharePoint Services Overview
Workflow Initialization in Windows SharePoint Services
Correlation Tokens in Workflows
How Windows SharePoint Services Processes Workflow Activities