Filtres et modèles hors connexion et Outlook

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Les filtres de données pour Microsoft Office Outlook déterminent les données qui doivent être synchronisées entre le serveur Microsoft Dynamics 365 et Dynamics CRM pour Outlook.Microsoft Dynamics CRM 2015 et Microsoft Dynamics CRM Online prennent en charge la modification du filtre par défaut utilisé avec le Kit de développement logiciel (SDK) et transmettent ces modifications à certains utilisateurs ou à tous.

Dans le cadre de la nouvelle prise en charge de la personnalisation de filtre, vous pouvez écrire du code qui permet aux administrateurs de créer et publier des modèles de filtre. Cela permet à un administrateur Microsoft Dynamics 365 de créer des filtres courants ou souhaitables pouvant être publiés aux utilisateurs pour la synchronisation avec la banque Microsoft Outlook et la base de données hors connexion. Cela permet également de personnaliser le modèle de filtre par défaut qui sera appliqué pour les utilisateurs ajoutés au système après la publication initiale des modèles. L’administrateur a également la possibilité de mettre à jour ou supprimer des filtres utilisateur après leur publication.

Pour prendre en charge ces personnalisations, il y a quatre nouveaux types de requête pour la requête enregistrée (vue). Lorsque vous créez un enregistrement de requête enregistré (vue), spécifiez un de ces types dans l’attribut SavedQuery.QueryType, à l’aide de l’énumération SavedQueryQueryType. Ces types sont uniquement accessibles à l’aide des méthodes décrites ici. Il n’y a pas d’interface utilisateur pour les modifier. Vous pouvez spécifier différents filtres afin d'éviter de tout synchroniser avec Microsoft Outlook pour votre téléphone mobile. Les modèles de filtre sont compatibles avec les solutions pour pouvoir être exportés avec une solution.

Le tableau suivant répertorie les nouveaux types de requêtes utilisés pour les filtres et les modèles de filtre.

Instancier un filtre

Les modèles par défaut de filtre sont automatiquement instanciés à l’entité UserQuery pour chaque utilisateur lorsque l’abonnement de synchronisation est créé. Lorsque la synchronisation avec Microsoft Outlook ou avec la base de données hors connexion est initialisée, les filtres pour cet utilisateur sont collectés et utilisés pour filtrer les collections d’entrées et d’attributs à synchroniser. Si plusieurs filtres sont spécifiés pour une entité particulière, l’ensemble d’entrées résultant est l’union des résultats des différents filtres.

Il existe un nouveau privilège qui permet à l’administrateur d’accéder aux filtres de l’autre utilisateur : prvAdminFilter. Il s’appelle Gérer les filtres de synchronisation utilisateur dans l’application Web. Le rôle administrateur système comprend ce privilège car sans lui seul l’utilisateur peut afficher ses filtres. L’appel de la méthode IOrganizationService.RetrieveMultiple sur la requête utilisateur extrait des enregistrements uniquement pour l’utilisateur propriétaire, sauf si l’appelant a le privilège prvAdminFilter. La requête doit contenir des conditions où QueryType est égal à OutlookFilters ou OfflineFilters et OwnerId est égal à UserId, où UserId n’est pas égal à l’appelant. Si d’autres conditions sont ajoutées à la requête, cela ne fonctionne pas.

Les nouveaux utilisateurs reçoivent automatiquement les filtres des modèles de filtre marqués par défaut dans l’attribut SavedQuery.IsDefault. Les administrateurs doivent savoir qu’ils peuvent modifier cette valeur pour changer cela. Chaque entité ne peut posséder qu’un modèle de filtre qui est marqué par défaut. Il ne peut pas y avoir de filtres par défaut mais uniquement des modèles de filtre. Si vous créez une entité personnalisée et définissez la propriété IsAvailableOffline, un modèle de filtre par défaut est créé automatiquement.

Il existe un nouveau type de filtre que les administrateurs peuvent définir, à savoir les filtres système. Ces filtres sont définis sous forme d’enregistrements SavedQuery avec le type de requête OutlookFilters ou OfflineFilters. Les filtres système s’appliquent automatiquement à tous les utilisateurs et ne peuvent pas être modifiés par les utilisateurs.

Le nombre de filtres que vous pouvez ajouter est limité. Ce paramètre est contrôlé par l’administrateur de déploiement de Microsoft Dynamics 365 pour empêcher les utilisateurs ou les administrateurs de créer trop de filtres, ce qui affecte les performances du serveur. Le même paramètre de limite est appliqué à toutes les entités.

Par défaut, les paramètres ne sont pas limités pour les filtres système et les filtres utilisateur.

Instancier un modèle

Vous pouvez instancier un ou plusieurs filtres par utilisateur. Pour effectuer cette instanciation manuellement, utilisez InstantiateFiltersRequest pour instancier un filtre et créer un enregistrement de requête utilisateur. Chaque enregistrement de requête utilisateur contient une référence qui revient au filtre. Si vous mettez à jour le filtre, vous pouvez appeler une nouvelle instanciation pour actualiser ou remplacer les modifications apportées par l’utilisateur au filtre (enregistrement de requête utilisateur).

Restaurer les filtres d’un utilisateur à la valeur par défaut

Vous pouvez restaurer les filtres d’un utilisateur à la valeur par défaut avec ResetUserFiltersRequest.

Voir aussi

InstantiateFiltersRequest
ResetUserFiltersRequest
Extension de Microsoft Dynamics CRM 2015 pour Outlook
Écrire du code personnalisé pour Microsoft Dynamics CRM 2015 pour Outlook
Messages et méthodes de l’entité SavedQuery (vue)
Exemple : créer et extraire les filtres Outlook
Interface utilisateur du rôle de sécurité pour le mappage des privilèges

© 2017 Microsoft. Tous droits réservés. Copyright