Compartilhar via


Operação ExpandDL

A operação ExpandDL expõe a associação completa das listas de distribuição.

Usando o método Web ExpandDL

A operação ExpandDL usa o serviço Web localizado em Exchange.asmx. Esse método de serviço Web aceita um elemento mailbox que pode conter um elemento filho EmailAddress (NonEmptyStringType) para uma expansão de uma lista de distribuição pública ou um elemento filho ItemId para a expansão de uma lista de distribuição privada.

As listas de distribuição pública podem ser expandidas usando uma das seguintes:

  1. Alias da lista de distribuição

  2. O endereço do Protocolo SMTP Seguro

  3. X400

  4. X500

  5. Endereço Herdado do Exchange

  6. O nome da lista de distribuição

  7. O nome de exibição

Importante

Os nomes de exibição não são exclusivos. Várias contas podem compartilhar o mesmo nome de exibição.

Comentários

Não há suporte para expansão recursiva. Somente uma lista de distribuição pode ser expandida em uma única chamada. Se mais de uma lista de distribuição corresponder aos critérios, o serviço Web relatará um erro. Um aplicativo cliente pode usar ANR (resolução de nomes ambígua) para encontrar listas de distribuição ambíguas e, em seguida, escolher o endereço de email correto da lista de distribuição necessária como um parâmetro para a operação ExpandDL. Para obter mais informações, confira Operação ResolveNames.

As listas de distribuição pública estão localizadas no Active Directory. Eles podem ser qualquer grupo de distribuição dinâmico ou habilitado para email. O grupo não deve ser oculto da lista de endereços e cada membro deve ter um endereço de email não vazio. Os membros da lista de distribuição podem ser usuários e contatos habilitados para email, pastas públicas e listas de distribuição habilitadas para email e grupos dinâmicos.

Listas de distribuição privadas estão localizadas na pasta Contatos da caixa de correio de um usuário. As listas de distribuição privada não têm endereços de email para que os identificadores de item da loja sejam usados em uma solicitação ExpandDL. Os membros de uma lista de distribuição privada podem ser qualquer usuário habilitado para email, contatos ou listas de distribuição do Active Directory ou contatos ou listas de distribuição privadas da pasta Contatos de um usuário.

Para contatos ou listas de distribuição privadas, os identificadores de item são retornados na resposta. Isso pode ser usado para obter informações sobre o objeto ou para expandir a associação em uma lista de distribuição privada.

Exemplo de solicitação da Lista de Distribuição Privada expandDL

Descrição

O exemplo a seguir de uma solicitação ExpandDL mostra como formar uma solicitação para expandir uma lista de distribuição 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>

Comments

Para expandir uma lista de distribuição privada, o elemento Mailbox conterá o elemento ItemId que identifica uma lista de distribuição privada na caixa de correio do usuário.

Exemplo de solicitação da Lista de Distribuição Pública expandDL

Descrição

O exemplo a seguir de uma solicitação ExpandDL mostra como formar uma solicitação para expandir uma lista de distribuição pública. O exemplo mostra o uso de um nome de exibição para expandir uma lista de distribuição.

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>

Comments

A resposta a essa solicitação conterá elementos da caixa de correio que identificam cada caixa de correio na lista de distribuição. Se uma lista de distribuição estiver contida em uma lista de distribuição, uma expansão de lista de distribuição separada deverá ser executada na lista de distribuição inserida. Se a lista de distribuição não tiver membros ou a lista de distribuição solicitada não existir, o atributo ResponseClass conterá um valor igual a Success.

Elementos de solicitação

Os seguintes elementos são usados na solicitação:

Observação

O esquema que descreve esses elementos está localizado no diretório virtual do EWS do computador que está executando o MicrosoftExchange Server 2007 que tem a função de servidor do Client Access instalada.

Exemplo de resposta ExpandDL bem-sucedido

Descrição

O exemplo a seguir de uma resposta ExpandDL mostra uma resposta à solicitação descrita acima. A expansão da lista de distribuição descreve o seguinte:

  • O número de membros da lista de distribuição que são retornados na resposta.

  • Se a resposta contém todos os membros da lista de distribuição.

  • O nome da caixa de correio.

  • O endereço de email da caixa de correio.

  • O tipo de roteamento da caixa de correio.

  • O tipo de caixa de correio.

Observação

O nome da lista de distribuição não está incluído na resposta; Portanto, você deve manter o controle do nome da solicitação.

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 resposta bem-sucedidos

Os seguintes elementos são usados na resposta:

Para encontrar outras opções para a mensagem de resposta da operação ExpandDL, explore a hierarquia de esquema. Comece no elemento ExpandDLResponse .

Resposta de erro expandDL

Descrição

O exemplo a seguir mostra uma resposta de erro a uma solicitação 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 resposta de erro

Os seguintes elementos são usados na resposta de erro:

Para encontrar outras opções para a mensagem de resposta da operação ExpandDL, explore a hierarquia de esquema. Comece no elemento ExpandDLResponse .

Confira também