Операция ExpandDLExpandDL operation

Операция ExpandDL предоставляет полное членство в списках рассылки.The ExpandDL operation exposes the full membership of distribution lists.

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

Операция ExpandDL использует веб-службу, размещенную в Exchange. asmx.The ExpandDL operation uses the Web service that is located in Exchange.asmx. Этот метод веб-службы принимает элемент почтового ящика , который может содержать дочерний элемент EmailAddress (нонемптистрингтипе) для расширения общедоступного списка рассылки или дочернего элемента ItemId для расширения частного списка рассылки.This Web service method accepts a Mailbox element that can contain either an EmailAddress (NonEmptyStringType) child element for an expansion of a public distribution list or an ItemId child element for the expansion of a private distribution list.

Общедоступные списки рассылки можно развернуть с помощью одного из следующих компонентов:Public distribution lists can be expanded by using one of the following:

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

  2. SMTP-адресThe Simple Mail Transfer Protocol (SMTP) address

  3. X400X400

  4. ХX500

  5. Устаревший адрес ExchangeExchange Legacy address

  6. Имя списка рассылкиThe distribution list name

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

Важно!

Отображаемые имена не являются уникальными.Display names are not unique. Несколько учетных записей могут иметь одно и то же отображаемое имя.Multiple accounts can share the same display name.

ПримечанияRemarks

Рекурсивное расширение не поддерживается.Recursive expansion is not supported. В одном вызове можно развернуть только один список рассылки.Only one distribution list can be expanded in a single call. Если критерию отвечает несколько списков рассылки, веб-служба сообщает об ошибке.If more than one distribution list match the criteria, the Web service reports an error. Клиентское приложение может использовать разрешение неоднозначных имен, чтобы найти неоднозначные списки рассылки, а затем выбрать правильный адрес электронной почты требуемого списка рассылки в качестве параметра для операции ExpandDL.A client application can use ambiguous name resolution (ANR) to find ambiguous distribution lists and then chose the correct e-mail address of the required distribution list as a parameter for the ExpandDL operation. Дополнительные сведения см. в разделе Operation ResolveNames Operation.For more information, see ResolveNames operation.

Общедоступные списки рассылки находятся в Active Directory.Public distribution lists are located in Active Directory. Можно использовать любую группу рассылки с поддержкой почты или динамическую группу рассылки.They can be any mail-enabled or dynamic distribution group. Группу не следует скрывать из списка адресов, а у каждого участника должен быть непустой адрес электронной почты.The group should not be hidden from the address list and each member should have a non-empty e-mail address. Членами этого списка рассылки могут быть пользователи и контакты, общедоступные папки и списки рассылки с поддержкой почты и динамические группы.Members of the distribution list can be mail-enabled users and contacts, public folders, and mail-enabled distribution lists and dynamic groups.

Частные списки рассылки находятся в папке "Контакты" в почтовом ящике пользователя.Private distribution lists are located in the Contacts folder of a user's mailbox. Частные списки рассылки не имеют адресов электронной почты, поэтому их идентификаторы элементов хранилища используются в запросе ExpandDL.Private distribution lists do not have e-mail addresses so their store item identifiers are used in an ExpandDL request. Членами частного списка рассылки может быть любой пользователь с включенной поддержкой почты, контакты или списки рассылки из Active Directory, а также списки контактов или частных рассылки из папки "Контакты" пользователя.Members of a private distribution list can be any mail-enabled user, contacts or distribution lists from Active Directory, or contacts or private distribution lists from a user's Contacts folder.

Для контактов или частных списков рассылки в ответе возвращаются идентификаторы элементов.For contacts or private distribution lists, the item identifiers are returned in the response. Этот параметр можно использовать для получения сведений о объекте или для расширения членства в частном списке рассылки.This can be used to get information about the object or to expand membership in a private distribution list.

Пример запроса частного списка рассылки ExpandDLExpandDL Private Distribution List request example

DescriptionDescription

В приведенном ниже примере запроса ExpandDL показано, как сформировать запрос на развертывание частного списка рассылки.The following example of an ExpandDL request shows how to form a request to expand a private distribution list.

КодCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" xmlns:t="https://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 , определяющий частный список рассылки в почтовом ящике пользователя.To expand a private distribution list, the Mailbox element will contain the ItemId element that identifies a private distribution list in the user's mailbox.

Пример общего списка рассылки ExpandDLExpandDL Public Distribution List request example

DescriptionDescription

В приведенном ниже примере запроса ExpandDL показано, как создать запрос для развертывания общедоступного списка рассылки.The following example of an ExpandDL request shows how to form a request to expand a public distribution list. В этом примере показано использование отображаемого имени для развертывания списка рассылки.The example shows the use of a display name to expand a distribution list.

КодCode

<?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">
  <soap:Body>
    <ExpandDL xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
              xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
        <t:Mailbox>
          <t:EmailAddress>TheDistributionList</t:EmailAddress>
        </t:Mailbox>
    </ExpandDL>
  </soap:Body>
</soap:Envelope>

КомментарииComments

Ответ на этот запрос будет содержать элементы почтовых ящиков , которые определяют каждый почтовый ящик в списке рассылки.The response to this request will contain Mailbox elements that identify each mailbox in the distribution list. Если список рассылки находится в списке рассылки, для внедренного списка рассылки должно выполняться отдельное расширение списка рассылки.If a distribution list is contained within a distribution list, a separate distribution list expansion must be performed on the embedded distribution list. Если в списке рассылки нет участников или запрошенный список рассылки не существует, атрибут респонсекласс будет содержать значение Success.If the distribution list has no members or the requested distribution list does not exist, the ResponseClass attribute will contain a value equal to Success.

Элементы RequestRequest elements

В запросе используются следующие элементы:The following elements are used in the request:

Примечание

Схема, описывающая эти элементы, находится в виртуальном каталоге EWS компьютера, на котором работает сервер Майкрософт Exchange Server 2007, на котором установлена роль сервера клиентского доступа.The schema that describes these elements is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.

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

DescriptionDescription

В приведенном ниже примере ответа ExpandDL показан ответ на запрос, описанный выше.The following example of an ExpandDL response shows a response to the request described above. Раскрытие списка рассылки содержит следующие сведения:The distribution list expansion describes the following:

  • Количество членов списка рассылки, возвращаемых в ответе.The number of members of the distribution list that are returned in the response.

  • Содержит ли ответ все члены списка рассылки.Whether the response contains all the members of the distribution list.

  • Имя почтового ящика.The name of the mailbox.

  • Адрес электронной почты почтового ящика.The e-mail address of the mailbox.

  • Тип маршрутизации для почтового ящика.The routing type for the mailbox.

  • Тип почтового ящика.The type of mailbox.

Примечание

Имя списка рассылки не включается в ответ; Поэтому необходимо следить за именем в запросе.The distribution list name is not included in the response; therefore, you must keep track of the name from the request.

КодCode

<?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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <ExpandDLResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                      xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                      xmlns="https://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>

Элементы успешного ответаSuccessful response elements

В отклике используются следующие элементы:The following elements are used in the response:

Чтобы найти другие параметры для ответного сообщения операции ExpandDL, изучите иерархию схемы.To find other options for the response message of the ExpandDL operation, explore the schema hierarchy. Начните с элемента експанддлреспонсе .Start at the ExpandDLResponse element.

Ответ об ошибке ExpandDLExpandDL error response

DescriptionDescription

В следующем примере показан ответ об ошибке для запроса ExpandDL.The following example shows an error response to an ExpandDL request.

КодCode

<?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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <ExpandDLResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                      xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                      xmlns="https://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>

Элементы ошибочного ответаError response elements

В ответе на сообщение об ошибке используются следующие элементы:The following elements are used in the error response:

Чтобы найти другие параметры для ответного сообщения операции ExpandDL, изучите иерархию схемы.To find other options for the response message of the ExpandDL operation, explore the schema hierarchy. Начните с элемента експанддлреспонсе .Start at the ExpandDLResponse element.

См. такжеSee also