QueryString (QueryStringType)
El elemento QueryString contiene una cadena de consulta de buzón basada en la sintaxis de consulta avanzada (AQS).
<QueryString/>
QueryStringType
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
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. |
Ninguno.
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. |
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.
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.
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="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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>
Código | Nombre |
---|---|
Namespace |
http://schemas.microsoft.com/exchange/services/2006/messages |
Nombre de esquema |
Esquema de mensajes |
Archivo de validación |
Messages.xsd |
Puede estar vacío |
False |