QueryString (QueryStringType)

Статья
03/29/2023

Элемент QueryString содержит строку запроса почтового ящика на основе расширенного синтаксиса запросов (AQS).

<QueryString/>

QueryStringType

Атрибуты и элементы

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут	Описание
ResetCache	Указывает, что кэш следует сбросить.
ReturnDeletedItems	Указывает, что удаленные элементы должны быть возвращены.
ReturnHighlightTerms	Указывает, что указанные термины должны быть возвращены.

Дочерние элементы

Нет.

Родительские элементы

Элемент	Описание
FindItem	Определяет запрос на поиск элементов в почтовом ящике. Ниже приведено выражение XPath к этому элементу: /FindItem.

Текстовое значение

Текстовое значение элемента QueryString представляет запрос почтового ящика, который выполнен с помощью подмножества Расширенного синтаксиса запросов (AQS). Сведения о поддерживаемых параметрах синтаксиса для строк запроса см. в разделе замечаний.

Примечания

В Exchange Server 2010 этот элемент является типом строки схемы XML. В версиях Exchange, начиная с Exchange Server 2013, включая Exchange Online, типом этого элемента является QueryStringType. Это изменение не нарушает работу существующих клиентов, поскольку добавляет три новых необязательных атрибута.

Элемент QueryString исключает использование ограничений EWS. AQS в EWS поддерживает три типа ограничений: ограничение фазы слов, ограничение диапазона дат и ограничение типа сообщения. В следующих таблицах перечислены поддерживаемые свойства поиска для каждого типа ограничения.

Ограничение фазы слова

Свойство	Пример	Функция
from	От: Денис От: Денис Кондрашев	Поиск элементов, отправленных Денисом. Поиск элементов, отправленных Денисом Кондрашевом. Отправитель должен быть именно «Денис Кондрашев».
на	Кому: Денис	Поиск элементов, отправленных Денису.
копия;	Копия: Денис	Поиск элементов с именем Денис в строке «Копия».
СК.	Скрытая копия: Денис	Поиск элементов с именем Денис в строке « Скрытая копия».
Участники	Участники: Денис	Поиск элементов с именем Денис в строках «Кому», «копия» или «скрытая копия».
Subject	Тема: продукт Тема: (разработка продукта) Тема: разработка продукта	Поиск элементов с продуктом в строке темы. Поиск элементов с продуктом и разработкой в строке темы.
Текст Содержимое	Текст сообщения: ход выполнения Содержимое: ход выполнения	Поиск элементов с ходом выполнения в тексте сообщения.
Вложение	Вложение: отчет	Поиск элементов с отчетом в имени файла вложения или тексте файла.
(свойство не указано)	Разработка продуктов	Поиск элементов, которые содержат как продукт, так и разработку, во всех свойствах фазы слова.

Сопоставление ограничения фазы слова всегда нечувствительно к регистру. Ограничение фазы слова поддерживает два типа соответствия: совпадение префикса или точное совпадение. Соответствие префикса — это поведение сопоставления по умолчанию. Если вам нужно точное совпадение, используйте двойные кавычки. Например, тема: «продукт» соответствует «продукту», но не «производству» в теме. Несколько слов в двойных кавычках ограничивают как фазы слов, так и их порядок. Например, «продукт win» соответствует только «продукту win», а не «продукту win95» или «продукту win». Для определения соответствия префикса с ограниченным порядком можно использовать звездочку (*). Например, "win product"* соответствует "win95 product", "windows production line", но не "windows new product" или "product of win". Вы можете искать все сообщения, отправленные из домена или в него. Например, от:"@hotmail.com" возвращает все сообщения, отправленные от hotmail.com.

В следующей таблице описаны ограничения диапазона дат.

Ограничение диапазона дат

Свойство	Пример	Функция
Sent	Отправлено: на прошлой неделе Отправлено: 01.01.2001 Отправлено: 01.01.2001..15.01.2001	Поиск элементов, отправленных на прошлой неделе. Поиск элементов, отправленных 1 января 2001 г. Поиск элементов, отправленных с 1 января 2001 г. по 15 января 2001 г.
ПОЛУЧЕНО	Получено: сегодня Получено: 01.01.2001	Поиск элементов, полученных сегодня. Поиск элементов, полученных 1 января 2001 г.

Две точки (..) — оператор диапазона. Его можно использовать для определения диапазона с датой начала и окончания. Чтобы указать дату, можно использовать относительные даты. Поддерживаются следующие относительные даты:

Относительные даты: сегодня, завтра, вчера
Относительные даты из нескольких слов: эта неделя, следующий месяц, прошлая неделя, прошлый месяц или следующий год.
Дни: воскресенье, понедельник, вторник, среда, четверг, пятница, суббота
Январь, февраль, март, апрель, май, июнь, июль, август, сентябрь, октябрь, ноябрь, декабрь

В следующей таблице описаны ограничения типа сообщения.

Ограничение типа сообщения

Свойство	Пример	Функция
Kind	Вид: задачи	Поиск всех элементов задач.

AQS в EWS использует свойство Kind для указания типа сообщения. Свойство Kind можно использовать со следующими типами элементов:

email
meetings
tasks
notes
docs
journals
contacts
im

В следующей таблице описывается группировка логических соединителей.

Группировка логических соединителей

Соединитель	Пример	Функция
AND	Тема: продукт И тема:разработка Тема: (продукт И разработка) Тема: (разработка продукта)	Поиск элементов с продуктом и разработкой в строке темы.
ИЛИ	Текст сообщения: проект ИЛИ текст сообщения:предложение Текст сообщения: (проект ИЛИ предложение)	Поиск элементов с продуктом или разработкой в тексте сообщения.
NOT	НЕ текст сообщения:предложение Текст сообщения: (НЕ предложение)	Поиск сообщений без предложения в тексте сообщения.

И всегда является соединителем по умолчанию. Например, «тема:проект» И «текст сообщения:предложение» — это то же самое, что и «тема:текст сообщения проекта:предложение». Логические соединители чувствительны к регистру. Например, текст сообщения:(проект или предложение) ищет сообщения со словами «проект», «или» и «предложение» в текста сообщения вместо «проект» или «предложение». Символ плюс (+) эквивалентен И. Символ дефис (-) эквивалентен НЕ. Например, текст сообщения:(проект-предложение) ищет сообщения со словом «проект», но без слова «предложение» в тексте сообщения.

Строка запроса также может содержать неиндексированные свойства для поиска. Если строка запроса содержит неиндексированные свойства, поиск может выполнять поиск Exchange по индексированным свойствам и поиск в хранилище по неиндексированным свойствам.

Схема, описывающая этот элемент, находится в виртуальном каталоге IIS, в котором размещены веб-службы Exchange.

Пример

В следующем примере показан запрос на поиск сообщений в папке «Входящие» с автоматическим обнаружением в теме.

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

Сведения об элементе

Code	Имя
Пространство имен	https://schemas.microsoft.com/exchange/services/2006/messages
Имя схемы	Схема Messages
Файл проверки	Messages.xsd
Может быть пустым	False