Compartir a través de

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 Microsoft Dataverse de modo que se realice un seguimiento automático de todos los correos electrónicos de la carpeta Microsoft Exchange para el registro asignado en Dataverse. 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 Dataverse. Puede habilitar el seguimiento de nivel de carpeta utilizando el cliente web o 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 Microsoft 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 tabla de la carpeta de seguimiento automático del buzón (MailboxTrackingFolder) para configurar y administrar mediante programación las reglas de seguimiento de nivel de carpeta. Para configurar una regla de seguimiento, use las siguientes columnas.

Columna Descripción
ExchangeFolderId Especifique el Id. de carpeta de Microsoft 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. Esta columna es obligatoria.
MailboxId Especifique el Id. de buzón en Dataverse para el que desea crear la regla. Esta columna es obligatoria.
RegardingObjectId Establezca el objeto referente en Dataverse al que desea que se asigne la carpeta de Microsoft Exchange especificada. Se trata de una columna 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 Microsoft 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 Dataverse 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 Dataverse 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 Microsoft Exchange Adventure Works como si fueran actividades en Dataverse 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

RetrieveMailboxTrackingFolders Function
Tabla de carpeta de seguimiento automático del buzón (MailboxTrackingFolder)
Tabla de buzones de correo
Configurar seguimiento a nivel de carpetas
Tablas de sincronización del lado del servidor

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).