ExpandDL-Vorgang

Der ExpandDL-Vorgang macht die vollständige Mitgliedschaft von Verteilerlisten verfügbar.

Verwenden der ExpandDL-Webmethode

Der ExpandDL-Vorgang verwendet den Webdienst, der sich in Exchange.asmx befindet. Diese Webdienstmethode akzeptiert ein Mailbox-Element , das entweder ein untergeordnetes EmailAddress-Element (NonEmptyStringType) für eine Erweiterung einer öffentlichen Verteilerliste oder ein untergeordnetes ItemId-Element für die Erweiterung einer privaten Verteilerliste enthalten kann.

Öffentliche Verteilerlisten können mithilfe einer der folgenden Optionen erweitert werden:

1. Verteilerlistenalias

2. Die SMTP-Adresse (Simple Mail Transfer Protocol)

3. X400

4. X500

5. Exchange Legacy-Adresse

6. Der Name der Verteilerliste

7. Der Anzeigename

Hinweise

Die rekursive Erweiterung wird nicht unterstützt. In einem einzigen Aufruf kann nur eine Verteilerliste erweitert werden. Wenn mehrere Verteilerlisten den Kriterien entsprechen, meldet der Webdienst einen Fehler. Eine Clientanwendung kann mehrdeutige Namensauflösung (Ambiguous Name Resolution, ANR) verwenden, um mehrdeutige Verteilerlisten zu finden, und dann die richtige E-Mail-Adresse der erforderlichen Verteilerliste als Parameter für den ExpandDL-Vorgang auswählen. Weitere Informationen finden Sie unter ResolveNames-Vorgang.

Öffentliche Verteilerlisten befinden sich in Active Directory. Dabei kann es sich um eine beliebige E-Mail-aktivierte oder dynamische Verteilergruppe handeln. Die Gruppe sollte nicht in der Adressliste ausgeblendet werden, und jedes Mitglied sollte über eine nicht leere E-Mail-Adresse verfügen. Mitglieder der Verteilerliste können E-Mail-aktivierte Benutzer und Kontakte, öffentliche Ordner und E-Mail-aktivierte Verteilerlisten und dynamische Gruppen sein.

Private Verteilerlisten befinden sich im Ordner Kontakte des Postfachs eines Benutzers. Private Verteilerlisten verfügen über keine E-Mail-Adressen, sodass ihre Store-Elementbezeichner in einer ExpandDL-Anforderung verwendet werden. Mitglieder einer privaten Verteilerliste können alle E-Mail-aktivierten Benutzer, Kontakte oder Verteilerlisten aus Active Directory oder Kontakte oder private Verteilerlisten aus dem Ordner Kontakte eines Benutzers sein.

Bei Kontakten oder privaten Verteilerlisten werden die Elementbezeichner in der Antwort zurückgegeben. Dies kann verwendet werden, um Informationen zum Objekt abzurufen oder die Mitgliedschaft in einer privaten Verteilerliste zu erweitern.

Beispiel für die Anforderung einer privaten Verteilerliste für ExpandDL

Beschreibung

Das folgende Beispiel einer ExpandDL-Anforderung zeigt, wie eine Anforderung zum Erweitern einer privaten Verteilerliste erstellt wird.

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>

Kommentare

Um eine private Verteilerliste zu erweitern, enthält das Mailbox-Element das Element ItemId , das eine private Verteilerliste im Postfach des Benutzers identifiziert.

Beispiel für die Anforderung einer öffentlichen Verteilerliste für ExpandDL

Beschreibung

Das folgende Beispiel einer ExpandDL-Anforderung zeigt, wie eine Anforderung zum Erweitern einer öffentlichen Verteilerliste zu erstellen ist. Das Beispiel zeigt die Verwendung eines Anzeigenamens zum Erweitern einer Verteilerliste.

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>

Kommentare

Die Antwort auf diese Anforderung enthält Postfachelemente , die jedes Postfach in der Verteilerliste identifizieren. Wenn eine Verteilerliste in einer Verteilerliste enthalten ist, muss eine separate Verteilerlisteerweiterung für die eingebettete Verteilerliste ausgeführt werden. Wenn die Verteilerliste keine Elemente enthält oder die angeforderte Verteilerliste nicht vorhanden ist, enthält das ResponseClass-Attribut einen Wert, der dem Wert Success entspricht.

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

• ExpandDL

• Postfach

• EmailAddress (NonEmptyStringType) wird verwendet, um öffentliche Verteilerlisten zu identifizieren. Das ItemId-Element wird verwendet, um private Verteilerlisten zu identifizieren.

Beispiel für eine erfolgreiche ExpandDL-Antwort

Beschreibung

Das folgende Beispiel einer ExpandDL-Antwort zeigt eine Antwort auf die oben beschriebene Anforderung. Die Erweiterung der Verteilerliste beschreibt Folgendes:

• Die Anzahl der Mitglieder der Verteilerliste, die in der Antwort zurückgegeben werden.

• Gibt an, ob die Antwort alle Elemente der Verteilerliste enthält.

• Der Name des Postfachs.

• Die E-Mail-Adresse des Postfachs.

• Der Routingtyp für das Postfach.

• Der Typ des Postfachs.

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>

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

• ServerVersionInfo

• ExpandDLResponse

• ResponseMessages

• ExpandDLResponseMessage

• ResponseCode

• DLExpansion

• Postfach

• Name (EmailAddressType)

• EmailAddress (NonEmptyStringType)

• RoutingType (EmailAddressType)

• MailboxType

Weitere Optionen für die Antwortmeldung des ExpandDL-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem ExpandDLResponse-Element .

ExpandDL-Fehlerantwort

Beschreibung

Das folgende Beispiel zeigt eine Fehlerantwort auf eine ExpandDL-Anforderung.

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>

Fehlerantwortelemente

Folgende Elemente werden in der Fehlerantwort verwendet:

• ServerVersionInfo

• ExpandDLResponse

• ResponseMessages

• ExpandDLResponseMessage

• MessageText

• ResponseCode

• DescriptiveLinkKey

Weitere Optionen für die Antwortmeldung des ExpandDL-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem ExpandDLResponse-Element .

Siehe auch

• ResolveNames-Vorgang
• EWS-XML-Elemente in Exchange