Operación ExpandDL
La operación ExpandDL expone la pertenencia completa de las listas de distribución.
Uso del método web ExpandDL
La operación ExpandDL usa el servicio web que se encuentra en Exchange.asmx. Este método de servicio web acepta un elemento Mailbox que puede contener un elemento secundario EmailAddress (NonEmptyStringType) para una expansión de una lista de distribución pública o un elemento secundario ItemId para la expansión de una lista de distribución privada.
Las listas de distribución pública se pueden expandir mediante una de las siguientes opciones:
Alias de lista de distribución
Dirección del protocolo simple de transferencia de correo (SMTP)
X400
X500
Dirección heredada de Exchange
Nombre de la lista de distribución
Nombre para mostrar
Importante
Los nombres para mostrar no son únicos. Varias cuentas pueden compartir el mismo nombre para mostrar.
Comentarios
No se admite la expansión recursiva. Solo se puede expandir una lista de distribución en una sola llamada. Si más de una lista de distribución coincide con los criterios, el servicio web notifica un error. Una aplicación cliente puede usar la resolución de nombres ambigua (ANR) para buscar listas de distribución ambiguas y, a continuación, elegir la dirección de correo electrónico correcta de la lista de distribución necesaria como parámetro para la operación ExpandDL. Para obtener más información, vea Operación ResolveNames.
Las listas de distribución pública se encuentran en Active Directory. Pueden ser cualquier grupo de distribución dinámico o habilitado para correo. El grupo no debe estar oculto de la lista de direcciones y cada miembro debe tener una dirección de correo electrónico no vacía. Los miembros de la lista de distribución pueden ser usuarios y contactos habilitados para correo, carpetas públicas y listas de distribución habilitadas para correo y grupos dinámicos.
Las listas de distribución privada se encuentran en la carpeta Contactos del buzón de un usuario. Las listas de distribución privada no tienen direcciones de correo electrónico, por lo que sus identificadores de elemento de almacén se usan en una solicitud ExpandDL. Los miembros de una lista de distribución privada pueden ser cualquier usuario habilitado para correo, contactos o listas de distribución de Active Directory, o contactos o listas de distribución privadas de la carpeta Contactos de un usuario.
En el caso de los contactos o las listas de distribución privadas, los identificadores de elemento se devuelven en la respuesta. Esto se puede usar para obtener información sobre el objeto o para expandir la pertenencia a una lista de distribución privada.
Ejemplo de solicitud de lista de distribución privada de ExpandDL
Descripción
En el ejemplo siguiente de una solicitud ExpandDL se muestra cómo formar una solicitud para expandir una lista de distribución privada.
Código
<?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>
Comentarios
Para expandir una lista de distribución privada, el elemento Mailbox contendrá el elemento ItemId que identifica una lista de distribución privada en el buzón del usuario.
Ejemplo de solicitud de lista de distribución pública de ExpandDL
Descripción
En el ejemplo siguiente de una solicitud ExpandDL se muestra cómo formar una solicitud para expandir una lista de distribución pública. En el ejemplo se muestra el uso de un nombre para mostrar para expandir una lista de distribución.
Código
<?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>
Comentarios
La respuesta a esta solicitud contendrá elementos Mailbox que identifican cada buzón de la lista de distribución. Si una lista de distribución está incluida en una lista de distribución, se debe realizar una expansión de lista de distribución independiente en la lista de distribución incrustada. Si la lista de distribución no tiene miembros o la lista de distribución solicitada no existe, el atributo ResponseClass contendrá un valor igual a Correcto.
Elementos Request
En la solicitud se usan los siguientes elementos:
EmailAddress (NonEmptyStringType) se usa para identificar listas de distribución públicas. El elemento ItemId se usa para identificar listas de distribución privadas.
Nota:
El esquema que describe estos elementos se encuentra en el directorio virtual EWS del equipo que ejecuta MicrosoftExchange Server 2007 que tiene instalado el rol de servidor acceso de cliente.
Ejemplo de respuesta expandDL correcta
Descripción
En el ejemplo siguiente de una respuesta ExpandDL se muestra una respuesta a la solicitud descrita anteriormente. La expansión de la lista de distribución describe lo siguiente:
Número de miembros de la lista de distribución que se devuelven en la respuesta.
Si la respuesta contiene todos los miembros de la lista de distribución.
Nombre del buzón.
Dirección de correo electrónico del buzón.
Tipo de enrutamiento del buzón de correo.
Tipo de buzón de correo.
Nota:
El nombre de la lista de distribución no se incluye en la respuesta; por lo tanto, debe realizar un seguimiento del nombre de la solicitud.
Código
<?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>
Elementos de respuesta correctos
Los siguientes elementos se usan en la respuesta:
Para buscar otras opciones para el mensaje de respuesta de la operación ExpandDL, explore la jerarquía de esquema. Comience en el elemento ExpandDLResponse .
Respuesta de error de ExpandDL
Descripción
En el ejemplo siguiente se muestra una respuesta de error a una solicitud ExpandDL.
Código
<?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>
Elementos de respuesta de error
Los siguientes elementos se usan en la respuesta de error:
Para buscar otras opciones para el mensaje de respuesta de la operación ExpandDL, explore la jerarquía de esquema. Comience en el elemento ExpandDLResponse .