Filtres et modèles hors connexion et Outlook

Les filtres de données pour Office Outlook déterminent quelles données doivent être synchronisées entre le serveur Dynamics 365 for Customer Engagement et Dynamics 365 for Outlook. Dynamics 365 for Customer Engagement prend 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 Dynamics 365 for Customer Engagement de créer des filtres courants ou souhaitables pouvant être publiés aux utilisateurs pour la synchronisation avec la banque 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 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.

Type de requête	Description
OutlookFilters	Définit le sous-ensemble d’une entité à synchroniser avec Dynamics 365 for Outlook. Le sous-ensemble de données défini par ces filtres effectuera une synchronisation vers les dossiers Outlook tels que Contacts, Calendrier, etc.
OfflineFilters	Définit le sous-ensemble d’une entité à synchroniser avec Dynamics 365 for Microsoft Office Outlook avec l’accès hors ligne. Le sous-ensemble de données défini par ces filtres effectuera une synchronisation avec la base de données hors connexion.
OutlookTemplate	Définit un modèle de filtre appliqué aux nouveaux utilisateurs pour la synchronisation avec Dynamics 365 for Outlook.
OfflineTemplate	Définit un modèle de filtre appliqué aux nouveaux utilisateurs pour la synchronisation avec Dynamics 365 for Microsoft Office Outlook avec l’accès hors ligne.

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 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. Appeler 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 Dynamics 365 for Customer Engagement 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

Étendre Dynamics 365 for Outlook
Référence de l’entité SavedQuery
Exemple : extraire les filtres Outlook
InstantiateFiltersRequest
ResetUserFiltersRequest