Opération ExpandDL
L’opération ExpandDL expose l’appartenance complète des listes de distribution.
Utilisation de la méthode web ExpandDL
L’opération ExpandDL utilise le service Web qui se trouve dans Exchange.asmx. Cette méthode de service Web accepte un élément Mailbox qui peut contenir un élément enfant EmailAddress (NonEmptyStringType) pour une extension d’une liste de distribution publique ou un élément enfant ItemId pour l’extension d’une liste de distribution privée.
Les listes de distribution publiques peuvent être développées à l’aide de l’une des options suivantes :
Alias de liste de distribution
Adresse du service SMTP (Simple Mail Transfer Protocol)
X400
X500
Adresse héritée Exchange
Nom de la liste de distribution
Nom d’affichage
Importante
Les noms d’affichage ne sont pas uniques. Plusieurs comptes peuvent partager le même nom d’affichage.
Remarques
L’expansion récursive n’est pas prise en charge. Une seule liste de distribution peut être développée en un seul appel. Si plusieurs listes de distribution correspondent aux critères, le service Web signale une erreur. Une application cliente peut utiliser la résolution de noms ambiguë (ANR) pour rechercher des listes de distribution ambiguës, puis choisir l’adresse de messagerie correcte de la liste de distribution requise comme paramètre pour l’opération ExpandDL. Pour plus d’informations, consultez Opération ResolveNames.
Les listes de distribution publiques se trouvent dans Active Directory. Il peut s’agir de n’importe quel groupe de distribution dynamique ou à extension messagerie. Le groupe ne doit pas être masqué de la liste d’adresses et chaque membre doit avoir une adresse de messagerie non vide. Les membres de la liste de distribution peuvent être des utilisateurs et des contacts à extension messagerie, des dossiers publics, des listes de distribution à extension messagerie et des groupes dynamiques.
Les listes de distribution privées se trouvent dans le dossier Contacts de la boîte aux lettres d’un utilisateur. Les listes de distribution privées n’ont pas d’adresses de messagerie et leurs identificateurs d’éléments de magasin sont donc utilisés dans une requête ExpandDL. Les membres d’une liste de distribution privée peuvent être des utilisateurs à extension messagerie, des contacts ou des listes de distribution d’Active Directory, ou des contacts ou des listes de distribution privées du dossier Contacts d’un utilisateur.
Pour les contacts ou les listes de distribution privées, les identificateurs d’élément sont retournés dans la réponse. Cela peut être utilisé pour obtenir des informations sur l’objet ou pour développer l’appartenance à une liste de distribution privée.
Exemple de demande de liste de distribution privée ExpandDL
Description
L’exemple suivant de requête ExpandDL montre comment former une demande pour développer une liste de distribution privée.
Code
<?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
Pour développer une liste de distribution privée, l’élément Mailbox contient l’élément ItemId qui identifie une liste de distribution privée dans la boîte aux lettres de l’utilisateur.
Exemple de demande de liste de distribution publique ExpandDL
Description
L’exemple suivant de requête ExpandDL montre comment former une demande pour développer une liste de distribution publique. L’exemple montre l’utilisation d’un nom d’affichage pour développer une liste de distribution.
Code
<?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
La réponse à cette demande contient des éléments Mailbox qui identifient chaque boîte aux lettres dans la liste de distribution. Si une liste de distribution est contenue dans une liste de distribution, une extension de liste de distribution distincte doit être effectuée sur la liste de distribution incorporée. Si la liste de distribution n’a aucun membre ou si la liste de distribution demandée n’existe pas, l’attribut ResponseClass contient une valeur égale à Success.
Éléments de requête
Les éléments suivants sont utilisés dans la demande :
EmailAddress (NonEmptyStringType) est utilisé pour identifier les listes de distribution publiques. L’élément ItemId est utilisé pour identifier les listes de distribution privées.
Remarque
Le schéma qui décrit ces éléments se trouve dans le répertoire virtuel EWS de l’ordinateur exécutant MicrosoftExchange Server 2007 sur lequel le rôle serveur d’accès au client est installé.
Exemple de réponse ExpandDL réussie
Description
L’exemple suivant de réponse ExpandDL montre une réponse à la requête décrite ci-dessus. L’extension de la liste de distribution décrit les éléments suivants :
Nombre de membres de la liste de distribution retournés dans la réponse.
Indique si la réponse contient tous les membres de la liste de distribution.
Nom de la boîte aux lettres.
Adresse de messagerie de la boîte aux lettres.
Type de routage de la boîte aux lettres.
Type de boîte aux lettres.
Remarque
Le nom de la liste de distribution n’est pas inclus dans la réponse ; par conséquent, vous devez suivre le nom de la demande.
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="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>
Éléments de réponse réussis
Les éléments suivants sont utilisés dans la réponse :
Pour trouver d’autres options pour le message de réponse de l’opération ExpandDL, explorez la hiérarchie de schéma. Commencez à l’élément ExpandDLResponse .
Réponse d’erreur ExpandDL
Description
L’exemple suivant montre une réponse d’erreur à une requête ExpandDL.
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="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>
Éléments de réponse d’erreur
Les éléments suivants sont utilisés dans la réponse d'erreur :
Pour trouver d’autres options pour le message de réponse de l’opération ExpandDL, explorez la hiérarchie de schéma. Commencez à l’élément ExpandDLResponse .