Операция 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 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="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 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="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<Reminders>
<Reminder xmlns="https://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="https://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 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="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://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="https://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.
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по