Операция AddImGroup

  • Статья

Найдите сведения об операции AddImGroup EWS.

Операция AddImGroup Exchange Web Services (EWS) добавляет новую группу обмена мгновенными сообщениями в почтовый ящик.

Эта операция появилась в Exchange Server 2013.

Использование операции AddImGroup

Операция AddImGroup принимает только один аргумент отображаемого имени.

Эта операция возвращает отображаемое имя, тип группы и идентификатор хранилища Exchange для новой группы.

Операция AddImGroup может использовать заголовки SOAP, перечисленные в следующей таблице.

Таблица 1. Заголовки SOAP операции AddImGroup

Имя заголовка Элемент Описание
Олицетворения
ExchangeImpersonation
Определяет пользователя, которого олицетворяет клиентское приложение. Это применимо к запросу.
MailboxCulture
MailboxCulture
Определяет язык и региональные параметры, определенные в RFC 3066 "Теги для идентификации языков", которые будут использоваться для доступа к почтовому ящику. Это применимо к запросу.
RequestVersion
RequestServerVersion
Определяет версию схемы для запроса операции. Это применимо к запросу.
ServerVersion
ServerVersionInfo
Определяет версию сервера, который ответил на запрос. Это применимо к ответу.

Пример запроса на операцию AddImGroup: создание новой группы обмена мгновенными сообщениями

В следующем примере запроса на операцию AddImGroup показано, как создать группу мгновенных сообщений с именем 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>

Текст SOAP запроса содержит следующие элементы:

Успешный ответ операции AddImGroup

В следующем примере показан успешный ответ на запрос операции 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>

Текст SOAP ответа содержит следующие элементы:

Ответ об ошибке операции AddImGroup

В следующем примере показан ответ на ошибку на запрос операции AddImGroup . Это ответ на запрос, содержащий символ, который не может использоваться в отображаемом имени. Обратите внимание, что это ошибка SOAP, а не сообщение об ошибке на основе схемы. Отображаемое имя, отправленное в запросе, — ~!@#$%^&, и ошибка возникает в символе &. Символ & произошел в 11-й строке и 33-м символе в полезных данных запроса. Ответ был возвращен с кодом 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>

См. также