QueryString (QueryStringType)

Artikel
03/29/2023

Das QueryString-Element enthält eine Postfachabfragezeichenfolge, die auf der erweiterten Abfragesyntax (Advanced Query Syntax, AQS) basiert.

<QueryString/>

QueryStringType

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut	Beschreibung
ResetCache	Gibt an, dass der Cache zurückgesetzt werden soll.
ReturnDeletedItems	Gibt an, dass gelöschte Elemente zurückgegeben werden sollen.
ReturnHighlightTerms	Gibt an, dass hervorgehobene Begriffe zurückgegeben werden sollen.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
FindItem	Definiert eine Anforderung zum Suchen von Elementen in einem Postfach. Im Folgenden finden Sie den XPath-Ausdruck für dieses Element: /FindItem.

Textwert

Der Textwert des QueryString-Elements stellt eine Postfachabfrage dar, die mithilfe einer Teilmenge der Advanced Query Syntax (AQS) ausgeführt wird. Informationen zu den unterstützten Syntaxoptionen für Abfragezeichenfolgen finden Sie im Abschnitt „Bemerkungen“.

Hinweise

In Exchange Server 2010 ist dieses Element ein XML-Schemazeichenfolgentyp. In Versionen von Exchange, die mit Exchange Server 2013 beginnen, einschließlich Exchange Online, ist der Typ für dieses Element QueryStringType. Durch diese Änderung werden keine vorhandenen Clients beschädigt, da drei neue optionale Attribute hinzugefügt werden.

Das QueryString-Element schließt die Verwendung von EWS-Einschränkungen aus. AQS in EWS unterstützt drei Arten von Einschränkungen: Wortphaseneinschränkungen, Datumsbereichseinschränkungen und Nachrichtentypeinschränkungen. In den folgenden Tabellen sind die unterstützten Sucheigenschaften für jeden Einschränkungstyp aufgelistet.

Wortphaseneinschränkung

Eigenschaft	Beispiel	Funktion
von	From:Dean From:“Dean Halstead“	Suche nach von Dean gesendeten Elementen. Suche nach von Dean Halstead gesendeten Elementen. Der Absender muss genau „Dean Halstead" sein.
in	To:Dean	Suche nach Elementen, die an Dean gesendet wurden.
cc	Cc:Dean	Suche nach Elementen, die Dean in der Cc-Zeile enthalten.
bcc	Bcc:Dean	Suche nach Elementen, die Dean in der Bcc-Zeile enthalten.
Teilnehmer	Participants:Dean	Suche nach Elementen, die Dean in den „To“-, „Cc“- oder „Bcc“-Feldern enthalten.
Betreff	Subject:Produkt Subject:(Produkt Entwicklung) Subject:“Produkt Entwicklung“	Suche nach Elementen, die „Produkt“ im Betreff enthalten. Suche nach Elementen, die „Produkt“ und „Entwicklung“ im Betreff enthalten.
Body Inhalt	Body:Fortschritt Content:Fortschritt	Suche nach Elementen, die „Fortschritt“ im Textkörper enthalten.
Attachment	Attachment:Bericht	Suche nach Elementen, die „Bericht“ im Dateinamen oder im Textkörper der Anlage enthalten.
(Eigenschaft ist nicht angegeben)	Produktentwicklung	Suche nach Elementen, die sowohl „Produkt“ als auch „Entwicklung“ in allen Wortphaseneigenschaften enthalten.

Bei der Übereinstimmung mit Wortphaseneinschränkung wird immer die Groß-/Kleinschreibung beachtet. Die Wortphaseneinschränkung unterstützt zwei Übereinstimmungstypen: Präfixübereinstimmung oder genaue Übereinstimmung. Präfixübereinstimmung ist das Standardüberstimmungsverhalten. Wenn Sie eine genaue Übereinstimmung wünschen, verwenden Sie doppelte Anführungszeichen. Zum Beispiel entspricht „Subject:„Produkt“" „Produkt", aber nicht „Produktion" im Betreff. Mehrere Wörter in doppelten Anführungszeichen schränken sowohl Wortphasen als auch deren Reihenfolge ein. Zum Beispiel entspricht „win product" nur „win product", aber nicht „win95 product" oder „product of win". Sie können ein Sternchen (*) verwenden, um eine Präfix-Übereinstimmung mit eingeschränkter Reihenfolge zu definieren. Beispielsweise entspricht "win product"* "win95 product", "windows production line", aber nicht "windows new product" oder "product of win". Sie können nach allen Nachrichten suchen, die von oder an eine Domäne gesendet wurden. Beispielsweise gibt „from:„@hotmail.com“" alle Nachrichten zurück, die von @hotmail.com gesendet wurden.

