QueryString (QueryStringType)

Article
03/29/2023

L'élément QueryString contient une chaîne de requête de boîte aux lettres basée sur l'Advanced Query Syntax (AQS).

<QueryString/>

QueryStringType

Attributs et éléments

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
ResetCache	Indique que le cache doit être réinitialisé.
ReturnDeletedItems	Indique que les éléments supprimés doivent être renvoyés.
ReturnHighlightTerms	Indique que les termes en surbrillance doivent être retournés.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
FindItem	Définit une demande de recherche d’éléments dans une boîte aux lettres. Voici l’expression XPath de cet élément : /FindItem.

Valeur de texte

La valeur de texte de l’élément QueryString représente une requête de boîte aux lettres qui est réalisée à l’aide d’un sous-ensemble de la syntaxe de requête avancée (AQS). Consultez la section remarques pour plus d’informations sur les options de syntaxe prise en charge pour les chaînes de requête.

Remarques

Dans Exchange Server 2010, cet élément est un type de chaîne de schéma XML. Dans les versions de Exchange à partir de Exchange Server 2013, y compris Exchange Online, le type de cet élément est QueryStringType. Cette modification ne casse aucun client existant, car elle ajoute trois nouveaux attributs facultatifs.

L’élément QueryString exclut l’utilisation de restrictions EWS. L'AQS dans le SAP prend en charge trois types de restrictions : la restriction de la phase du mot, la restriction de la plage de dates et la restriction du type de message. Les tableaux suivants listent les propriétés de recherche prise en charge pour chaque type de restriction.

Restriction de phase Word

Propriété	Exemple	Fonction
de	From:Dean From:"Dean Halstead »	Rechercher des éléments envoyés à partir de Dean. Rechercher des éléments envoyés à partir de Dean Halstead. L’expéditeur doit être exactement « Dean Halstead ».
au	To:Dean	Rechercher des éléments envoyés à Dean.
cc	Cc:Dean	Recherchez des éléments avec Dean sur la ligne Cc.
bcc	Bcc:Dean	Recherchez des éléments avec Dean sur la ligne Bcc.
Participants	Participants:Dean	Recherchez des éléments avec Dean dans les champs À, Cc ou Cci.
Sujet	Subject:product Objet :(développement de produits) Objet : « développement de produits »	Recherchez des éléments avec le produit dans l’objet. Recherchez des éléments avec produit et développement dans l’objet.
Corps Contenu	Body:progress Content:progress	Recherchez des éléments avec une progression dans le corps.
Pièce jointe	Attachment:report	Recherchez les éléments dont le rapport se trouverait dans le nom ou le corps du fichier en pièce jointe.
(la propriété n’est pas spécifiée)	Développement de produits	Recherchez les éléments qui contiennent à la fois produit et développement dans toutes les propriétés de la phase de mots.

La correspondance de restriction de phase Word ne correspond toujours pas à la cas. La restriction de la phase des mots prend en charge deux types de correspondance : correspondance préfixe ou correspondance exacte. La correspondance de préfixe est le comportement de correspondance par défaut. Si vous souhaitez une correspondance exacte, utilisez des guillemets doubles. Par exemple, subject:"product » correspond à « product », mais pas à « production » dans l’objet. Plusieurs mots entre guillemets limitent les phases de mots et leur ordre. Par exemple, "win product" ne correspond qu'à "win product", et non à "win95 product" ou "product of win". Vous pouvez utiliser un astérisque (*) pour définir une correspondance de préfixe avec l’ordre restreint. Par exemple, « win product »* correspond à « win95 product », « windows production line » mais pas à « windows new product » ou « product of win ». Vous pouvez effectuer une recherche dans tous les messages envoyés depuis ou vers un domaine. Par exemple, from:"@hotmail.com » renvoie tous les messages envoyés à partir hotmail.com.

Le tableau suivant décrit les restrictions de plage de dates.

Restriction de plage de dates

Propriété	Exemple	Fonction
Sent	Envoyé :la semaine dernière Envoyé:01/01/2001 Envoyé:01/01/2001..01/15/2001	Éléments de recherche envoyés la semaine dernière. Éléments de recherche envoyés le 1er janvier 2001. Éléments de recherche envoyés entre le 1er janvier 2001 et le 15 janvier 2001.
Received	Reçu :aujourd’hui Reçu :01/01/2001	Éléments de recherche reçus aujourd’hui. Éléments de recherche reçus le 1er janvier 2001.

Les deux points (..) sont un opérateur de plage. Elle peut être utilisée pour définir une plage avec une date de début et une date de fin. Pour spécifier une date, vous pouvez utiliser des dates relatives. Les dates relatives suivantes sont pris en charge :

Dates relatives : aujourd’hui, demain, hier
Dates relatives à plusieurs mots : cette semaine, le mois suivant, la semaine dernière, le mois passé ou l’année prochaine
Jours : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi
Janvier, février, mars, avril, mai, juin, juillet, août, septembre, octobre, novembre et décembre

Le tableau suivant décrit les restrictions de type de message.

Restriction de type de message

Propriété	Exemple	Fonction
Kind	Genre :tâches	Recherchez tous les éléments de tâche.

AQS dans EWS utilise la propriété Kind pour spécifier le type de message. La propriété Kind peut être utilisée avec les types d’éléments suivants :

email
meetings
tasks
notes
docs
journals
contacts
im

Le tableau suivant décrit le regroupement de connecteurs logiques.

Regroupement de connecteurs logiques

Connector	Exemple	Fonction
AND	Subject:product AND subject:development Objet :(produit ET développement) Objet :(développement de produits)	Rechercher des éléments avec le produit et le développement dans l’objet.
OR	Corps: projet OU corps:proposition Corps :(projet OU proposition)	Rechercher des éléments avec le produit ou le développement dans le corps.
NOT	NOT body:proposition Corps :(PAS de proposition)	Rechercher des messages sans proposition dans le corps.

AND est toujours le connecteur par défaut. Par exemple, subject:project AND body:proposal est identique à subject:project body:proposal. Les connecteurs logiques sont sensibles à la cas. Par exemple, body :(project ou proposal) recherche les messages dont le corps contient "project", "ou" et "proposal" au lieu de "project" ou "proposal". Le symbole plus (+) équivaut à AND. Le symbole de tiret (-) équivaut à NOT. Par exemple, body:(project - proposal) recherche les messages avec « project » mais sans « proposal » dans le corps.

La chaîne de requête peut également contenir des propriétés non indexées pour la recherche. Si la chaîne de requête contient des propriétés non indexées, la recherche peut effectuer une recherche Exchange sur les propriétés indexées et une recherche magasin sur les propriétés non indexées.

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel IIS qui héberge les services web Exchange.

Exemple

L’exemple suivant montre une demande de recherche de messages dans la boîte de réception avec découverte automatique dans l’objet.

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

L'exemple suivant montre une réponse réussie à la demande.

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

Informations sur l'élément

Code	Name
Espace de noms	http://schemas.microsoft.com/exchange/services/2006/messages
Nom du schéma	Schéma Messages
Fichier de validation	Messages.xsd
Peut être vide	False