Операция PerformReminderAction

Статья
03/29/2023

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

Операция PerformReminderAction Exchange Web Services (EWS) инициирует действие закрытия или отмены напоминания.

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

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

С помощью операции PerformReminderAction можно закрыть или отложить напоминания (задержки), возвращаемые операцией GetReminders . Чтобы отложить напоминание, присвойте actionType значение Отложить, а для значения NewReminderTime задайте время позже текущего Значения ReminderTime, в противном случае newReminderTime игнорируется сервером. Если напоминание предназначено для вхождения повторяющегося собрания, а действие "Отложить " выполняется для напоминания с newReminderTime , которое находится после напоминания о следующем вхождлении, напоминание фактически отклоняется.

Чтобы закрыть напоминание, задайте для параметра ActionType значение Закрыть. Когда сервер обрабатывает запрос, сервер изменяет значение IsReminderSet для элемента с True на False.

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

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

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

Пример запроса операции PerformReminderAction

В следующем примере запроса на операцию PerformReminderAction показано, как отложить текущее напоминание и задать новое время напоминания. Обратите внимание, что необходимо включить ChangeKey для ItemId , а значение NewReminderTime должно быть установлено на время позже , чем значение ReminderTime , возвращаемое операцией GetReminders .

<?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:PerformReminderAction>
      <m:ReminderItemActions>
        <t:ReminderItemAction>
          <t:ActionType>Snooze</t:ActionType>
          <t:ItemId Id="vwAAAA=="
           ChangeKey="DwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAUDA=="/>
          <t:NewReminderTime>2014-04-16T17:00:00Z</t:NewReminderTime>
        </t:ReminderItemAction>
      </m:ReminderItemActions>
    </m:PerformReminderAction>
  </soap:Body>
</soap:Envelope>

Примечание.

Значение ItemId сокращено для сохранения удобочитаемости.

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

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

В следующем примере показан успешный ответ на запрос операции PerformReminderAction . Элемент UpdatedItemIds содержит ItemIds обновленного элемента календаря.

<?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="921"
                       MinorBuildNumber="20"
                       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">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds>
        <ItemId Id="vwAAAA=="
                ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAAJKP+S"/>
      </UpdatedItemIds>
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

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

Пример ответа на ошибку операции PerformReminderAction

В следующем примере показан ответ на запрос операции PerformReminderAction , если на сервере не было внесено никаких изменений. Это ответ, в котором был отправлен запрос, но не были возвращены значения UpdatedItemId, что означает, что напоминания не были изменены.

<?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">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds />
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

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

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

См. также

Операция GetReminders

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