In der folgenden Tabelle werden Datumsbereichseinschränkungen beschrieben.

Datumsbereichseinschränkung

Eigenschaft	Beispiel	Funktion
Gesendet	Sent:letzte Woche Sent:01.01.2001 Sent:01.01.2001..15.01.2001	Suche nach Elementen, die letzte Woche gesendet wurden. Suche nach Elementen, die am 1. Januar 2001 gesendet wurden. Suche nach Elementen, die zwischen dem 1. Januar 2001 und dem 15. Januar 2001 gesendet wurden.
Auszahlung	Recieved:heute Recieved:01.01.2001	Suche nach Elementen, die heute empfangen wurden. Suche nach Elementen, die am 1. Januar 2001 empfangen wurden.

Die beiden Punkte (..) sind ein Bereichsoperator. Es kann verwendet werden, um einen Bereich mit einem Start- und Enddatum zu definieren. Um ein Datum anzugeben, können Sie relative Datumsangaben verwenden. Die folgenden relativen Datumsangaben werden unterstützt:

Relative Datumsangaben: Heute, morgen, gestrigen
Mehrzeilige relative Datumsangaben: Diese Woche, der nächste Monat, die letzte Woche, der letzte Monat oder das kommende Jahr
Tage: Sonntag, Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag
Januar, Februar, März, April, Mai, Juni, Juli, August, September, Oktober, November, Dezember

In der folgenden Tabelle werden Einschränkungen für den Nachrichtentyp beschrieben.

Einschränkung des Nachrichtentyps

Eigenschaft	Beispiel	Funktion
Art	Kind:Aufgaben	Suche nach allen Aufgabenelementen.

AQS in EWS verwendet die Kind-Eigenschaft, um den Nachrichtentyp anzugeben. Die Kind-Eigenschaft kann mit den folgenden Elementtypen verwendet werden:

email
meetings
tasks
notes
docs
journals
contacts
im

Die folgende Tabelle beschreibt die Gruppierung logischer Connectors.

Gruppierung logischer Connectors

Connector	Beispiel	Funktion
AND	Subject:Produkt AND subject:Entwicklung Subject:(Produkt AND Entwicklung) Subject:(Produkt Entwicklung)	Suche nach Elementen, die „Produkt“ und „Entwicklung“ im Betreff enthalten.
OR	Body:Projekt OR body:Vorschlag Body:(Projekt OR Vorschlag)	Suche nach Elementen, die entweder „Produkt“ oder „Entwicklung“ im Textkörper enthalten.
NOT	NOT body:Vorschlag Body:(NOT Vorschlag)	Suche nach Nachrichten ohne „Vorschlag“ im Textkörper.

AND ist immer der Standard-Connector. Beispielsweise ist „Subject:Projekt AND body:Vorschlag“ identisch mit „Subject:Projekt body:Vorschlag“. Bei logischen Connectors wird die Groß-/Kleinschreibung beachtet. Beispielsweise sucht „body:(Projekt Or Vorschlag)“ nach Nachrichten mit „Projekt“, „Or“ und „Vorschlag“ im Textkörper anstelle von „Projekt“ oder „Vorschlag“. Das Pluszeichen (+) entspricht AND. Das Bindestrichsymbol (-) entspricht NOT. Zum Beispiel sucht „body:(Projekt - Vorschlag)“ nach Nachrichten mit „Projekt“, aber ohne „Vorschlag“ im Textkörper.

Die Abfragezeichenfolge kann auch nicht indizierte Eigenschaften für die Suche enthalten. Wenn die Abfragezeichenfolge nicht indizierte Eigenschaften enthält, kann die Suche eine Exchange-Suche für die indizierten Eigenschaften und eine Store-Suche für die nicht indizierten Eigenschaften durchführen.

Das Schema, das dieses Element beschreibt, befindet sich im virtuellen IIS-Verzeichnis, das Exchange-Webdienste hostet.

Beispiel

Das folgende Beispiel zeigt eine Aufforderung zur Suche nach Nachrichten im Posteingang mit Autodiscover im Betreff.

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

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die Anfrage.

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

Informationen zu Elementen

Code	Name
Namespace	http://schemas.microsoft.com/exchange/services/2006/messages
Name des Schemas	Nachrichtenschema
Überprüfungsdatei	Messages.xsd
Kann leer sein	False