ConversationAction

The ConversationAction element contains a single action to be applied to a single conversation.

ApplyConversationAction

ConversationActions

ConversationAction

<ConversationAction>
   <Action/>
   <ConversationId/>
   <ContextFolderId/>
   <ConversationLastSyncTime/>
   <ProcessRightAway/>
   <DestinationFolderId/>
   <Categories/>
   <EnableAlwaysDelete/>
   <IsRead/>
   <DeleteType/>
</ConversationAction>

ConversationActionType

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child elements

Element Description
Action (ConversationActionTypeType)
Contains the action to perform on the conversation specified by the ConversationId element. This element must be present.
ConversationId
Contains the identifier of the conversation that will have the action specified by the Action (ConversationActionTypeType) element applied to items in the conversation. This element must be present.
ContextFolderId
Indicates the folder that is targeted for actions that use folders. This element must be present when copying, deleting, moving, and setting read state on conversation items in a target folder.
ConversationLastSyncTime
Contains the date and time that a conversation was last synchronized. This element must be present when trying to delete all items in a conversation that were received up to the specified time.
ProcessRightAway
Indicates whether the response is sent as soon as the action starts processing on the server or whether the response is sent after the action has completed. This element must be present for the response to be sent asynchronous to the requested action.
DestinationFolderId
Indicates the destination folder for copy and move actions.
Categories
Contains a collection of strings that identify the categories to which items in a conversation belong.
EnableAlwaysDelete
Specifies a flag that enables deletion for all new items in a conversation.
IsRead
Indicates whether a message has been read.
DeleteType
Indicates how items in a conversation are deleted.

Parent elements

Element Description
ConversationActions
Contains a collection of conversations and the actions to apply to them.

Text value

ConversationAction element text values

Value Description
AlwaysCategorize
Always categorize the conversation.
AlwaysDelete
Always delete the conversation.
AlwaysMove
Always move the conversation.
Delete
Delete the conversation.
Move
Move the conversation.
Copy
Copy the conversation.
SetReadState
Set the read state of the conversation.
SetRetentionPolicy
Set the retention policy for the conversation.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.This element was introduced in Exchange Server 2010 Service Pack 1 (SP1).

Element information

Element Example
Namespace
http://schemas.microsoft.com/exchange/services/2006/types
Schema Name
Types schema
Validation File
Types.xsd
Can be Empty
False

See also

ApplyConversationAction operation