Opération AddImGroupAddImGroup operation

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

L’opération AddImGroup les services Web Exchange (EWS) ajoute un nouveau groupe de messagerie instantanée à une boîte aux lettres.The AddImGroup Exchange Web Services (EWS) operation adds a new instant messaging (IM) group to a mailbox.

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

Utilisation de l’opération AddImGroupUsing the AddImGroup operation

L’opération AddImGroup ne prend qu’un seul argument Nom complet.The AddImGroup operation only takes a single display name argument.

Cette opération renvoie le nom complet, le type de groupe et l’identificateur de la Banque d’Exchange du nouveau groupe.This operation returns the display name, group type, and Exchange store identifier of the new group.

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

Tableau 1. En-têtes SOAP d’opération AddImGroupTable 1. AddImGroup operation SOAP headers

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. Ceci s’applique à une demande.This is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifie la culture, telle que définie dans la norme RFC 3066, « balises 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. Ceci s’applique à une demande.This 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. Ceci s’applique à une demande.This 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. Ceci s’applique à une réponse.This is applicable to a response.

Exemple de requête d’opération AddImGroup : créer un groupe de messagerie instantanéeAddImGroup operation request example: Create a new IM group

L’exemple suivant de demande d’opération AddImGroup montre comment créer un groupe de messagerie instantanée nommé MyCustomerGroup.The following example of an AddImGroup operation request shows how to create an IM group named 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 :The request SOAP body contains the following elements:

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

L’exemple suivant montre une réponse réussie à une demande d’opération AddImGroup .The following example shows a successful response to an AddImGroup operation request.

<?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 réponse contient les éléments suivants :The response SOAP body contains the following elements:

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

L’exemple suivant montre une réponse d’erreur à une demande d’opération AddImGroup .The following example shows an error response to an AddImGroup operation request. 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.This is a response to a request that contains a character that cannot be used in a display name. Notez qu’il s’agit d’une erreur SOAP et non d’un message d’erreur basé sur un schéma.Note that this is a SOAP fault and not a schema-based error message. Le nom complet soumis dans la demande est ~ ! @ # $% ^ & , et l’erreur se produit sur le & caractère.The display name submitted in the request is ~!@#$%^&, and the error occurs on the & character. Le & caractère s’est produit sur la onzième ligne et le caractère 33e dans la charge utile de la demande.The & character occurred on the 11th line and 33rd character in the request payload. La réponse a été renvoyée avec un code HTTP 500.The response was returned with an HTTP 500 code.

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