Операция ExpandDL

Операция ExpandDL предоставляет полное членство в списках рассылки.

Использование веб-метода ExpandDL

Операция ExpandDL использует веб-службу, расположенную в Exchange.asmx. Этот метод веб-службы принимает элемент Mailbox , который может содержать дочерний элемент EmailAddress (NonEmptyStringType) для расширения общедоступного списка рассылки или дочерний элемент ItemId для расширения частного списка рассылки.

Общедоступные списки рассылки можно развернуть с помощью одного из следующих способов:

1. Псевдоним списка рассылки

2. SMTP-адрес

3. X400

4. X500

5. Устаревший адрес Exchange

6. Имя списка рассылки

7. Отображаемое имя

Важно!

Отображаемые имена не являются уникальными. Несколько учетных записей могут использовать одно отображаемое имя.

Замечания

Рекурсивное расширение не поддерживается. В одном вызове можно развернуть только один список рассылки. Если критерию соответствует несколько списков рассылки, веб-служба сообщает об ошибке. Клиентское приложение может использовать неоднозначное разрешение имен (ANR) для поиска неоднозначных списков рассылки, а затем выбрать правильный адрес электронной почты требуемого списка рассылки в качестве параметра для операции ExpandDL. Дополнительные сведения см. в разделе Операция ResolveNames.

Общедоступные списки рассылки находятся в Active Directory. Это может быть любая группа рассылки с поддержкой почты или динамическая группа рассылки. Группа не должна быть скрыта из списка адресов, и у каждого участника должен быть непустый адрес электронной почты. Членами списка рассылки могут быть пользователи и контакты с поддержкой почты, общедоступные папки, списки рассылки с поддержкой почты и динамические группы.

Частные списки рассылки находятся в папке Контакты почтового ящика пользователя. Частные списки рассылки не имеют адресов электронной почты, поэтому идентификаторы элементов хранилища используются в запросе ExpandDL. Участниками закрытого списка рассылки могут быть любые пользователи с поддержкой почты, контакты или списки рассылки из Active Directory, а также контакты или частные списки рассылки из папки контактов пользователя.

Для контактов или частных списков рассылки идентификаторы элементов возвращаются в ответе. Его можно использовать для получения сведений об объекте или для расширения членства в частном списке рассылки.

Пример запроса expandDL Private Distribution List

Описание

В следующем примере запроса ExpandDL показано, как сформировать запрос на расширение частного списка рассылки.

Код

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2013_SP1" />
  </soap:Header>
  <soap:Body>
    <m:ExpandDL>
      <m:Mailbox>
       <t:EmailAddress>test</t:EmailAddress>
      </m:Mailbox>
    </m:ExpandDL>
  </soap:Body>
</soap:Envelope>

Comments

Чтобы развернуть частный список рассылки, элемент Mailbox будет содержать элемент ItemId , который идентифицирует частный список рассылки в почтовом ящике пользователя.

Пример запроса общедоступного списка рассылки ExpandDL

Описание

В следующем примере запроса ExpandDL показано, как сформировать запрос на развертывание общедоступного списка рассылки. В примере показано использование отображаемого имени для развертывания списка рассылки.

Код

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <ExpandDL xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
              xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
        <t:Mailbox>
          <t:EmailAddress>TheDistributionList</t:EmailAddress>
        </t:Mailbox>
    </ExpandDL>
  </soap:Body>
</soap:Envelope>

Comments

Ответ на этот запрос будет содержать элементы почтовых ящиков , которые идентифицируют каждый почтовый ящик в списке рассылки. Если список рассылки содержится в списке рассылки, во внедренном списке рассылки необходимо выполнить отдельное расширение списка рассылки. Если список рассылки не содержит членов или запрошенный список рассылки не существует, атрибут ResponseClass будет содержать значение, равное Success.

Элементы запроса

В запросе используются следующие элементы:

• ExpandDL

• Mailbox

• EmailAddress (NonEmptyStringType) используется для идентификации общедоступных списков рассылки. Элемент ItemId используется для идентификации частных списков рассылки.

Примечание.

Схема, описывающая эти элементы, находится в виртуальном каталоге EWS компьютера под управлением MicrosoftExchange Server 2007 с установленной ролью сервера клиентского доступа.

Пример успешного ответа ExpandDL

Описание

В следующем примере ответа ExpandDL показан ответ на запрос, описанный выше. Расширение списка рассылки описывает следующее:

• Число элементов списка рассылки, возвращаемых в ответе.

• Содержит ли ответ все члены списка рассылки.

• Имя почтового ящика.

• Адрес электронной почты почтового ящика.

• Тип маршрутизации для почтового ящика.

• Тип почтового ящика.

Примечание.

Имя списка рассылки не включается в ответ; Поэтому необходимо отслеживать имя из запроса.

Код

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" 
                         MajorBuildNumber="628" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <ExpandDLResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                      xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                      xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:ExpandDLResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:DLExpansion TotalItemsInView="3" IncludesLastItemInRange="true">
            <t:Mailbox>
              <t:Name>Dan Park</t:Name>
              <t:EmailAddress>dpark@exampledomain.com</t:EmailAddress>
              <t:RoutingType>SMTP</t:RoutingType>
              <t:MailboxType>Mailbox</t:MailboxType>
            </t:Mailbox>
            <t:Mailbox>
              <t:Name>Jeff Price</t:Name>
              <t:EmailAddress>jprice@exampledomain.com</t:EmailAddress>
              <t:RoutingType>SMTP</t:RoutingType>
              <t:MailboxType>Mailbox</t:MailboxType>
            </t:Mailbox>
            <t:Mailbox>
              <t:Name>Tanja Plate</t:Name>
              <t:EmailAddress>tplate@exampledomain.com</t:EmailAddress>
              <t:RoutingType>SMTP</t:RoutingType>
              <t:MailboxType>Mailbox</t:MailboxType>
            </t:Mailbox>
          </m:DLExpansion>
        </m:ExpandDLResponseMessage>
      </m:ResponseMessages>
    </ExpandDLResponse>
  </soap:Body>
</soap:Envelope>

Элементы успешного отклика

В ответе используются следующие элементы:

• ServerVersionInfo

• ExpandDLResponse

• ResponseMessages

• ExpandDLResponseMessage

• ResponseCode

• DLExpansion

• Mailbox

• Name (EmailAddressType)

• EmailAddress (NonEmptyStringType)

• RoutingType (EmailAddressType)

• MailboxType

Чтобы найти другие параметры для ответного сообщения операции ExpandDL, изучите иерархию схемы. Начните с элемента ExpandDLResponse .

Ответ об ошибке ExpandDL

Описание

В следующем примере показан ответ с ошибкой на запрос ExpandDL.

Код

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" 
                         MajorBuildNumber="628" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <ExpandDLResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                      xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                      xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:ExpandDLResponseMessage ResponseClass="Error">
          <m:MessageText>No results are found.</m:MessageText>
          <m:ResponseCode>ErrorNameResolutionNoResults</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:ExpandDLResponseMessage>
      </m:ResponseMessages>
    </ExpandDLResponse>
  </soap:Body>
</soap:Envelope>

Элементы ответа на ошибку

В ответе на ошибку используются следующие элементы:

• ServerVersionInfo

• ExpandDLResponse

• ResponseMessages

• ExpandDLResponseMessage

• MessageText

• ResponseCode

• DescriptiveLinkKey

Чтобы найти другие параметры для ответного сообщения операции ExpandDL, изучите иерархию схемы. Начните с элемента ExpandDLResponse .

См. также

• Операция ResolveNames
• Элементы XML веб-служб Exchange в Exchange