QueryString (QueryStringType)

  • [アーティクル]

Query String 要素には、高度な検索テクニック (AQS) に基づくメール ボックス クエリ文字列が含まれています。

<QueryString/>

QueryStringType

属性と要素

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性 説明
ResetCache
 キャッシュをリセットする必要があることを示します。
ReturnDeletedItems
 削除されたアイテムを返す必要があることを示します。
ReturnHighlightTerms
 強調表示されている用語を返す必要があることを示します。

子要素

なし。

親要素

要素 説明
FindItem
メールボックス内のアイテムを検索する要求を定義します。
この要素への XPath 式は次のとおりです: /FindItem。

テキスト値

QueryString 要素のテキスト値は、高度なクエリ構文 (AQS) のサブセットを使用して行われたメールボックス クエリを表します。 クエリ文字列でサポートされている構文オプションについては、備考のセクションを参照してください。

注釈

Exchange Server 2010 では、この要素は XML スキーマ文字列型です。 Exchange Online を含む Exchange Server 2013 以降のバージョンの Exchangeで は、この要素のタイプは QueryStringType です。 この変更により、3 つの新しいオプション属性が追加されるため、既存のクライアントが破損することはありません。

QueryString 要素は、EWS 制限の使用を除外します。 EWS の AQS は、ワードフェーズ制限、日付範囲制限、およびメッセージ タイプ制限の 3 種類の制限をサポートします。 次の表に、各制限タイプでサポートされている検索プロパティを示します。

Word フェーズの制限

Property 例 関数
from
 From: Dean
From: "Dean Halstead"
 Dean から送信されたアイテムを検索します。
Dean Halstead から送信されたアイテムを検索します。 送信者は正確に "Dean Halstead" である必要があります。
へ
 To:Dean
 Dean に送信されたアイテムを検索します。
cc
 Cc:Dean
 Cc 行に Dean があるアイテムを検索します。
bcc
 Bcc:Dean
 Bcc 行に Dean があるアイテムを検索します。
参加者
 Participants:Dean
 [To]、[Cc]、または [Bcc] フィールドで、Dean を含むアイテムを検索します。
件名
 件名:製品
件名:(製品開発)
件名:"製品開発"
 件名に製品があるアイテムを検索します。
件名に製品と開発を含むアイテムを検索します。
Body
コンテンツ
 Body:progress
Content:progress
 本文の進行状況を持つアイテムを検索します。
添付ファイル
 attachment:report
 添付ファイル名またはファイル本文内のレポートを含むアイテムを検索します。
(プロパティが指定されていません)
 製品開発
 すべての単語フェーズ プロパティで、製品と開発の両方を含むアイテムを検索します。

Word のフェーズ制限の一致は、常に大文字と小文字を区別しません。 Word フェーズの制限では、プレフィックスの一致または完全一致の 2 つの一致の種類がサポートされます。 プレフィックスの一致は、既定の一致動作です。 完全一致が必要な場合は、二重引用符を使用します。 たとえば、subject:"product" は件名の 'product' と一致しますが、'production' は一致しません。 二重引用符で囲まれた複数の単語は、単語フェーズとその順序の両方を制限します。 たとえば、"win product" は 'win95 product' または 'product of win' ではなく'win product' にのみ一致します。 アスタリスク (*) を使用して、順序が制限されたプレフィックスの一致を定義できます。 たとえば、"win product"* は 'win95 product'、'windows production line' と一致しますが、"windows new product" や 'product of win' には一致しません。 ドメインから送信された、またはドメインに送信されたメッセージを検索できます。 たとえば、from:"@hotmail.com" は、hotmail.com　から送信されたすべてのメッセージを返します。

次の表では、日付範囲の制限について説明します。

日付範囲の制限

Property 例 関数
Sent
 Sent:last week
Sent:01/01/2001
Sent:01/01/2001..01/15/2001
 先週送信されたアイテムを検索します。
2001 年 1 月 1 日に送信されたアイテムを検索します。
2001 年 1 月 1 日から 2001 年 1 月 15 日の間に送信されたアイテムを検索します。
受信済み
 Received:today
Received:01/01/2001
 今日受信したアイテムを検索します。
2001 年 1 月 1 日に受信したアイテムを検索します。

2 つのドット (..) は範囲演算子です。 開始日と終了日を含む範囲を定義するために使用できます。 日付を指定するには、相対日付を使用できます。 次の相対日付がサポートされています。

  • 相対日付: 今日、明日、昨日

  • 複数ワードの相対日付: 今週、来月、先週、過去 1 か月、または来年度

  • 日: 日曜日、月曜日、火曜日、水曜日、木曜日、金曜日、土曜日

  • 1 月、2 月、3 月、4 月、5 月、6 月、7 月、8 月、9 月、10 月、11 月、12 月

次の表に、メッセージの種類の制限について説明します。

メッセージの種類の制限

Property 例 関数
Kind
 Kind:tasks
 すべてのタスク アイテムを検索します。

EWS の AQS では、 Kind プロパティを使用してメッセージの種類を指定します。 Kind プロパティは、次のアイテムの種類で使用できます。

  • メール

  • meetings

  • tasks

  • notes

  • docs

  • journals

  • contacts

  • im

次の表では、論理コネクタのグループ化について説明します。

論理コネクタのグループ化

Connector 例 関数
AND
 Subject:product AND subject:development
Subject:(product AND development)
Subject:(product development)
 件名に製品と開発の両方を含むアイテムを検索します。
または
 Body:project OR body:proposal
Body:(project OR proposal)
 本体に製品または開発を含むアイテムを検索します。
NOT
 NOT body:proposal
Body:(NOT proposal)
 本文に提案なしでメッセージを検索します。

AND は常に既定のコネクタです。 たとえば、subject:project AND body:proposal は subject:project body:proposal と同じです。 論理コネクタでは大文字と小文字が区別されます。 たとえば、body:(project Or proposal) は、'project' または 'proposal' ではなく、本文に 'project'、'or'、'proposal' を含むメッセージを検索します。 プラス記号 (+) は AND と同じです。 ハイフン記号 (-) は NOT と同じです。 たとえば、body:(project - proposal) は、本文に 'project' が含まれますが、"proposal" が含まれていないメッセージを検索します。

クエリ文字列には、検索用のインデックス付けされていないプロパティを含めすることもできます。 クエリ文字列にインデックス付けされていないプロパティが含まれている場合、検索では、インデックス付けされたプロパティに対して Exchange 検索が実行され、インデックス付けされていないプロパティに対してストア検索が実行される場合があります。

この要素を記述するスキーマは、Exchange Web サービスをホストする IIS 仮想ディレクトリに置かれています。

例

次の例は、件名に自動検出が含まれる受信トレイでメッセージを検索する要求を示しています。

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

次の例は、要求に対する正常な応答を示しています。

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

要素の情報

コード 名前
Namespace
 https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名
 メッセージ スキーマ
検証ファイル
 Messages.xsd
空に設定可能
 False

関連項目

FindItem 操作

FindConversation 操作