Partager via


Opération GetImItems

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

L’opération GetImItems récupère des informations sur les groupes de messagerie instantanée et les contacts de messagerie instantanée.

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

Utilisation de l’opération GetImItems

L’opération GetImItems accepte les identificateurs d’élément de groupe et de contact et retourne un ensemble d’informations sur les groupes et les contacts. Les jeux de propriétés retournés dans la réponse sont identifiés par des propriétés étendues, plusieurs identificateurs de contact, des identificateurs de groupe et des définitions de propriétés étendues en tant qu’arguments.

En-têtes SOAP de l’opération GetImItems

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

Nom de l'en-tête Élément Description
Imitation
ExchangeImpersonation
Identifie l’utilisateur que l’application cliente emprunte l’identité. Cet en-tête s’applique à une requête.
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. Cet en-tête s’applique à une requête.
RequestVersion
RequestServerVersion
Identifie la version du schéma pour la demande d’opération. Cet en-tête s’applique à une requête.
ServerVersion
ServerVersionInfo
Identifie la version du serveur qui a répondu à la requête. Cet en-tête s’applique à une réponse.

Exemple de demande d’opération GetImItems : obtenir des informations détaillées sur les contacts et les groupes de messagerie instantanée

L’exemple suivant de demande d’opération GetImItems montre comment demander des informations détaillées sur les contacts et les groupes de messagerie instantanée. Une opération GetImItems peut demander un ou plusieurs détails de contact ou de groupe. Vous pouvez également utiliser des propriétés étendues pour obtenir des propriétés personnalisées sur des groupes et des contacts. Si une propriété étendue demandée n’existe pas sur un élément, la réponse ignore la propriété demandée et retourne la réponse pour le jeu de propriétés par défaut. Cet exemple montre comment obtenir le nom d’affichage à l’aide de propriétés étendues.

Remarque

Tous les identificateurs d’élément et les clés de modification de cet article ont été raccourcis pour préserver la lisibilité. Notez que les clés de modification sont ignorées par le service pour cette opération.

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

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

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

L’exemple suivant montre une réponse réussie à une demande GetImItems pour obtenir un contact et un groupe de messagerie instantanée. Le nom d’affichage est demandé dans une propriété étendue. Les contacts de messagerie instantanée sont retournés sous la forme d’un personnage.

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

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

Réponse d’erreur d’opération GetImItems

L’opération GetImItems ne valide pas les identificateurs et ne retourne pas la réponse d’erreur ErrorInvalidImContactId ou ErrorInvalidImGroupId attendue si un identificateur de contact ou de groupe non valide est fourni au service.

Voir aussi