Filtri e modelli offline e di Outlook

Data di pubblicazione: gennaio 2017

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

I filtri dati per Microsoft Office Outlook determinano quali dati devono essere sincronizzati tra il server Microsoft Dynamics 365 e Dynamics 365 per Outlook.Microsoft Dynamics 365 e Microsoft Dynamics 365 (online) supportano la possibilità di modificare il filtro predefinito utilizzando SDK e di eseguire il push delle modifiche a qualsiasi utente o a tutti.

Nell'ambito del nuovo supporto per la personalizzazione del filtro, è possibile scrivere codice che consente agli amministratori di creare e pubblicare i modelli di filtro. Questo consente a un amministratore di Microsoft Dynamics 365 di creare filtri comuni o desiderabili che possono essere pubblicati per gli utenti per la sincronizzazione con l'archivio di Microsoft Outlook e il database offline. Questo consente inoltre di personalizzare il modello di filtro predefinito da applicare per gli utenti aggiunti al sistema dopo la pubblicazione in origine dei modelli. L'amministratore può inoltre aggiornare o eliminare i filtri utente dopo che sono stati pubblicati.

Per supportare queste personalizzazioni, esistono quattro nuovi tipi di query per la query salvata (visualizzazione). Quando si crea un record query salvata (visualizzazione), specificare uno di questi tipi nell'attributo SavedQuery.QueryType, utilizzando l'enumerazione SavedQueryQueryType. Questi sono accessibili solo utilizzando i metodi descritti qui; non è disponibile un'interfaccia utente per modificarli. È possibile specificare i diversi filtri in modo da evitare di sincronizzare tutto con Microsoft Outlook per il cellulare. I modelli di filtro riconoscono le soluzioni in modo che sia possibile esportarli insieme a una soluzione.

Nella tabella seguente sono elencati i nuovi tipi di query utilizzati per i filtri e i modelli di filtro.

Creare un'istanza di un filtro.

Viene automaticamente creata un'istanza dei modelli di filtro predefiniti nell'entità UserQuery per ogni utente quando viene creata la sottoscrizione per la sincronizzazione. La sincronizzazione con Microsoft Outlook o il database offline è stata avviata, i filtri per tale utente vengono raccolti e utilizzati per filtrare le raccolte di voci e gli attributi in corso di sincronizzazione. Se vengono specificati più filtri per un'entità particolare, il set di voci risultante sarà l'unione dei risultati dei singoli filtri.

Esiste un nuovo privilegio che consente all'amministratore di accedere ai filtri di un altro utente: prvAdminFilter. Tale privilegio è denominato Gestisci filtri sincronizzazione utenti nell'applicazione Web. Il ruolo di amministratore di sistema include questo privilegio perché senza di esso, solo l'utente può accedere ai filtri. Chiamando il metodo IOrganizationService.RetrieveMultiple sulla query utente verranno recuperati i record solo per l'utente proprietario, a meno che il chiamante abbia il privilegio prvAdminFilter nella query è necessario includere condizioni dove QueryType è uguale a OutlookFilters o OfflineFilters AND OwnerId è uguale a UserId, dove UserId non è uguale al chiamante. Se alla query vengono aggiunte altre condizioni, questo non funzionerà.

Ai nuovi utenti vengono automaticamente assegnati i filtri dai modelli di filtro contrassegnati come predefiniti nell'attributo SavedQuery.IsDefault. Gli amministratori devono avere la certezza di poter modificare questo valore per applicare questo. Ogni entità può avere solo un modello di filtro contrassegnato come predefinito. Non possono esserci filtri predefiniti, solo modelli di filtro. Se si crea un'entità personalizzata e si imposta la proprietà IsAvailableOffline, viene automaticamente creato un modello di filtro predefinito.

Esiste un nuovo tipo di filtro che gli amministratori possono definire, denominati filtri di sistema. Questi filtri vengono definiti come record SavedQuery con il tipo di query di OutlookFilters o OfflineFilters. I filtri di sistema sono automaticamente applicabili a tutti gli utenti e non possono essere modificati dagli utenti.

Esiste un limite relativo al numero di filtri che è possibile aggiungere. Questa impostazione è controllata dall'amministratore della distribuzione di Microsoft Dynamics 365 per impedire agli utenti o agli amministratori di creare troppi filtri, che influisce sulle prestazioni del server. La stessa impostazione relativa al limite viene applicata per tutte le entità.

Per impostazione predefinita, esiste un numero illimitato di impostazioni sia per filtri di sistema che per i filtri utente.

Creare un'istanza di un modello

È possibile creare un'istanza di uno o più filtri per utente. Per eseguire questa operazione manualmente, utilizzare InstantiateFiltersRequest per creare un'istanza di un filtro, creando un record della query dell'utente. Ogni record della query dell'utente include un riferimento di nuovo al filtro. Se si aggiorna il filtro, è possibile chiamare di nuovo la creazione di un'istanza per aggiornare o sostituire le modifiche al filtro apportate dall'utente (record query utente).

Ripristinare i valori predefiniti dei filtri dell'utente

È possibile ripristinare i valori predefiniti dei filtri dell'utente utilizzando ResetUserFiltersRequest.

Vedere anche

InstantiateFiltersRequest
ResetUserFiltersRequest
Estendere Microsoft Dynamics 365 per Outlook
Scrivere codice personalizzato per Microsoft Dynamics 365 per Outlook
Metodi e messaggi dell'entità SavedQuery (visualizzazione)
Esempio: creare e recuperare i filtri di Outlook
Mapping del ruolo di sicurezza dell'interfaccia utente a privilegio

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright