2.2.3.36.1 ConversationMode (GetItemEstimate)
The airsync:ConversationMode element is an optional child element of the Collection element in GetItemEstimate command requests that specifies whether to include items that are included within the conversation modality within the results of the GetItemEstimate command response (section 2.2.1.9). A single conversation MAY span multiple collections and therefore airsync:ConversationMode is a child of the Collection element, rather than the airsync:Options element (section 2.2.3.125.2).
Elements referenced in this section are defined in the GetItemEstimate namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.4).
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
GetItemEstimate command request |
Collection (section 2.2.3.29.1) |
None |
boolean ([MS-ASDTYPE] section 2.1) |
0...1 (optional) |
Setting the airsync:ConversationMode element to 0 (FALSE) in a GetItemEstimate request results in an Estimate element (section 2.2.3.65) value that only includes items that meet the airsync:FilterType element (section 2.2.3.68.1) value. Setting the airsync:ConversationMode element to 1 (TRUE) expands the result set to also include items with identical email2:ConversationId element (as specified in [MS-ASEMAIL] section 2.2.2.21) values to those in the airsync:FilterType result set. The airsync:ConversationMode element value has no impact on items outside the collection specified by the CollectionId element (section 2.2.3.30.2), the result set is limited to items in the specified collection. The airsync:ConversationMode element value only limits or expands the results determined by the airsync:FilterType element value.
Specifying the airsync:ConversationMode element for collections that do not store email results in an invalid XML error, Status element (section 2.2.3.177.7) value 103.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
|
Protocol version |
Element support |
|---|---|
|
2.5 |
|
|
12.0 |
|
|
12.1 |
|
|
14.0 |
Yes |
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |