Operación GetImItems
Busque información sobre la operación EWS GetImItems .
La operación GetImItems recupera información sobre los grupos de mensajería instantánea (MI) y los contactos de mensajería instantánea.
Esta operación se introdujo en Exchange Server 2013.
Uso de la operación GetImItems
La operación GetImItems acepta identificadores de elementos de contacto y grupo y devuelve un conjunto de información sobre los grupos y contactos. Los conjuntos de propiedades devueltos en la respuesta se identifican mediante propiedades extendidas, varios identificadores de contacto, identificadores de grupo y definiciones de propiedades extendidas como argumentos.
Encabezados SOAP de la operación GetImItems
La operación GetImItems puede usar los encabezados SOAP que se enumeran en la tabla siguiente.
| Nombre de encabezado | Elemento | Descripción |
|---|---|---|
| Suplantación |
ExchangeImpersonation |
Identifica al usuario al que suplanta la aplicación cliente. Este encabezado 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. Este encabezado es aplicable a una solicitud. |
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta. |
Ejemplo de solicitud de operación GetImItems: obtener información detallada sobre los contactos y grupos de mensajería instantánea
En el ejemplo siguiente de una solicitud de operación GetImItems se muestra cómo solicitar información detallada sobre los contactos y grupos de mensajería instantánea. Una operación GetImItems puede solicitar uno o varios detalles de contacto o grupo. También puede usar propiedades extendidas para obtener propiedades personalizadas en grupos y contactos. Si una propiedad extendida solicitada no existe en un elemento, la respuesta omitirá la propiedad solicitada y devolverá la respuesta para el conjunto de propiedades predeterminado. En este ejemplo se muestra cómo obtener el nombre para mostrar mediante propiedades extendidas.
Nota:
Todos los identificadores de elemento y las claves de cambio de este artículo se han acortado para conservar la legibilidad. Tenga en cuenta que el servicio omite las claves de cambio para esta operación.
<?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:GetImItems>
<m:ContactIds>
<t:ItemId Id="AAMkADEzOTExYACABmEhpSAAA=" ChangeKey="EQAAABBmNDjF"/>
</m:ContactIds>
<m:GroupIds>
<t:ItemId Id="AAMkADEzOTExYjJkBY7+0EAAA=" ChangeKey="EgAAAA=="/>
</m:GroupIds>
<m:ExtendedProperties>
<t:ExtendedProperty PropertyTag="0x3001" PropertyType="String"/>
</m:ExtendedProperties>
</m:GetImItems>
</soap:Body>
</soap:Envelope>
El cuerpo SOAP de la solicitud contiene los siguientes elementos:
Respuesta correcta de la operación GetImItems
En el ejemplo siguiente se muestra una respuesta correcta a una solicitud GetImItems para obtener un contacto y un grupo de mensajería instantánea. El nombre para mostrar se solicita en una propiedad extendida. Los contactos de MI se devuelven en forma de persona.
<?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="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">
<GetImItemsResponse ResponseClass="Success"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<ImItemList>
<Groups xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<ImGroup>
<DisplayName>Exchange SDK Team</DisplayName>
<GroupType>IPM.DistList.MOC.UserGroup</GroupType>
<ExchangeStoreId Id="AAMkADEzQrAABY7+0EAAA=" ChangeKey="EgAAAA=="/>
<MemberCorrelationKey>
<ItemId Id="AAMkADEzOTExYjeGgGqm4QrAABmEhpSAAA=" ChangeKey="EQAAAA=="/>
</MemberCorrelationKey>
<ExtendedProperties>
<ExtendedProperty>
<ExtendedFieldURI PropertyTag="0x3001" PropertyType="String"/>
<Value>Exchange SDK Team</Value>
</ExtendedProperty>
</ExtendedProperties>
</ImGroup>
</Groups>
<Personas xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<Persona>
<PersonaId Id="AAQkADEzOTBZImBzN5J/uHXc="/>
<PersonaType>Person</PersonaType>
<CreationTime>2012-11-07T00:10:35Z</CreationTime>
<DisplayName>Tony Smith</DisplayName>
<DisplayNameFirstLast>Tony Smith</DisplayNameFirstLast>
<DisplayNameLastFirst>Tony Smith</DisplayNameLastFirst>
<FileAs/>
<FileAsId>None</FileAsId>
<ImAddress>tsmith@contoso.com</ImAddress>
<RelevanceScore>2147483647</RelevanceScore>
<Attributions>
<Attribution>
<Id>0</Id>
<SourceId Id="AAMkADEzhQaoeGgGqm4QrAABmEhpSAAA=" ChangeKey="EQArAABmNDjF"/>
<DisplayName>Lync Contacts</DisplayName>
<IsWritable>false</IsWritable>
<IsQuickContact>true</IsQuickContact>
<IsHidden>false</IsHidden>
</Attribution>
</Attributions>
<DisplayNames>
<StringAttributedValue>
<Value>Tony Smith</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</DisplayNames>
<FileAsIds>
<StringAttributedValue>
<Value>None</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</FileAsIds>
<ImAddresses>
<StringAttributedValue>
<Value>tsmith@contoso.com</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</ImAddresses>
<ExtendedProperties>
<ExtendedPropertyAttributedValue>
<Value>
<ExtendedFieldURI PropertyTag="0x3001" PropertyType="String"/>
<Value>Tony Smith</Value>
</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</ExtendedPropertyAttributedValue>
</ExtendedProperties>
</Persona>
</Personas>
</ImItemList>
</GetImItemsResponse>
</s:Body>
</s:Envelope>
El cuerpo soap de respuesta contiene los siguientes elementos:
FileAsId FileAsId
Respuesta de error de la operación GetImItems
La operación GetImItems no valida los identificadores y no devolverá la respuesta de error ErrorInvalidImContactId o ErrorInvalidImGroupId esperada si se proporciona un identificador de grupo o contacto no válido al servicio.
Vea también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de