Share via

3.1.4.2.3.6 FindConversationType

  • Article

The FindConversationType complex type specifies the search options to use when searching for conversations. The FindConversationType complex type extends the BaseRequestType complex type, as specified in [MS-OXWSCDATA] section 2.2.4.17.

 <xs:complexType name="FindConversationType">
   <xs:complexContent>
     <xs:extension
       base="m:BaseRequestType"
     >
       <xs:sequence>
           <xs:choice minOccurs="0">
             <xs:element name="IndexedPageItemView"
               type="t:IndexedPageViewType"
              />
             <xs:element name="SeekToConditionPageItemView"
               type="t:SeekToConditionPageViewType"
              />
           </xs:choice>
         <xs:element name="SortOrder"
           type="t:NonEmptyArrayOfFieldOrdersType"
           minOccurs="0"
          />
         <xs:element name="ParentFolderId"
           type="t:TargetFolderIdType"
           minOccurs="1"
          />
           <xs:element name="MailboxScope"
             type="t:MailboxSearchLocationType"
             minOccurs="0"
             maxOccurs="1"
            />
           <xs:element name="QueryString"
             type="m:QueryStringType"
             minOccurs="0"
             maxOccurs="1"
            />
           <xs:element name="ConversationShape"
             type="t:ConversationResponseShapeType"
             minOccurs="0"
             maxOccurs="1"
            />
       </xs:sequence>
       <xs:attribute name="Traversal"
         type="t:ConversationQueryTraversalType"
         use="optional"
        />
       <xs:attribute name="ViewFilter"
         type="t:ViewFilterType"
         use="optional"
        />
     </xs:extension>
   </xs:complexContent>
 </xs:complexType>
 

The following table lists the child elements of the FindConversationType complex type.

Element

Type

Description

IndexedPageItemView

t:IndexedPageViewType ([MS-OXWSSRCH] section 2.2.4.16)

Specifies how conversation search results are returned in a response. This element MUST be present.

SeekToConditionPageItemView

t:SeekToConditionPageViewType ([MS-OXWSSRCH] section 2.2.4.34)

Specifies a condition that has to be satisfied in order to include an item in the result set.<21>

SortOrder

t:NonEmptyArrayOfFieldOrdersType ([MS-OXWSSRCH] section 3.1.4.2.3.8)

Specifies the property and sort order direction that is used to sort conversations in a response.

ParentFolderId

t:TargetFolderIdType ([MS-OXWSFOLD] section 2.2.4.16)

Specifies the folder that is searched for conversations. This element MUST be present.

MailboxScope

t:MailboxSearchLocationType ([MS-OXWSEDISC] section 3.1.4.4.4.1)

Specifies the mailbox scope.

QueryString

m:QueryStringType ([MS-OXWSSRCH] section 2.2.4.29)

Specifies the query string.

ConversationShape

t:ConversationResponseShapeType (section 3.1.4.2.3.3)

Specifies the properties returned in a response.

The following table lists the attributes of the FindConversationType complex type.

Attribute

Type

Description

Traversal

t:ConversationQueryTraversalType (section 3.1.4.2.4.1)

Specifies whether a query of conversation items is shallow or deep.

ViewFilter

t:ViewFilterType (section 3.1.4.2.4.3)

Specifies the view filter for the search.