Операция ExpandDL
Операция ExpandDL предоставляет полное членство в списках рассылки.
Использование веб-метода ExpandDL
Операция ExpandDL использует веб-службу, расположенную в Exchange.asmx. Этот метод веб-службы принимает элемент Mailbox , который может содержать дочерний элемент EmailAddress (NonEmptyStringType) для расширения общедоступного списка рассылки или дочерний элемент ItemId для расширения частного списка рассылки.
Общедоступные списки рассылки можно развернуть с помощью одного из следующих способов:
Псевдоним списка рассылки
SMTP-адрес
X400
X500
Устаревший адрес Exchange
Имя списка рассылки
Отображаемое имя
Важно!
Отображаемые имена не являются уникальными. Несколько учетных записей могут использовать одно отображаемое имя.
Замечания
Рекурсивное расширение не поддерживается. В одном вызове можно развернуть только один список рассылки. Если критерию соответствует несколько списков рассылки, веб-служба сообщает об ошибке. Клиентское приложение может использовать неоднозначное разрешение имен (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.
Элементы запроса
В запросе используются следующие элементы:
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>
Элементы успешного отклика
В ответе используются следующие элементы:
Чтобы найти другие параметры для ответного сообщения операции 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>
Элементы ответа на ошибку
В ответе на ошибку используются следующие элементы:
Чтобы найти другие параметры для ответного сообщения операции ExpandDL, изучите иерархию схемы. Начните с элемента ExpandDLResponse .
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по