Configurare le regole di tracciabilità a livello di cartella di Exchange

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Configura le regole di tracciabilità a livello di cartella per eseguire il mapping di una cartella di posta in arrivo di Microsoft Exchange in un record di Microsoft Dynamics 365 in modo che tutti i messaggi e-mail nella cartella di Exchange vengano automaticamente tracciati in base al record mappato in Dynamics 365. La tracciabilità a livello di cartella dei messaggi e-mail può essere eseguita solo se:

• La funzionalità di tracciabilità a livello di cartella è abilitata nell'istanza di Dynamics 365 in uso. Puoi abilitare la tracciabilità a livello di cartella utilizzando il client Web o Microsoft Dynamics 365 per Outlook.Ulteriori informazioni:TechNet: Configura la tracciabilità a livello di cartella

• La cartella che stai tracciando si trova nella cartella Posta in arrivo di Exchange. I messaggi e-mail presenti in cartelle che non si trovano nella cartella Posta in arrivo non vengono tracciati.

In questo argomento

Creare e gestire le regole di tracciabilità a livello di cartella

Recuperare le regole di tracciabilità a livello di cartella per una cassetta postale

Creare e gestire le regole di tracciabilità a livello di cartella

Utilizzare l'entità MailboxTrackingFolder programmatico per configurare e gestire le regole di tracciabilità a livello di cartella. Per impostare una regola di tracciabilità, utilizzare gli attributi indicati di seguito.

Attributo	Descrizione
MailboxTrackingFolder.ExchangeFolderId	Specifica l'ID cartella di Exchange di cui desideri eseguire il mapping. Puoi utilizzare Servizi Web Exchange (EWS, Exchange Web Services) per recuperare l'ID di una cartella presente nella cartella Posta in arrivo. Per ulteriori informazioni, vedi MSDN: Procedura: Utilizzare le cartelle con EWS in Exchange. Questo attributo è obbligatorio.
MailboxTrackingFolder.MailboxId	Specifica in Dynamics 365 l'ID della cassetta postale per cui desideri creare la regola. Questo attributo è obbligatorio.
MailboxTrackingFolder.RegardingObjectId	Imposta in Dynamics 365 l'oggetto tema di cui desideri eseguire il mapping alla cartella specificata di Exchange. Questo attributo è facoltativo.

Il seguente codice di esempio illustra come puoi creare una regola di tracciabilità a livello di cartella.

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

Puoi creare fino a un massimo di 25 di regole di tracciabilità a livello di cartella per ogni cassetta postale. L'ID della cartella di Exchange non può essere convalidato al momento della creazione del mapping utilizzando SDK. Tuttavia, se quando crei una regola di mapping l'ID cartella non è valido, verrà visualizzato nell'interfaccia utente di Dynamics 365 per indicare che il mapping non è valido.

Tutte le modifiche manuali apportate all'oggetto tema nei record relativi all'impegno tracciati, creati in Dynamics 365 in base alla regola di tracciabilità a livello di cartella, vengono sostituite alla successiva sincronizzazione lato server. Ad esempio, se hai configurato un mapping tra la cartella Adventure Works e l'account Adventure Works, tutti i messaggi e-mail nella cartella Adventure Works di Exchange verranno tracciati come impegni in Dynamics 365 con il tema impostato sul record dell'account Adventure Works. Se modifichi il tema di un'attività su un altro record, questo viene automaticamente sostituito alla successiva sincronizzazione lato server.

Recuperare le regole di tracciabilità a livello di cartella per una cassetta postale

È possibile recuperare tutte le regole di tracciabilità a livello di cartella per una cassetta postale utilizzando il messaggio RetrieveMailboxTrackingFoldersRequest. Passa l'ID cassetta postale per la quale desideri recuperare le regole nella proprietà RetrieveMailboxTrackingFoldersRequest.MailboxId ed esegui il messaggio.

Il seguente codice di esempio illustra come puoi recuperare le regole di tracciabilità a livello di cartella per una cassetta postale.

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

Vedere anche

Metodi e messaggi dell'entità MailboxTrackingFolder (cartella di registrazione automatica della cassetta postale)
Metodi e messaggi dell'entità cassetta postale
TechNet: Configura la tracciabilità a livello di cartella
Entità di sincronizzazione lato server

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright