Opération AddImGroup

  • Article

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

L’opération AddImGroup Exchange Web Services (EWS) ajoute un nouveau groupe de messagerie instantanée à une boîte aux lettres.

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

Utilisation de l’opération AddImGroup

L’opération AddImGroup ne prend qu’un seul argument de nom d’affichage.

Cette opération retourne le nom d’affichage, le type de groupe et l’identificateur de magasin Exchange du nouveau groupe.

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

Tableau 1. En-têtes SOAP de l’opération AddImGroup

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

Exemple de demande d’opération AddImGroup : Créer un groupe de messagerie instantanée

L’exemple suivant de demande d’opération AddImGroup montre comment créer un groupe de messagerie instantanée nommé MyCustomerGroup.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope 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" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
   </soap:Header>
   <soap:Body >
      <m:AddImGroup>
         <m:DisplayName>MyCustomGroup</m:DisplayName>
      </m:AddImGroup>
   </soap:Body>
</soap:Envelope>

Le corps SOAP de la demande contient les éléments suivants :

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

L’exemple suivant montre une réponse réussie à une demande d’opération AddImGroup .

<?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="349"
                           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">
      <AddImGroupResponse ResponseClass="Success"
                          xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
         <ImGroup>
            <DisplayName xmlns="https://schemas.microsoft.com/exchange/services/2006/types">MyCustomGroup</DisplayName>
            <GroupType xmlns="https://schemas.microsoft.com/exchange/services/2006/types">IPM.DistList.MOC.UserGroup</GroupType>
            <ExchangeStoreId Id="AAMkAGQ1MjJjMTBkLTc4Y2UtNDA5Ny04ZjU5LWI3MAAA="
                             ChangeKey="EgAAAA=="
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/types"/>
         </ImGroup>
      </AddImGroupResponse>
   </s:Body>
</s:Envelope>

Le corps SOAP de la réponse contient les éléments suivants :

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

L’exemple suivant montre une réponse d’erreur à une demande d’opération AddImGroup . Il s’agit d’une réponse à une requête qui contient un caractère qui ne peut pas être utilisé dans un nom d’affichage. Notez qu’il s’agit d’une erreur SOAP et non d’un message d’erreur basé sur un schéma. Le nom d’affichage envoyé dans la demande est ~ !@#$%^&, et l’erreur se produit sur le caractère &. Le caractère & s’est produit sur la 11e ligne et le 33e caractère dans la charge utile de la requête. La réponse a été retournée avec un code HTTP 500.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <s:Fault>
         <faultcode xmlns:a="https://schemas.microsoft.com/exchange/services/2006/types">a:ErrorSchemaValidation</faultcode>
         <faultstring xml:lang="en-US">The request failed schema validation: An error occurred while parsing EntityName. Line 11, position 33.</faultstring>
         <detail>
            <e:ResponseCode xmlns:e="https://schemas.microsoft.com/exchange/services/2006/errors">ErrorSchemaValidation</e:ResponseCode>
            <e:Message xmlns:e="https://schemas.microsoft.com/exchange/services/2006/errors">The request failed schema validation.</e:Message>
            <t:MessageXml xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
               <t:LineNumber>11</t:LineNumber>
               <t:LinePosition>33</t:LinePosition>
               <t:Violation>An error occurred while parsing EntityName. Line 11, position 33.</t:Violation>
            </t:MessageXml>
         </detail>
      </s:Fault>
   </s:Body>
</s:Envelope>

Voir aussi