Compartir a través de

Configurar reglas de seguimiento de nivel de carpeta de Exchange

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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 Dynamics 365 de modo que se realice un seguimiento automático de todos los correos electrónicos de la carpeta Exchange para el registro asignado en Dynamics 365. 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 Dynamics 365. Puede habilitar el seguimiento de nivel de carpeta utilizando el cliente web o Microsoft Dynamics 365 para Outlook.Más información:TechNet: Configurar seguimiento de nivel de carpeta

  • La carpeta a la que realiza un seguimiento 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.

En este tema

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

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

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.

Atributo

Descripción

MailboxTrackingFolder.ExchangeFolderId

Especifique el Id. de carpeta de Exchange que desea asignar. Puede usar los Servicios Web Exchange (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.

MailboxTrackingFolder.MailboxId

Especifique el Id. de buzón en Dynamics 365 para el que desea crear la regla. Este atributo es obligatorio.

MailboxTrackingFolder.RegardingObjectId

Establezca el objeto referente a en Dynamics 365 al que desea asignar 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 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 Dynamics 365 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 Dynamics 365 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 en la carpeta Adventure WorksExchange como actividades en Dynamics 365 con el referente establecido en 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 cual desea recuperar 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++;
}

Ver también

Mensajes y métodos de la entidad MailboxTrackingFolder (Carpeta de seguimiento automático del buzón)
Mensajes y métodos de la entidad de buzón
TechNet: Configurar seguimiento de nivel de carpeta
Entidades de sincronización del lado del servidor

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright