QueryString (QueryStringType)

Artigo
03/29/2023

O elemento QueryString contém uma cadeia de caracteres de consulta de caixa de correio com base em AQS (Sintaxe de Consulta Avançada).

<QueryString/>

QueryStringType

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
ResetCache	Indica que o cache deve ser redefinido.
ReturnDeletedItems	Indica que os itens excluídos devem ser retornados.
ReturnHighlightTerms	Indica que os termos realçados devem ser retornados.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
FindItem	Define uma solicitação para encontrar itens em uma caixa de correio. A seguir está a expressão XPath para esse elemento: /FindItem.

Valor de texto

O valor de texto do elemento QueryString representa uma consulta de caixa de correio feita usando um subconjunto de Sintaxe de Consulta Avançada (AQS). Consulte a seção comentários para obter informações sobre as opções de sintaxe suportadas para cadeias de caracteres de consulta.

Comentários

No Exchange Server 2010, esse elemento é um tipo de cadeia de caracteres de esquema XML. Em versões do Exchange a partir Exchange Server 2013, incluindo Exchange Online, o tipo para esse elemento é QueryStringType. Essa alteração não quebra nenhum cliente existente porque adiciona três novos atributos opcionais.

O elemento QueryString exclui o uso de restrições EWS. O AQS no EWS oferece 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. As tabelas a seguir listam as propriedades de pesquisa suportadas para cada tipo de restrição.

Restrição de fase de palavra

Propriedade	Exemplo	Função
from	From:Dean From:"Dean Halstead"	Itens de pesquisa enviados por Dean. Itens de pesquisa enviados por Dean Halstead. O remetente deve ser exatamente "Dean Halstead".
para	To:Dean	Itens de pesquisa enviados para Dean.
cc	Cc:Dean	Procure itens com Dean na linha Cc.
bcc	Bcc:Dean	Pesquise itens com Dean na linha Bcc.
Participantes	Participantes:Dean	Procure itens com Dean nos campos Para, Cc ou Bcc.
Assunto	Subject:product Subject:(product development) Subject:"product development"	Pesquise itens com produto no assunto. Pesquise itens com produto e desenvolvimento no assunto.
Corpo Conteúdo	Body:progress Content:progress	Pesquise itens com progresso no corpo.
Anexo	Attachment:report	Procure itens com relatório no nome do arquivo de anexo ou no corpo do arquivo.
(propriedade não é especificada)	Desenvolvimento de produtos	Pesquise itens que contenham produto e desenvolvimento em todas as propriedades de fase de palavra.

A combinação de restrição de fase de palavra nunca diferencia maiúsculas e minúsculas. A restrição de fase de palavra dá suporte a dois tipos de match: combinação de prefixo ou combinação exata. A combinação de prefixo é o comportamento padrão de combinação. Se você quiser uma combinação exata, use aspas duplas. Por exemplo, subject:"product" corresponde a 'product' mas não 'production' no assunto. Várias palavras entre aspas restringem as fases da palavra e sua ordem. Por exemplo, "ganhar produto" corresponde apenas a 'ganhar produto', não 'produto win95' ou produto de win'. Você pode usar um asterisco (*) para definir uma correspondência de prefixo com a ordem restrita. Por exemplo, "win product"* corresponde a 'produto win95', 'linha de produção do Windows' mas não 'windows new product' ou 'product of win'. Você pode pesquisar todas as mensagens enviadas de ou para um domínio. Por exemplo, from:"@hotmail.com" retorna todas as mensagens enviadas de hotmail.com.

A tabela a seguir descreve as restrições de intervalo de datas.

Restrição de intervalo de datas

Propriedade	Exemplo	Função
Sent	Sent:last week Sent:01/01/2001 Sent:01/01/2001..01/15/2001	Itens de pesquisa enviados na semana passada. Itens de pesquisa enviados em 1º de janeiro de 2001. Itens de pesquisa enviados entre 1º de janeiro de 2001 e 15 de janeiro de 2001.
Received	Received:today Received:01/01/2001	Itens de pesquisa recebidos hoje. Itens de pesquisa recebidos em 1º de janeiro de 2001.

Os dois pontos (..) é um operador de intervalo. Ele pode ser usado para definir um intervalo com uma data inicial e final. Para especificar uma data, você pode usar datas relativas. As seguintes datas relativas são suportadas:

Datas relativas: hoje, amanhã, ontem
Datas relativas de várias palavras: esta semana, próximo mês, semana passada, mês passado ou próximo ano
Dias: domingo, segunda-feira, terça-feira, quarta-feira, quinta-feira, sexta-feira, sábado
Janeiro, fevereiro, março, abril, maio, junho, julho, agosto, setembro, outubro, novembro, dezembro

A tabela a seguir descreve restrições de tipo de mensagem.

Restrição de tipo de mensagem

Propriedade	Exemplo	Função
Tipo	Tipo:tarefas	Pesquise todos os itens da tarefa.

O AQS no EWS usa a propriedade Kind para especificar o tipo de mensagem. A propriedade Kind pode ser usada com os seguintes tipos de item:

email
reuniões
tarefas
notes
documentos
diários
contacts
mensagem instantânea

A tabela a seguir descreve o grupo de conectores lógicos.

Agrupar conectores lógicos

Connector	Exemplo	Função
E	Subject:product AND subject:development Subject:(product AND development) Subject:(product development)	Pesquisar itens com produto e desenvolvimento no assunto.
OU	Body:project OR body:proposal Body:(project OR proposal)	Pesquisar itens com produto ou desenvolvimento no corpo.
NÃO	NOT body:proposal Body:(NOT proposal)	Pesquisar mensagens sem proposta no corpo.

AND é sempre o conector padrão. Por exemplo, subject:project AND body:proposal é o mesmo que subject:project body:proposal. Os conectores lógicos são sensíveis a minúsculas e maiúsculas. Por exemplo, body:(project Or proposal) pesquisa mensagens com 'project', 'or' e 'proposal' no corpo, em vez de 'projeto' ou 'proposta'. O símbolo de adição (+) é equivalente a AND. O símbolo de hífen (-) é equivalente a NOT. Por exemplo, body:(project - proposal) pesquisa mensagens com 'projeto' mas sem 'proposta' no corpo.

A cadeia de caracteres de consulta também pode conter propriedades não indexadas para pesquisa. Se a cadeia de caracteres de consulta contiver propriedades não indexadas, a pesquisa poderá executar uma pesquisa Exchange nas propriedades indexadas e uma pesquisa de armazenamento nas propriedades não indexadas.

O esquema que descreve este elemento está localizado no diretório virtual do IIS que hospeda os Serviços Web do Exchange.

Exemplo

O exemplo a seguir mostra uma solicitação para pesquisar mensagens na Caixa de Entrada com Descoberta Automática no assunto.

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

O exemplo a seguir mostra uma resposta bem-sucedida.

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

Elemento de informações

Código	Nome
Namespace	http://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquema	Esquema de mensagens
Arquivo de validação	Messages.xsd
Pode estar vazio	False