QueryString (QueryStringtype)QueryString (QueryStringType)

O elemento QueryString contém uma cadeia de caracteres de consulta de caixa de correio baseada na sintaxe de consulta avançada (AQS).The QueryString element contains a mailbox query string based on Advanced Query Syntax (AQS).

<QueryString/>

QueryStringtypeQueryStringType

Atributos e elementosAttributes and elements

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescriçãoDescription
ResetCacheResetCache
Indica que o cache deve ser redefinido.Indicates that the cache should be reset.
ReturnDeletedItemsReturnDeletedItems
Indica que os itens excluídos devem ser retornados.Indicates that deleted items should be returned.
ReturnHighlightTermsReturnHighlightTerms
Indica que os termos realçados devem ser retornados.Indicates that highlighted terms should be returned.

Elementos filhoChild elements

Nenhum.None.

Elementos paiParent elements

ElementoElement DescriçãoDescription
FindItemFindItem
Define uma solicitação para localizar itens em uma caixa de correio.Defines a request to find items in a mailbox.
A seguir está a expressão XPath para este elemento:/FindItem.The following is the XPath expression to this element: /FindItem.

Valor de textoText value

O valor de texto do elemento QueryString representa uma consulta de caixa de correio que é feita usando um subconjunto de sintaxe de consulta avançada (AQS).The QueryString element text value represents a mailbox query that is made by using a subset of Advanced Query Syntax (AQS). Consulte a seção comentários para obter informações sobre as opções de sintaxe suportadas para cadeias de caracteres de consulta.See the remarks section for information about the supported syntax options for query strings.

ComentáriosRemarks

No Exchange Server 2010, esse elemento é um tipo de cadeia de caracteres de esquema XML.In Exchange Server 2010, this element is an XML schema string type. Nas versões do Exchange a partir do Exchange Server 2013, incluindo o Exchange Online, o tipo desse elemento é querystringtype.In versions of Exchange starting with Exchange Server 2013, including Exchange Online, the type for this element is QueryStringType. Essa alteração não quebra clientes existentes porque adiciona três novos atributos opcionais.This change does not break any existing clients because it adds three new optional attributes.

O elemento QueryString exclui o uso de restrições do EWS.The QueryString element excludes the use of EWS restrictions. AQS no EWS dá suporte a três tipos de restrições: restrição de fase de palavra, restrição de intervalo de datas e restrição de tipo de mensagem.AQS in EWS supports three types of restrictions: word phase restriction, date range restriction, and message type restriction. As tabelas a seguir listam as propriedades de pesquisa suportadas para cada tipo de restrição.The following tables list the supported search properties for each restriction type.

Restrição de fase do WordWord phase restriction

PropriedadeProperty ExemploExample FunctionFunction
fromfrom
De: diretoraFrom:Dean
De: "Halstead"From:"Dean Halstead"
Itens de pesquisa enviados pelo diretor.Search items sent from Dean.
Itens de pesquisa enviados por Halstead.Search items sent from Dean Halstead. O remetente deve ser exatamente "Halstead".The sender must be exactly "Dean Halstead".
parato
Para: diretoraTo:Dean
Itens de pesquisa enviados para a diretora.Search items sent to Dean.
cccc
CC: diretoraCc:Dean
Pesquise itens com o diretor na linha CC.Search for items with Dean on the Cc line.
bccbcc
CCO: diretoraBcc:Dean
Pesquisar itens com a linha de um na linha Cco.Search for items with Dean on the Bcc line.
ParticipanteParticipants
Participantes: diretoraParticipants:Dean
Pesquisar itens com o diretor nos campos para, CC ou Cco.Search for items with Dean in the To, Cc, or Bcc fields.
AssuntoSubject
Assunto: produtoSubject:product
Assunto: (desenvolvimento de produtos)Subject:(product development)
Assunto: "desenvolvimento de produtos"Subject:"product development"
Pesquisar itens com o produto no assunto.Search for items with product in the subject.
Pesquisar itens com produtos e desenvolvimento no assunto.Search for items with product and development in the subject.
CorpoBody
ConteúdoContent
Corpo: ProgressBody:progress
Conteúdo: progressoContent:progress
Pesquisar itens com progresso no corpo.Search for items with progress in the body.
AnexoAttachment
Anexo: relatórioAttachment:report
Pesquisar itens com o relatório no nome do arquivo de anexo ou no corpo do arquivo.Search for items with report in the attachment file name or file body.
(Propriedade não especificada)(property is not specified)
Desenvolvimento de produtosProduct Development
Pesquisar itens que contenham produtos e desenvolvimento em todas as propriedades da fase do Word.Search for items that contain both product and development in all word phase properties.

A correspondência de restrição de fase de palavra sempre diferencia maiúsculas de minúsculas.Word phase restriction match is always case insensitive. A restrição de fase do Word dá suporte a dois tipos de correspondência: correspondência de prefixo ou correspondência exata.Word phase restriction supports two match types: prefix match or exact match. O prefixo correspondente é o comportamento padrão de correspondência.Prefix match is the default match behavior. Se quiser correspondência exata, use aspas duplas.If you want exact match, use double quotes. Por exemplo, Subject: "Product" corresponde a "Product", mas não a "Production" no assunto.For example, subject:"product" matches 'product' but not 'production' in the subject. Várias palavras em aspas duplas restringem ambas as fases da palavra e sua ordem.Multiple words in double quotes restrict both word phases and their order. Por exemplo, "produto de vitória" corresponde somente a "produto Win", não ' produto do Win95 ' ou "produto de vitória".For example "win product" matches only 'win product', not 'win95 product' or 'product of win'. Você pode usar um asterisco ( * ) para definir uma correspondência de prefixo com ordem restrita.You can use an asterisk (*) to define a prefix match with order restricted. Por exemplo, "produto do Win" corresponde a " * produto do Win95", "linha de produção do Windows", mas não "novo produto do Windows" ou "produto de vitória".For example, "win product"* matches 'win95 product', 'windows production line' but not 'windows new product' or 'product of win'. Você pode pesquisar todas as mensagens enviadas de ou para um domínio.You can search all messages sent from or to a domain. Por exemplo, de: "@hotmail. com" retorna todas as mensagens enviadas de hotmail.com.For example, from:"@hotmail.com" returns all messages sent from hotmail.com.

A tabela a seguir descreve as restrições de intervalo de datas.The following table describes date range restrictions.

Restrição de intervalo de datasDate range restriction

PropriedadeProperty ExemploExample FunctionFunction
SentSent
Enviado: última semanaSent:last week
Enviado: 01/01/2001Sent:01/01/2001
Enviado: 01/01/2001.. 01/15/2001Sent:01/01/2001..01/15/2001
Itens de pesquisa enviados na semana passada.Search items sent last week.
Itens de pesquisa enviados no dia 1º de janeiro de 2001.Search items sent on January 1st, 2001.
Itens de pesquisa enviados entre 1º de janeiro de 2001 e 15 de janeiro de 2001.Search items sent between January 1st, 2001 and January 15th, 2001.
ReceivedReceived
Recebido: hojeReceived:today
Recebido: 01/01/2001Received:01/01/2001
Itens de pesquisa recebidos hoje.Search items received today.
Itens de pesquisa recebidos no dia 1º de janeiro de 2001.Search items received on January 1st, 2001.

Os dois pontos (..) são um operador de intervalo.The two dots (..) is a range operator. Pode ser usado para definir um intervalo com um início e uma data de término.It can be used to define a range with a start and an end date. Para especificar uma data, você pode usar datas relativas.To specify a date, you can use relative dates. As seguintes datas relativas têm suporte:The following relative dates are supported:

  • Datas relativas: hoje, amanhã, ontemRelative dates: Today, tomorrow, yesterday

  • Datas relativas de MultiWord: esta semana, mês seguinte, semana passada, mês ou ano que vemMultiword relative dates: This week, next month, last week, past month, or coming year

  • Dias: domingo, segunda-feira, terça-feira, quarta-feira, quinta-feira, sábadoDays: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

  • Janeiro, fevereiro, março, abril, maio, junho de julho, agosto, setembro, outubro, novembro de dezembroJanuary, February, March, April, May, June, July, August, September, October, November, December

