Прочитать на английском

Поделиться через

Операция GetReminders

  • Статья

Найдите сведения об операции GetReminders EWS.

Операция GetReminders Exchange Web Services (EWS) извлекает напоминания для элементов календаря и задач.

Эта операция появилась в Exchange Server 2013.

Использование операции GetReminders

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

Чтобы получить все текущие напоминания, рекомендуется задать параметру ReminderType значение Все , а для параметра EndTime — текущее время.

Если элементы BeginTime и EndTime включены в запрос, ответ содержит напоминания для всех элементов календаря и задач, которые находятся между ними, имеют напоминание, которое происходит между BeginTime и EndTime.

В следующей таблице описано поведение элемента ReminderType при включении элементов BeginTime и EndTime .

Значение элемента ReminderType Описание
Все
 Напоминания, возникающие между начальным и конечным временем.
Current
 Напоминания, возвращаемые всеми, а также напоминания, которые раньше запрошенного периода времени, если событие продолжается, а также все встречи независимо от возраста.
Старый
 Напоминания, возвращенные all, минус события, которые еще не завершены, минус все встречи. Для элементов BeginTime и EndTime необходимо задать значение Old .

Заголовки SOAP операции GetReminders

Операция GetReminders может использовать заголовки SOAP, перечисленные в следующей таблице.

Имя заголовка Элемент Описание
Олицетворения
ExchangeImpersonation
Определяет пользователя, которого олицетворяет клиентское приложение. Этот заголовок применим к запросу.
MailboxCulture
MailboxCulture
Определяет язык и региональные параметры, определенные в RFC 3066 "Теги для идентификации языков", которые будут использоваться для доступа к почтовому ящику. Этот заголовок применим к запросу.
RequestVersion
RequestServerVersion
Определяет версию схемы для запроса операции. Этот заголовок применим к запросу.
ServerVersion
ServerVersionInfo
Определяет версию сервера, который ответил на запрос. Этот заголовок применим к ответу.

Пример запроса на операцию GetReminders

В следующем примере запроса операции GetReminders показано, как получить первые пять элементов календаря, возникающих между BeginTime и EndTime.

XML 
<?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="Exchange2013" />
  </soap:Header>
  <soap:Body>
    <m:GetReminders>
      <m:EndTime>2014-04-16T21:00:00Z</m:EndTime>
      <m:ReminderType>All</m:ReminderType>
    </m:GetReminders>
  </soap:Body>
</soap:Envelope>

В примере текста SOAP запроса содержатся следующие элементы:

Текст SOAP также может содержать следующие элементы:

Успешный ответ на операцию GetReminders

В следующем примере показан успешный ответ на запрос операции GetReminders . Ответ содержит напоминание о элементе календаря "Собрание группы" и напоминание о задаче "Задача для отправки заметок о собрании".

Примечание

Идентификаторы сокращены для сохранения удобочитаемости.

XML 
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="918"
                       MinorBuildNumber="7"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <GetRemindersResponse ResponseClass="Success"
                          xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <Reminders>
        <Reminder xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
          <Subject>Team meeting</Subject>
          <Location />
          <ReminderTime>2014-04-15T21:00:00Z</ReminderTime>
          <StartDate>2014-04-15T21:00:00Z</StartDate>
          <EndDate>2014-04-15T21:30:00Z</EndDate>
          <ItemId Id="vQAAAA=="
                  ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAACRoV4" />
          <RecurringMasterItemId Id="K7u5AAA=" ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAACRoV0" />
          <ReminderGroup>Calendar</ReminderGroup>
          <UID>6CF2FA62</UID>
        </Reminder>
        <Reminder xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
          <Subject>Task to send meeting notes</Subject>
          <Location />
          <ReminderTime>2014-04-16T14:00:00Z</ReminderTime>
          <StartDate>0001-01-02T00:00:00Z</StartDate>
          <EndDate>0001-01-02T00:00:00Z</EndDate>
          <ItemId Id="vAAAAA=="
                  ChangeKey="EwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAIDg==" />
          <ReminderGroup>Task</ReminderGroup>
          <UID>vAAAAA==</UID>
        </Reminder>
      </Reminders>
    </GetRemindersResponse>
  </s:Body>
</s:Envelope>

Текст SOAP ответа содержит следующие элементы:

Пример ответа об ошибке операции GetReminders

В следующем примере показан ответ на ошибку на запрос операции GetReminders . Это ответ на запрос, в котором дата окончания была раньше даты начала.

XML 
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="918"
                       MinorBuildNumber="7"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <GetRemindersResponse ResponseClass="Error"
                          xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <MessageText>EndDate is earlier than StartDate</MessageText>
      <ResponseCode>ErrorInvalidOperation</ResponseCode>
      <DescriptiveLinkKey>0</DescriptiveLinkKey>
    </GetRemindersResponse>
  </s:Body>
</s:Envelope>

Текст soap ответа на ошибку содержит следующие элементы:

Дополнительные коды ошибок, которые являются общими для EWS и относятся к этой операции, см. в разделе ResponseCode.

См. также