Share via


Operación AddImGroup

Busque información sobre la operación EWS AddImGroup .

La operación AddImGroup Exchange Web Services (EWS) agrega un nuevo grupo de mensajería instantánea (MI) a un buzón.

Esta operación se introdujo en Exchange Server 2013.

Uso de la operación AddImGroup

La operación AddImGroup solo toma un único argumento de nombre para mostrar.

Esta operación devuelve el nombre para mostrar, el tipo de grupo y el identificador del almacén de Exchange del nuevo grupo.

La operación AddImGroup puede usar los encabezados SOAP que aparecen en la tabla siguiente.

Tabla 1. Encabezados SOAP de la operación AddImGroup

Nombre de encabezado Elemento Descripción
Suplantación
ExchangeImpersonation
Identifica al usuario al que suplanta la aplicación cliente. Esto es aplicable a una solicitud.
MailboxCulture
MailboxCulture
Identifica la referencia cultural, tal como se define en RFC 3066, "Etiquetas para la identificación de idiomas", que se usará para acceder al buzón. Esto es aplicable a una solicitud.
RequestVersion
RequestServerVersion
Identifica la versión del esquema de la solicitud de operación. Esto es aplicable a una solicitud.
ServerVersion
ServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud. Esto es aplicable a una respuesta.

Ejemplo de solicitud de operación AddImGroup: Creación de un nuevo grupo de mensajería instantánea

En el ejemplo siguiente de una solicitud de operación AddImGroup se muestra cómo crear un grupo de mensajería instantánea denominado 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>

El cuerpo SOAP de la solicitud contiene los siguientes elementos:

Respuesta correcta de la operación AddImGroup

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación 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>

El cuerpo soap de respuesta contiene los siguientes elementos:

Respuesta de error de la operación AddImGroup

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación AddImGroup . Se trata de una respuesta a una solicitud que contiene un carácter que no se puede usar en un nombre para mostrar. Tenga en cuenta que se trata de un error SOAP y no de un mensaje de error basado en esquema. El nombre para mostrar enviado en la solicitud es ~!@#$%^& y el error se produce en el carácter &. El carácter & se produjo en la 11ª línea y el carácter 33 en la carga de la solicitud. La respuesta se devolvió con un código 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>

Consulte también