Compartir vía

Configurar reglas de seguimiento de nivel de carpeta de Exchange

  • Artículo

Configure reglas de seguimiento de nivel de carpeta para asignar una carpeta de la bandeja de entrada de Microsoft Exchange a un registro de Dynamics 365 Customer Engagement (on-premises) de modo que se realice un seguimiento automático de todos los correos electrónicos de la carpeta de Microsoft Exchange para el registro asignado en Customer Engagement. El seguimiento de nivel de carpeta de correos electrónicos funcionará sólo si:

  • La característica de seguimiento de nivel de carpeta está habilitada para la instancia de Customer Engagement. Puede habilitar el seguimiento de nivel de carpeta utilizando el cliente web o Microsoft Dynamics 365 for Outlook. Más información: Configurar el seguimiento de nivel de carpeta

  • La carpeta cuyo seguimiento está realizando se encuentra en la carpeta Bandeja de entrada en Exchange. No se realizará seguimiento de los correos electrónicos en las carpetas que no se encuentran en la carpeta Bandeja de entrada.

Creación y administración de reglas de seguimiento de nivel de carpeta

Use la entidad MailboxTrackingFolder para configurar y administrar mediante programación las reglas de seguimiento de nivel de carpeta. Para configurar una regla de seguimiento, use los siguientes atributos.

Attribute Descripción
ExchangeFolderId Especifique el Id. de carpeta de Exchange que desea asignar. Puede usar Exchange Web Services (EWS) para recuperar el Id. de una carpeta bajo su carpeta Bandeja de entrada. Para obtener más información, vea MSDN: Cómo: Trabajar con carpetas utilizando EWS en Exchange. Este atributo es obligatorio.
MailboxId Especifique el Id. de buzón en Customer Engagement para el que desea crear la regla. Este atributo es obligatorio.
RegardingObjectId Establezca el objeto referente en Customer Engagement al que desea que se asigne la carpeta de Exchange especificada. Se trata de un atributo opcional.

El siguiente código de ejemplo muestra cómo puede crear una regla de seguimiento de nivel de carpeta.

// 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);

Puede crear un máximo de 25 reglas de seguimiento de nivel de carpeta por buzón. El Id. de la carpeta de Exchange no se puede validar en el momento de crear la asignación con el SDK. Sin embargo, en cuanto cree una regla de asignación, y si el Id. de carpeta no es válido, aparecerá en la interfaz de usuario en Customer Engagement para indicar que la asignación no es válida.

Cualquier cambio manual realizado en el objeto referente a en los registros de actividad con seguimiento, creado en Customer Engagement como resultado de la regla de seguimiento de nivel de carpeta, será reemplazado la próxima vez que se produzca la sincronización del lado del servidor. Por ejemplo, si ha configurado una asignación entre la carpeta Adventure Works y la cuenta de Adventure Works, se realizará el seguimiento de todos los correos electrónicos de la carpeta de Exchange Adventure Works como si fueran actividades en Customer Engagement con el referente establecido en el registro de cuenta de Adventure Works. Si cambia el referente de algunas actividades a cualquier otro registro, se reemplazará automáticamente la próxima vez que se produzca la sincronización del lado del servidor.

Recuperar reglas de seguimiento de nivel de carpeta para un buzón

Puede recuperar todas las reglas de seguimiento de nivel de carpeta para un buzón de correo con el mensaje RetrieveMailboxTrackingFoldersRequest. Pase el Id. del buzón para el que desea recuperar las reglas en la propiedad RetrieveMailboxTrackingFoldersRequest.MailboxId y ejecute el mensaje.

El siguiente código de ejemplo muestra cómo puede recuperar reglas de seguimiento de nivel de carpeta para un buzón.

// 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++;  
}

Consulte también

Función RetrieveMailboxTrackingFolders
Entidad MailboxTrackingFolder
Entidad de buzón
Configurar seguimiento a nivel de carpetas
Entidades de sincronización del lado del servidor