Configurar regras de acompanhamento no nível de pasta do Exchange

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Configure regras de acompanhamento no nível de pasta para mapear uma pasta de caixa de entrada do Microsoft Exchange para um registro do Microsoft Dynamics 365 de forma que todos os emails na pasta do Exchange sejam automaticamente acompanhados em relação ao registro mapeado no Dynamics 365. O acompanhamento no nível de pasta só funcionará se:

  • O recurso de acompanhamento no nível de pasta está habilitado para sua instância do Dynamics 365. Você pode habilitar o acompanhamento no nível de pasta usando o cliente Web ou o Microsoft Dynamics CRM para Outlook.Para obter mais informações:TechNet: Configurar o acompanhamento no nível de pasta

  • A pasta que você está acompanhando está na pasta Caixa de Entrada do Exchange. Os emails nas pastas que não estiverem na pasta Caixa de Entrada não serão acompanhados.

Observação

Para organizações que utilizam o Microsoft Dynamics CRM Online, esse recurso só estará disponível se a sua organização tiver atualizado para a Atualização 1 do Dynamics CRM Online 2015. Este recurso não está disponível para o Dynamics CRM (local).

Neste tópico

Criar e gerenciar regras de acompanhamento no nível de pasta

Recuperar regras de acompanhamento no nível de pasta para uma caixa de correio

Criar e gerenciar regras de acompanhamento no nível de pasta

Use a entidade MailboxTrackingFolder para configurar e gerenciar programaticamente suas regras de acompanhamento no nível de pasta. Para configurar uma regra de acompanhamento, use os atributos a seguir.

Atributo

Descrição

MailboxTrackingFolder.ExchangeFolderId

Especifique a ID da pasta do Exchange que você deseja mapear. Você pode usar o Serviços Web do Exchange (EWS) para recuperar a ID de uma pasta em sua pasta Caixa de Entrada. Para obter mais informações, consulte MSDN: Como trabalhar com pastas usando o EWS no Exchange. Esse é um atributo obrigatório.

MailboxTrackingFolder.MailboxId

Especifique a ID da caixa de correio no Dynamics 365 para a qual você deseja criar a regra. Esse é um atributo obrigatório.

MailboxTrackingFolder.RegardingObjectId

Defina o objeto referente no Dynamics 365 para o qual você deseja que a pasta do Exchange especificada seja mapeada. Esse é um atributo opcional.

O código de exemplo a seguir mostra como criar uma regra de acompanhamento no nível de pasta.

// Create a folder-level tracking rule
MailboxTrackingFolder newTrackingFolder = new MailboxTrackingFolder();

// Set the required attributes
newTrackingFolder.ExchangeFolderId = "123456"; // Sample value. Retrieve this value using Exchange Web Services (EWS)
newTrackingFolder.MailboxId = new EntityReference(Mailbox.EntityLogicalName, _mailboxId);

// Set the optional attributes
newTrackingFolder.RegardingObjectId = new EntityReference(Account.EntityLogicalName, _accountId);
newTrackingFolder.RegardingObjectId.Name = _accountName;
newTrackingFolder.ExchangeFolderName = "Sample Exchange Folder";

// Execute the request to create the rule 
_folderTrackingId = _serviceProxy.Create(newTrackingFolder);
Console.WriteLine("Created folder-level tracking rule for '{0}'.\n", _mailboxName);

É possível criar um máximo de 25 regras de acompanhamento no nível de pasta por caixa de correio. A ID da pasta do Exchange não pode ser validada no momento da criação do mapeamento usando o SDK. Entretanto, assim que você criar uma regra de mapeamento, e se a ID da pasta for inválida, será mostrada na interface do usuário no Dynamics 365 para indicar que o mapeamento é inválido.

Todas as alterações manuais feitas no objeto referente nos registros de atividade acompanhados, criados no Dynamics 365 como resultado da regra de acompanhamento no nível de pasta, serão substituídas quando a próxima sincronização no servidor ocorrer. Por exemplo, se você tiver configurado um mapeamento entre a pasta Adventure Works e a conta do Adventure Works, todos os emails na pasta Adventure WorksExchange serão acompanhados como atividades no Dynamics 365 com o conjunto referente ao registro da conta do Adventure Works. Se você alterar o referente de algumas atividades para qualquer outro registro, ele será automaticamente substituído na próxima ocorrência da sincronização no servidor.

Recuperar regras de acompanhamento no nível de pasta para uma caixa de correio

Você pode recuperar todas as regras de acompanhamento no nível de pasta para uma caixa de correio usando a mensagem RetrieveMailboxTrackingFoldersRequest. Passe a ID da caixa de correio para a qual deseja recuperar as regras na propriedade RetrieveMailboxTrackingFoldersRequest.MailboxId e execute a mensagem.

O código de exemplo a seguir mostra como recuperar regras de acompanhamento no nível de pasta para uma caixa de correio.

// Retrieve the folder mapping rules for a mailbox
RetrieveMailboxTrackingFoldersRequest req = new RetrieveMailboxTrackingFoldersRequest
{
    MailboxId = _mailboxId.ToString()
};

RetrieveMailboxTrackingFoldersResponse resp = (RetrieveMailboxTrackingFoldersResponse_serviceProxy.Execute(req);
Console.WriteLine("Retrieved folder-level tracking rules for {0}:", _mailboxName);
int n = 1;
foreach (var folderMapping in resp.MailboxTrackingFolderMappings)
{
    Console.WriteLine("\tRule {0}: '{1}' is mapped to '{2}'.", 
        n, folderMapping.ExchangeFolderName, folderMapping.RegardingObjectName);
    n++;
}

Confira Também

Mensagens e métodos da entidade MailboxTrackingFolder (pasta de controle automático da Caixa de Correio)
Mensagens e métodos da entidade da caixa de correio
TechNet: Configurar o acompanhamento no nível de pasta
Entidades de sincronização no servidor

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais