Compartir a través de

QueryString (QueryStringType)

  • Artículo

El elemento QueryString contiene una cadena de consulta de buzón basada en la sintaxis de consulta avanzada (AQS).

<QueryString/>

QueryStringType

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
ResetCache
 Indica que se debe restablecer la memoria caché
ReturnDeletedItems
 Indica que se deben devolver los elementos eliminados.
ReturnHighlightTerms
 Indica que se deben devolver los términos resaltados.

Elementos secundarios

Ninguno.

Elementos principales

Elemento Descripción
FindItem
Define una solicitud para buscar elementos en un buzón.
La siguiente es la expresión XPath de este elemento: /FindItem.

Valor de texto

El valor de texto del elemento QueryString representa una consulta de buzón que se realiza mediante un subconjunto de sintaxis de consulta avanzada (AQS). Consulte la sección de comentarios para obtener información sobre las opciones de sintaxis admitidas para las cadenas de consulta.

Comentarios

En Exchange Server 2010, este elemento es un tipo de cadena de esquema XML. En las versiones de Exchange que comienzan con Exchange Server 2013, incluido Exchange Online, el tipo para este elemento es QueryStringType. Este cambio no rompe ningún cliente existente porque añade tres nuevos atributos opcionales.

El elemento QueryString excluye el uso de restricciones de EWS. AQS en EWS admite tres tipos de restricciones: restricción de fase de palabras, restricción del intervalo de fechas y restricción de tipo de mensaje. En las tablas siguientes se enumeran las propiedades de búsqueda admitidas para cada tipo de restricción.

Restricción de fase de Word

Propiedad Ejemplo Función
from
 From:Dean
From:”Dean Halstead”
 Buscar elementos enviados por Dean.
Buscar elementos enviados por Dean Halstead. El remitente debe ser exactamente "Dean Halstead".
a
 To:Dean
 Buscar elementos enviados a Dean.
cc
 Cc:Dean
 Buscar elementos con Dean en la línea Cc.
cco
 Bcc:Dean
 Buscar elementos con Dean en la línea CCO.
Participantes
 Participants:Dean
 Buscar elementos con Dean en los campos Para, Cc o CCO.
Subject
 Subject:product
Subject:(product development)
Subject:"product development"
 Buscar elementos con el producto en el asunto.
Buscar elementos con producto y desarrollo en el asunto.
Cuerpo
Contenido
 Body:progress
Content:progress
 Buscar elementos con progreso en el cuerpo.
Datos adjuntos
 Attachment:report
 Buscar elementos con informe en el nombre del archivo adjunto o el cuerpo del archivo adjunto.
(no se especifica la propiedad)
 Desarrollo de productos
 Buscar elementos que contengan tanto el producto como el desarrollo en todas las propiedades de la fase de palabras.

La coincidencia de la restricción de fase de palabras no distingue entre mayúsculas y minúsculas. La restricción de fase de palabras admite dos tipos de coincidencia: coincidencia de prefijo o coincidencia exacta. La coincidencia de prefijos es el comportamiento de coincidencia predeterminado. Si desea una coincidencia exacta, use comillas dobles. Por ejemplo, subject:"product" coincide con "product" pero no con "production" en el asunto. Múltiples palabras entre comillas dobles restringen tanto las fases de palabras como su orden. Por ejemplo, "win product" solo coincide con "win product", no con "win95 product" o "product of win". Puede usar un asterisco (*) para definir una coincidencia de prefijo con el orden restringido. Por ejemplo, "win product"* coincide con "win95 product", "windows production line" pero no "windows new product" o "product of win". Puede buscar todos los mensajes enviados desde o a un dominio. Por ejemplo, from:"@hotmail.com" devuelve todos los mensajes enviados desde @hotmail.com.

La siguiente tabla describe las restricciones del intervalo de fechas.

Restricción del intervalo de fechas

Propiedad Ejemplo Función
Sent
 Sent:last week
Sent:01/01/2001
Sent:01/01/2001..01/15/2001
 Buscar elementos enviados la semana pasada.
Buscar elementos enviados el 1 de enero de 2001.
Buscar elementos enviados entre el 1 de enero de 2001 y el 15 de enero de 2001.
Cantidad.Recibida
 Received:today
Received:01/01/2001
 Buscar elementos recibidos hoy.
Buscar elementos recibidos el 1 de enero de 2001.

