Opération ArchiveItemArchiveItem operation

Trouvez des informations sur l’opération EWS ArchiveItem .Find information about the ArchiveItem EWS operation.

L’opération ArchiveItem déplace un élément vers la boîte aux lettres d’archivage de l’utilisateur de boîte aux lettres.The ArchiveItem operation moves an item into the mailbox user's archive mailbox.

Cette opération est une nouveauté d’Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Utilisation de l’opération ArchiveItemUsing the ArchiveItem operation

L’opération ArchiveItem prend deux arguments dans la demande qui identifie les éléments à déplacer vers la boîte aux lettres d’archivage et le dossier de destination de ces éléments.The ArchiveItem operation takes two arguments in the request that identify the items to move to the archive mailbox and the destination folder for those items. Une boîte aux lettres d’archivage doit être activée pour que cette opération fonctionne.An archive mailbox must be enabled in order for this operation to work. Pour plus d’informations sur l’activation d’une boîte aux lettres d’archivage, consultez la rubrique Manage in-place Archive.For information about how to enable an archive mailbox, see Manage In-Place Archives.

En-têtes SOAP d’opération ArchiveItemArchiveItem operation SOAP headers

L’opération ArchiveItem peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.The ArchiveItem operation can use the SOAP headers that are listed in the following table.

Nom de l'en-têteHeader name ÉlémentElement DescriptionDescription
Emprunt d’identitéImpersonation
ExchangeImpersonationExchangeImpersonation
Identifie l’utilisateur qui emprunte l’identité de l’application cliente.Identifies the user whom the client application is impersonating. Cet en-tête s’applique à une demande.This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifie la culture, telle que définie dans la norme RFC 3066, pour l’identification des langues, à utiliser pour accéder à la boîte aux lettres.Identifies the culture, as defined in RFC 3066, Tags for the Identification of Languages, to be used to access the mailbox. Cet en-tête s’applique à une demande.This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifie la version de schéma de la demande d’opération.Identifies the schema version for the operation request. Cet en-tête s’applique à une demande.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifie la version du serveur qui a répondu à la demande.Identifies the version of the server that responded to the request. Cet en-tête s’applique à une réponse.This header is applicable to a response.

Exemple de requête d’opération ArchiveItem : déplacer un élément vers le dossier boîte de réception d’archivageArchiveItem operation request example: Move an item to the archive inbox folder

L’exemple suivant de demande d’opération ArchiveItem indique comment déplacer un élément vers le dossier boîte de réception d’archive.The following example of an ArchiveItem operation request shows how to move an item to the archive Inbox folder.

Notes

Tous les identificateurs d’élément et clés de modification de cet article ont été raccourcies afin de préserver la lisibilité.All item identifiers and change keys in this article have been shortened to preserve readability.

<?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>

Le corps SOAP de la demande contient les éléments suivants :The request SOAP body contains the following elements:

Réponse de l’opération ArchiveItem réussieSuccessful ArchiveItem operation response

L’exemple suivant montre une réponse réussie à une demande d’opération ArchiveItem pour déplacer un élément vers une boîte aux lettres d’archivage.The following example shows a successful response to an ArchiveItem operation request to move an item to an archive mailbox.

<?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>

Le corps SOAP de réponse contient les éléments suivants :The response SOAP body contains the following elements:

Réponse d’erreur d’opération ArchiveItemArchiveItem operation error response

L’exemple suivant montre une réponse d’erreur à une demande d’opération ArchiveItem .The following example shows an error response to an ArchiveItem operation request. Il s’agit d’une réponse à une demande valide d’archivage d’un élément lorsqu’une boîte aux lettres d’archivage n’est pas activée pour un utilisateur.This is a response to a valid request to archive an item when an archive mailbox is not enabled for a user.

<?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>

Le corps SOAP de la réponse d’erreur contient les éléments suivants :The error response SOAP body contains the following elements:

Pour les autres codes d’erreur qui sont génériques à EWS et spécifiques à cette opération, voir ResponseCode.For additional error codes that are generic to EWS and specific to this operation, see ResponseCode.

Voir aussiSee also