Share via

QueryString (QueryStringType)

  • Artikel

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="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>

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="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>

Informationen zu Elementen

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

Siehe auch

FindItem-Vorgang

FindConversation-Vorgang