Los dos puntos (..) son un operador de intervalo. Se puede usar para definir un intervalo con una fecha de inicio y una fecha de finalización Para especificar una fecha, puede utilizar fechas relativas. Se admiten las siguientes fechas relativas:

  • Fechas relativas: hoy, mañana y ayer

  • Fechas relativas de varias palabras: esta semana, el mes que viene, la última semana, el mes pasado o el año que viene

  • Días: domingo, lunes, martes, miércoles, jueves, viernes, sábado

  • Enero, febrero, marzo, abril, mayo, junio, julio, agosto, septiembre, octubre, noviembre, diciembre

En la tabla siguiente se describen las restricciones de tipo de mensaje.

Restricción de tipo de mensaje

Propiedad Ejemplo Función
Tipo
 Kind:tasks
 Busque en todos los elementos de tarea.

AQS en EWS usa la propiedad Kind para especificar el tipo de mensaje. La propiedad “Kind” se puede usar con los siguientes tipos de elementos:

  • correo electrónico

  • reuniones

  • tasks

  • notas

  • documentos

  • diarios

  • contacts

  • mensajería instantánea

La siguiente tabla describe la agrupación de conectores lógicos.

Agrupación de conectores lógicos

Connector Ejemplo Función
AND
 Subject:product AND subject:development
Subject:(product AND development)
Subject:(product development)
 Buscar elementos con producto y desarrollo en el asunto.
OR
 Body:project OR body:proposal
Body:(project OR proposal)
 Buscar elementos con producto o desarrollo en el cuerpo.
NOT
 NOT body:proposal
Body:(NOT proposal)
 Buscar mensajes sin propuesta en el cuerpo.

AND es siempre el conector predeterminado. Por ejemplo, subject:project AND body:proposal es lo mismo que subject:project body:proposal. Los conectores lógicos distinguen entre mayúsculas y minúsculas. Por ejemplo, body:(project Or proposal) busca mensajes con "project", "or" y "proposal" en el cuerpo en lugar de "project" o "proposal". El símbolo más (+) equivale a AND. El símbolo de guión (-) equivale a NOT. Por ejemplo, body:(project - proposal) busca mensajes con "project" pero sin "proposal" en el cuerpo.

La cadena de consulta también puede contener propiedades no indexadas para la búsqueda. Si la cadena de consulta contiene propiedades no indexadas, la búsqueda puede realizar una búsqueda de Exchange en las propiedades indexadas y una búsqueda de almacenamiento en las propiedades no indexadas.

El esquema que describe este elemento se encuentra en el directorio virtual IIS que hospeda los servicios Web Exchange.

Ejemplo

El siguiente ejemplo muestra una solicitud para buscar mensajes en la Bandeja de entrada con Autodescubrimiento en el asunto.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2010" />
  </soap:Header>
  <soap:Body>
    <m:FindItem Traversal="Shallow">
      <m:ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="item:Subject" />
        </t:AdditionalProperties>
      </m:ItemShape>
      <m:IndexedPageItemView MaxEntriesReturned="1" Offset="0" BasePoint="Beginning" />
      <m:ParentFolderIds>
        <t:DistinguishedFolderId Id="inbox" />
      </m:ParentFolderIds>
      <m:QueryString>subject:Autodiscover</m:QueryString>
    </m:FindItem>
  </soap:Body>
</soap:Envelope>

El siguiente ejemplo muestra una respuesta satisfactoria a la solicitud.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ServerVersionInfo MajorVersion="14" 
                         MinorVersion="0" 
                         MajorBuildNumber="639" 
                         MinorBuildNumber="20" 
                         Version="Exchange2010" 
                         xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                         xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <m:FindItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                        xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <m:ResponseMessages>
        <m:FindItemResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:RootFolder IndexedPagingOffset="1" 
                        TotalItemsInView="5" 
                        IncludesLastItemInRange="false">
            <t:Items>
              <t:Message>
                <t:ItemId Id="AAMkADEzOTExYjJkLTYx" ChangeKey="CQAAABY" />
                <t:Subject>How to use Autodiscover</t:Subject>
              </t:Message>
            </t:Items>
          </m:RootFolder>
        </m:FindItemResponseMessage>
      </m:ResponseMessages>
    </m:FindItemResponse>
  </s:Body>
</s:Envelope>

Información del elemento

Código Nombre
Namespace
 https://schemas.microsoft.com/exchange/services/2006/messages
Nombre de esquema
 Esquema de mensajes
Archivo de validación
 Messages.xsd
Puede estar vacío
 False

Vea también

Operación FindItem

Operación FindConversation