Operación AddImGroupAddImGroup operation

Buscar información sobre la operación de EWS de AddImGroup .Find information about the AddImGroup EWS operation.

La operación de servicios web Exchange de AddImGroup (EWS) agrega un nuevo grupo de mensajería instantánea (mi) a un buzón.The AddImGroup Exchange Web Services (EWS) operation adds a new instant messaging (IM) group to a mailbox.

Esta operación se introdujo en Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Uso de la operación AddImGroupUsing the AddImGroup operation

La operación AddImGroup sólo toma un único argumento nombre para mostrar.The AddImGroup operation only takes a single display name argument.

Esta operación devuelve el nombre para mostrar, el tipo de grupo y el identificador del almacén de Exchange del nuevo grupo.This operation returns the display name, group type, and Exchange store identifier of the new group.

La operación AddImGroup puede usar los encabezados SOAP que se enumeran en la tabla siguiente.The AddImGroup operation can use the SOAP headers that are listed in the following table.

Tabla 1. Encabezados SOAP de operación AddImGroupTable 1. AddImGroup operation SOAP headers

Nombre de encabezadoHeader name ElementoElement DescripciónDescription
SuplantaciónImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica al usuario que está suplantando la aplicación cliente.Identifies the user whom the client application is impersonating. Esto es aplicable a una solicitud.This is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifica la referencia cultural, tal y como se define en RFC 3066, "etiquetas para la identificación de idiomas", que se va a usar para obtener acceso al buzón.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Esto es aplicable a una solicitud.This is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica la versión del esquema para la solicitud de operación.Identifies the schema version for the operation request. Esto es aplicable a una solicitud.This is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud.Identifies the version of the server that responded to the request. Esto es aplicable a una respuesta.This is applicable to a response.

Ejemplo de solicitud de operación AddImGroup: crear un nuevo grupo de mensajería instantáneaAddImGroup operation request example: Create a new IM group

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

El cuerpo SOAP de la solicitud contiene los siguientes elementos:The request SOAP body contains the following elements:

Respuesta de operación AddImGroup correctaSuccessful AddImGroup operation response

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

El cuerpo SOAP de respuesta contiene los siguientes elementos:The response SOAP body contains the following elements:

Respuesta de error de operación de AddImGroupAddImGroup operation error response

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación AddImGroup .The following example shows an error response to an AddImGroup operation request. Se trata de una respuesta a una solicitud que contiene un carácter que no se puede usar en un nombre para mostrar.This is a response to a request that contains a character that cannot be used in a display name. Tenga en cuenta que se trata de un error de SOAP y no de un mensaje de error basado en esquema.Note that this is a SOAP fault and not a schema-based error message. El nombre para mostrar enviado en la solicitud es ~! @ # $% ^ & y el error se produce en el & personaje.The display name submitted in the request is ~!@#$%^&, and the error occurs on the & character. El & carácter se produjo en la undécimo línea y el carácter 33 en la carga de la solicitud.The & character occurred on the 11th line and 33rd character in the request payload. Se devolvió la respuesta con un código 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>

Vea tambiénSee also