FindItemFindItem

El elemento FindItem define una solicitud para buscar elementos en un buzón.The FindItem element defines a request to find items in a mailbox.

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>
<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>
<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>
<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/> 
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>
<FindItem Traversal="">
   <ItemShape/>
   <CalendarView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>
<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>
<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

FindItemTypeFindItemType

Atributos y elementosAttributes and elements

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescripciónDescription
TransversalTraversal
Define si la búsqueda encuentra elementos en las carpetas o en los supercontenedores de las carpetas.Defines whether the search finds items in folders or the folders' dumpsters. Este atributo es obligatorio.This attribute is required.

Valores de atributo de recorridoTraversal attribute values

ValorValue DescripciónDescription
ProfundaShallow
Devuelve solo las identidades de los elementos de la carpeta.Returns only the identities of items in the folder.
SoftDeletedSoftDeleted
Devuelve solo las identidades de los elementos que están en el contenedor de una carpeta.Returns only the identities of items that are in a folder's dumpster. Tenga en cuenta que un recorrido de eliminación temporal combinado con una restricción de búsqueda dará como resultado la devolución de elementos cero, incluso si hay elementos que coinciden con los criterios de búsqueda.Note that a soft-deleted traversal combined with a search restriction will result in zero items returned even if there are items that match the search criteria.
EstánAssociated
Devuelve solo las identidades de los elementos asociados de la carpeta.Returns only the identities of associated items in the folder.

Elementos secundariosChild elements

ElementoElement DescripciónDescription
ItemShapeItemShape
Identifica las propiedades del elemento y el contenido que se deben incluir en una respuesta de la operación FindItem .Identifies the item properties and content to include in a FindItem operation response.
IndexedPageItemViewIndexedPageItemView
Describe cómo se devuelve la información de elementos paginados para una solicitud FindItem .Describes how paged item information is returned for a FindItem request. Este elemento es opcional.This element is optional.
FractionalPageItemViewFractionalPageItemView
Describe dónde se inicia la vista paginada y el número máximo de elementos devueltos en una solicitud FindItem .Describes where the paged view starts and the maximum number of items returned in a FindItem request. El desplazamiento de la vista paginada desde el principio del conjunto de elementos encontrados se describe mediante una fracción.The paged view offset from the beginning of the set of found items is described by a fraction. Este elemento es opcional.This element is optional.
CalendarViewCalendarView
Proporciona límites de tiempo para definir una búsqueda para los elementos de calendario.Provides time span limits to define a search for calendar items. Este elemento es opcional.This element is optional.
ContactsViewContactsView
Define una búsqueda para los elementos de contacto basándose en los nombres para mostrar alfabéticos.Defines a search for contact items based on alphabetical display names. Este elemento es opcional.This element is optional.
GroupByGroupBy
Especifica agrupaciones arbitrarias para consultas FindItem .Specifies arbitrary groupings for FindItem queries. Este elemento es opcional.This element is optional.
DistinguishedGroupByDistinguishedGroupBy
Proporciona agrupaciones estándar para las consultas FindItem .Provides standard groupings for FindItem queries. Este elemento es opcional.This element is optional.
RestrictionRestriction
Define la restricción o consulta que se usa para filtrar elementos o carpetas FindItemen / las operaciones de carpeta deFindFolder y de búsqueda de la FindItem.Defines the restriction or query that is used to filter items or folders in FindItem/ FindFolder and search folder operations. Este elemento es opcional.This element is optional.
SortOrderSortOrder
Define cómo se ordenan los elementos en una solicitud FindItem.Defines how items are sorted in a FindItem request. Este elemento es opcional.This element is optional.
ParentFolderIdsParentFolderIds
Identifica las carpetas para buscar las operaciones FindItem y FindFolder.Identifies folders to search for the FindItem and FindFolder operations.
QueryString (QueryStringType)QueryString (QueryStringType)
Contiene una cadena de consulta de buzón basada en la sintaxis de consulta avanzada (AQS).Contains a mailbox query string based on Advanced Query Syntax (AQS).

Elementos principalesParent elements

Ninguno.None.

ComentariosRemarks

Solo se puede incluir uno de los elementos IndexedPageItemView, FractionalPageItemView, CalendarViewo ContactsView en una solicitud FindItem .Only one of the IndexedPageItemView, FractionalPageItemView, CalendarView, or ContactsView elements can be included in a FindItem request. Solo se puede incluir uno de los elementos GroupBy o DistinguishedGroupBy en una solicitud FindItem .Only one of the GroupBy or DistinguishedGroupBy elements can be included in a FindItem request.

El esquema que describe este elemento se encuentra en el directorio virtual IIS que hospeda los servicios Web Exchange.The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

Información del elementoElement information

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Nombre de esquemaSchema Name
Esquema de mensajesMessages schema
Archivo de validaciónValidation File
Messages. xsdMessages.xsd
Puede estar vacíoCan be Empty
FalsoFalse

Vea tambiénSee also