A tabela a seguir descreve as restrições de tipo de mensagem.The following table describes message type restrictions.

Restrição de tipo de mensagemMessage type restriction

PropriedadeProperty ExemploExample FunctionFunction
TipoKind
Tipo: tarefasKind:tasks
Pesquisar todos os itens de tarefa.Search all task items.

AQS no EWS usa a propriedade Kind para especificar o tipo de mensagem.AQS in EWS uses the Kind property to specify the message type. A propriedade Kind pode ser usada com os seguintes tipos de item:The Kind property can be used with the following item types:

  • emailemail

  • treinamentomeetings

  • tarefastasks

  • notesnotes

  • docsdocs

  • diáriosjournals

  • contactscontacts

  • respectivaim

A tabela a seguir descreve o agrupamento de conectores lógicos.The following table describes grouping logical connectors.

Agrupando conectores lógicosGrouping logical connectors

ConnectorConnector ExemploExample FunctionFunction
EAND
Assunto: produto e assunto: desenvolvimentoSubject:product AND subject:development
Assunto: (produto e desenvolvimento)Subject:(product AND development)
Assunto: (desenvolvimento de produtos)Subject:(product development)
Pesquisar itens com produtos e desenvolvimento no assunto.Search items with both product and development in the subject.
OUOR
Corpo: projeto ou corpo: propostaBody:project OR body:proposal
Corpo: (projeto ou proposta)Body:(project OR proposal)
Pesquisar itens com o produto ou o desenvolvimento no corpo.Search items with either product or development in the body.
NÃONOT
Não corpo: propostaNOT body:proposal
Corpo: (não proposta)Body:(NOT proposal)
Pesquisar mensagens sem proposta no corpo.Search messages without proposal in the body.

E é sempre o conector padrão.AND is always the default connector. Por exemplo, Subject: Project e Body: proposta é o mesmo que o assunto: corpo do projeto: proposta.For example, subject:project AND body:proposal is the same as subject:project body:proposal. Conectores lógicos diferenciam maiúsculas de minúsculas.Logical connectors are case sensitive. Por exemplo, corpo: (projeto ou proposta) pesquisa mensagens com "projeto", "ou" e "proposta" no corpo em vez de "projeto" ou "proposta".For example, body:(project Or proposal) searches messages with 'project', 'or', and 'proposal' in the body instead of 'project' or 'proposal'. O símbolo de adição (+) equivale a e.The plus symbol (+) is equivalent to AND. O símbolo de hífen (-) é equivalente a não.The hyphen symbol (-) is equivalent to NOT. Por exemplo, Body: (Project-propostas) pesquisa mensagens com "Project", mas sem "proposta" no corpo.For example, body:(project - proposal) searches messages with 'project' but without 'proposal' in the body.

A cadeia de caracteres de consulta também pode conter Propriedades não indexadas para pesquisa.The query string can also contain nonindexed properties for search. Se a cadeia de caracteres de consulta contiver Propriedades não indexadas, a pesquisa poderá realizar uma pesquisa do Exchange nas propriedades indexadas e uma pesquisa de armazenamento nas propriedades não indexadas.If the query string contains nonindexed properties, the search might perform an Exchange search on the indexed properties and a store search on the nonindexed properties.

O esquema que descreve este elemento está localizado no diretório virtual do IIS que hospeda os Serviços Web do Exchange.The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

ExemploExample

O exemplo a seguir mostra uma solicitação de pesquisa de mensagens na caixa de entrada com descoberta automática no assunto.The following example shows a request to search for messages in the Inbox with Autodiscover in the subject.

<?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>

O exemplo a seguir mostra uma resposta bem-sucedida à solicitação.The following example shows a successful response to the request.

<?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>

Elemento de informaçõesElement information

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquemaSchema name
Esquema de mensagensMessages schema
Arquivo de validaçãoValidation file
Messages.xsdMessages.xsd
Pode estar vazioCan be empty
FalseFalse

Confira tambémSee also

Operação FindItemFindItem operation

Operação FindConversationFindConversation operation