Операция MarkAllItemsAsRead

  • Статья

Сведения об операции MarkAllItemsAsRead EWS.

Операция MarkAllItemsAsRead задает свойство IsRead для всех элементов в одной или несколько папок, чтобы указать, что все элементы либо прочитанные, либо непрочитанные.

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

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

Операция MarkAllItemsAsRead может установить свойство IsRead для всех элементов в папках, идентифицированных идентификатором папок Exchange веб-служб (EWS) или именем Exchange по умолчанию. Операция MarkAllItemsAsRead также может подавлять отправку квитанций на чтение для элементов, помеченных как чтение.

MarkAllItemsAsRead— заглавные заготки операции SOAP

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

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

Пример запроса на операцию MarkAllItemsAsRead: Пометить все элементы в папке в качестве чтения

В следующем примере запроса операции MarkAllItemsAsRead показано, как установить свойство IsRead, которое также называется флагом чтения, для всех элементов в папке. В этом примере также показано, что квитанции чтения не отправляются в ответ на запросы на получение чтения.

Примечание

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

<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:MarkAllItemsAsRead>
         <m:ReadFlag>true</m:ReadFlag>
         <m:SuppressReadReceipts>true</m:SuppressReadReceipts>
         <m:FolderIds>
            <t:FolderId Id="AAMkADEzOTExYZRAAA=" 
                        ChangeKey="AQAAAAA3vA==" />
         </m:FolderIds>
      </m:MarkAllItemsAsRead>
   </soap:Body>
</soap:Envelope>

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

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

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

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           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">
      <m:MarkAllItemsAsReadResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:MarkAllItemsAsReadResponseMessage ResponseClass="Success">
               <m:ResponseCode>NoError</m:ResponseCode>
            </m:MarkAllItemsAsReadResponseMessage>
         </m:ResponseMessages>
      </m:MarkAllItemsAsReadResponse>
   </s:Body>
</s:Envelope>

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

Пример запроса на операцию MarkAllItemsAsRead: пометите все элементы в папке как непрочитанные

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

<?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:MarkAllItemsAsRead>
         <m:ReadFlag>false</m:ReadFlag>
         <m:SuppressReadReceipts>true</m:SuppressReadReceipts>
         <m:FolderIds>
            <t:FolderId Id="AAMkADEzOTExYZRAAA=" 
                        ChangeKey="AQAAAAA3vA==" />
         </m:FolderIds>
      </m:MarkAllItemsAsRead>
   </soap:Body>
</soap:Envelope>

Успешный ответ на запрос пометить все элементы в качестве чтения является таким же, как и ответ на запрос, чтобы пометить все элементы как непрочитанные.

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

Ответ на ошибку операции MarkAllItemsAsRead

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

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           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">
      <m:MarkAllItemsAsReadResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:MarkAllItemsAsReadResponseMessage ResponseClass="Error">
               <m:MessageText>The specified object was not found in the store.</m:MessageText>
               <m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
               <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
            </m:MarkAllItemsAsReadResponseMessage>
         </m:ResponseMessages>
      </m:MarkAllItemsAsReadResponse>
   </s:Body>
</s:Envelope>

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

См. также