Операция ArchiveItem

Статья
03/29/2023

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

Операция ArchiveItem перемещает элемент в архивный почтовый ящик пользователя.

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

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

Операция ArchiveItem принимает два аргумента в запросе, которые определяют элементы для перемещения в архивный почтовый ящик и папку назначения для этих элементов. Чтобы эта операция работала, необходимо включить архивный почтовый ящик. Сведения о том, как включить архивный почтовый ящик, см. в разделе Управление архивами In-Place.

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

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

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

Пример запроса операции ArchiveItem: перемещение элемента в папку "Входящие" архива

В следующем примере запроса операции ArchiveItem показано, как переместить элемент в архивную папку "Входящие".

Примечание.

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

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013"/>
   </soap:Header>
   <soap:Body>
      <m:ArchiveItem>
         <m:ArchiveSourceFolderId>
            <t:DistinguishedFolderId Id="inbox"/>
         </m:ArchiveSourceFolderId>
         <m:ItemIds>
            <t:ItemId Id="AQMkG5BBwrQAAAxoAAAA=" ChangeKey="CQAAAHCtAAAAAAB7"/>
         </m:ItemIds>
      </m:ArchiveItem>
   </soap:Body>
</soap:Envelope>

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

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

В следующем примере показан успешный ответ на запрос операции ArchiveItem для перемещения элемента в архивный почтовый ящик.

<?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="526" 
                           MinorBuildNumber="0" 
                           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:ArchiveItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                             xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:ArchiveItemResponseMessage ResponseClass="Success">
               <m:ResponseCode>NoError</m:ResponseCode>
               <m:Items/>
            </m:ArchiveItemResponseMessage>
         </m:ResponseMessages>
      </m:ArchiveItemResponse>
   </s:Body>
</s:Envelope>

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

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

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

<?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="556" 
                           MinorBuildNumber="8" 
                           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:ArchiveItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                             xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:ArchiveItemResponseMessage ResponseClass="Error">
               <m:MessageText>Archive mailbox is not enabled for this user.</m:MessageText>
               <m:ResponseCode>ErrorInvalidOperation</m:ResponseCode>
               <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
               <m:Items/>
            </m:ArchiveItemResponseMessage>
         </m:ResponseMessages>
      </m:ArchiveItemResponse>
   </s:Body>
</s:Envelope>

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

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