Operación FindItem

Artículo
03/29/2023

Busque información sobre la operación EWS FindItem .

La operación FindItem busca elementos que se encuentran en el buzón de un usuario. Esta operación proporciona muchas maneras de filtrar y dar formato a cómo se devuelven los resultados de búsqueda al autor de la llamada.

Uso de la operación FindItem

La solicitud de operación FindItem proporciona muchas maneras de buscar en un buzón y dar formato a cómo se devuelven los datos en una respuesta. Puede especificar lo siguiente en una solicitud FindItem :

Si la búsqueda es un recorrido superficial o eliminado temporalmente. Es necesario especificar esto. Tenga en cuenta que un recorrido eliminado temporalmente combinado con una restricción de búsqueda dará como resultado cero elementos devueltos, incluso si hay elementos que coinciden con los criterios de búsqueda.
La forma de respuesta de los elementos. Esto identifica las propiedades que se devuelven en la respuesta. Es necesario especificar esto.
Carpetas desde las que se va a realizar la búsqueda. Es necesario especificar esto.
Mecanismo de paginación y tipos de vista para devolver datos de vista en páginas. Especificar esto es opcional.
Opciones para agrupar y ordenar los elementos que se devuelven. Especificar esto es opcional.
Restricciones de búsqueda o cadenas de sintaxis de consulta avanzada (AQS) para filtrar los elementos que se devuelven. Para obtener más información sobre el uso de AQS para búsquedas de índices de contenido, vea QueryString (String). Especificar esto es opcional.
Criterio de ordenación de los elementos devueltos en la respuesta. Especificar esto es opcional.

La operación FindItem devuelve solo los primeros 512 bytes de cualquier propiedad que se pueda transmitir. Para Unicode, devuelve los primeros 255 caracteres mediante una cadena Unicode terminada en NULL. No devuelve ninguno de los formatos de cuerpo del mensaje ni las listas de destinatarios. FindItem devolverá un resumen de destinatario. Puede usar la operación GetItem para obtener los detalles de un elemento.

FindItem devuelve solo el elemento Name (EmailAddressType) y no devuelve el elemento EmailAddress (NonEmptyStringType) en el elemento Mailbox para los campos siguientes:

El campo Desde para mensajes
El campo Remitente de los mensajes
Campo Organizador para elementos de calendario

Nota:

La operación FindItem puede devolver resultados en un elemento CalendarView . El elemento CalendarView devuelve elementos de calendario únicos y todas las repeticiones de reuniones periódicas. Si no se usa un elemento CalendarView , se devuelven elementos de calendario únicos y elementos de calendario maestro periódicos. Las repeticiones deben expandirse desde el patrón periódico si no se usa un elemento CalendarView .

La operación FindItem puede usar los encabezados SOAP que se enumeran en la tabla siguiente.

Tabla 1. Encabezados SOAP de la operación FindItem

Header	Elemento	Descripción
DateTimePrecision	DateTimePrecision	Especifica la resolución de los valores de datos y tiempo en las respuestas del servidor, ya sea en segundos o en milisegundos. Esto es aplicable a una solicitud.
Suplantación	ExchangeImpersonation	Identifica al usuario al que suplanta la aplicación cliente. Esto es aplicable a una solicitud.
MailboxCulture	MailboxCulture	Identifica la referencia cultural RFC3066 que se va a usar para acceder al buzón. Esto es aplicable a una solicitud.
RequestVersion	RequestServerVersion	Identifica la versión del esquema de la solicitud de operación. Esto es aplicable a una solicitud.
ServerVersion	ServerVersionInfo	Identifica la versión del servidor que respondió a la solicitud. Esto es aplicable a una respuesta.
TimeZoneContext	TimeZoneContext	Identifica la zona horaria que se va a usar para todas las respuestas del servidor. Esto es aplicable a una solicitud.

Ejemplo de solicitud de operación FindItem

En el ejemplo siguiente de una solicitud FindItem se muestra cómo obtener el identificador de elemento definido por la enumeración IdOnly del elemento BaseShape para los elementos que se encuentran en la carpeta Elementos eliminados.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
              Traversal="Shallow">
      <ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
      </ItemShape>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="deleteditems"/>
      </ParentFolderIds>
    </FindItem>
  </soap:Body>
</soap:Envelope>

En la solicitud se usan los siguientes elementos:

Para obtener más opciones para un mensaje de solicitud FindItem , explore la jerarquía de esquema. Comience en el elemento FindItem .

Respuesta correcta de la operación FindItem

En el ejemplo siguiente se muestra una respuesta correcta a la solicitud FindItem .

Los elementos message representan mensajes de correo electrónico y todos los demás elementos que no están fuertemente tipados por el esquema EWS. Elementos como IPM. Uso compartido e IPM. InfoPath se devuelve como elementos Message . Exchange no devuelve el elemento Item base en las respuestas.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="595" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <FindItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                      xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                      xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:FindItemResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:RootFolder TotalItemsInView="10" IncludesLastItemInRange="true">
            <t:Items>
              <t:Message>
                <t:ItemId Id="AS4AUn=" ChangeKey="fsVU4==" />
              </t:Message>
              <t:Message>
                <t:ItemId Id="AS4AUM=" ChangeKey="fsVUA==" />
              </t:Message>
            </t:Items>
          </m:RootFolder>
        </m:FindItemResponseMessage>
      </m:ResponseMessages>
    </FindItemResponse>
  </soap:Body>
</soap:Envelope>

Los siguientes elementos se usan en la respuesta:

Para obtener más opciones para un mensaje de respuesta FindItem , explore la jerarquía de esquema. Comience en el elemento FindItemResponse .

Respuesta de error de la operación FindItem

En el ejemplo siguiente se muestra una respuesta de error a una solicitud FindItem .

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="595" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <FindItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                      xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                      xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:FindItemResponseMessage ResponseClass="Error">
          <m:MessageText>Id is malformed.</m:MessageText>
          <m:ResponseCode>ErrorInvalidIdMalformed</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:FindItemResponseMessage>
      </m:ResponseMessages>
    </FindItemResponse>
  </soap:Body>
</soap:Envelope>

Los siguientes elementos se usan en la respuesta de error:

Para obtener más opciones para un mensaje de respuesta de error FindItem , explore la jerarquía de esquema. Comience en el elemento FindItemResponse .

Diferencias de versión

Las versiones de Exchange que comienzan con la versión principal 15 y terminan con la compilación 15.0.898.11 devuelven un valor ErrorInvalidOperation en el elemento ResponseCode cuando se usa la operación FindItem para buscar varias carpetas en un buzón de archivo.