Partager via

Opération ArchiveItem

  • Article

Recherchez des informations sur l’opération ArchiveItem EWS.

L’opération ArchiveItem déplace un élément dans la boîte aux lettres d’archivage de l’utilisateur de la boîte aux lettres.

Cette opération est une nouveauté d’Exchange Server 2013.

Utilisation de l’opération ArchiveItem

L’opération ArchiveItem prend deux arguments dans la demande qui identifient les éléments à déplacer vers la boîte aux lettres d’archivage et le dossier de destination de ces éléments. Une boîte aux lettres d’archivage doit être activée pour que cette opération fonctionne. Pour plus d’informations sur l’activation d’une boîte aux lettres d’archivage, consultez Gérer les archives In-Place.

En-têtes SOAP de l’opération ArchiveItem

L’opération ArchiveItem peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.

Nom de l'en-tête Élément Description
Imitation
ExchangeImpersonation
Identifie l’utilisateur que l’application cliente emprunte l’identité. Cet en-tête s’applique à une requête.
MailboxCulture
MailboxCulture
Identifie la culture, telle que définie dans RFC 3066, étiquettes pour l’identification des langues, à utiliser pour accéder à la boîte aux lettres. Cet en-tête s’applique à une requête.
RequestVersion
RequestServerVersion
Identifie la version du schéma pour la demande d’opération. Cet en-tête s’applique à une requête.
ServerVersion
ServerVersionInfo
Identifie la version du serveur qui a répondu à la requête. Cet en-tête s’applique à une réponse.

Exemple de demande d’opération ArchiveItem : Déplacer un élément vers le dossier de boîte de réception d’archivage

L’exemple suivant de demande d’opération ArchiveItem montre comment déplacer un élément vers le dossier boîte de réception d’archive.

Remarque

Tous les identificateurs d’élément et les clés de modification de cet article ont été raccourcis pour préserver la lisibilité.

<?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="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="http://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 :

Réponse de l’opération ArchiveItem réussie

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.

<?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="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">
      <m:ArchiveItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                             xmlns:t="http://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 la réponse contient les éléments suivants :

Réponse d’erreur de l’opération ArchiveItem

L’exemple suivant montre une réponse d’erreur à une demande d’opération ArchiveItem . 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.

<?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="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">
      <m:ArchiveItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                             xmlns:t="http://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 :

Pour obtenir des codes d’erreur supplémentaires génériques pour EWS et spécifiques à cette opération, consultez ResponseCode.

Voir aussi