Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Фильтры данных для Office Outlook определяют, какие данные следует синхронизировать между сервером Dynamics 365 для Customer Engagement и Dynamics 365 для Outlook. Dynamics 365 for Customer Engagement поддерживает возможность изменения фильтра по умолчанию с помощью пакета SDK и отправки этих изменений любому или всем пользователям.
В рамках новой поддержки настройки фильтра можно написать код, позволяющий администраторам создавать и публиковать шаблоны фильтров. Это позволяет администратору Dynamics 365 for Customer Engagement создавать общие или желательные фильтры, которые можно публиковать пользователям для синхронизации с Магазином Outlook и автономной базой данных. Это также позволяет настроить шаблон фильтра по умолчанию, который будет применен для пользователей, которые добавляются в систему после первоначальной публикации шаблонов. Администратор также может обновлять или удалять фильтры пользователей после публикации.
Для поддержки этих настроек представлено четыре новых типа запросов для сохраненных запросов (представлений). При создании записи сохраненного запроса (представления), укажите один из этих типов в атрибуте SavedQuery.QueryType, используя перечисление SavedQueryQueryType. Они доступны только с помощью описанных здесь методов; Пользовательский интерфейс недоступен для их изменения. Можно указать различные фильтры, чтобы избежать синхронизации всего с Outlook для мобильного телефона. Шаблоны фильтров осведомлены о решении, поэтому их можно экспортировать вместе с ним.
В следующей таблице перечислены новые типы запросов, используемые для фильтров и шаблонов фильтров.
| Тип запроса | Description |
|---|---|
| OutlookFilters | Определяет подмножество сущности для синхронизации с Dynamics 365 для Outlook. Подмножество данных, определенных этими фильтрами, синхронизируется с папками Outlook, такими как контакты, календарь и т. д. |
| OfflineFilters | Определяет подмножество сущности, подлежащее синхронизации с Dynamics 365 для Microsoft Office Outlook с режимом автономного доступа. Подмножество данных, определенных этими фильтрами, синхронизируется с автономной базой данных. |
| OutlookTemplate | Определяет шаблон фильтра, применяемый к новым пользователям для синхронизации с Dynamics 365 для Outlook. |
| OfflineTemplate | Определяет шаблон фильтра, применяемый к новым пользователям для синхронизации с Dynamics 365 для Microsoft Office Outlook с автономным доступом. |
Инстанцировать фильтр
Шаблоны фильтров по умолчанию автоматически инстанцируются для сущности UserQuery для каждого пользователя при создании подписки на синхронизацию. При инициировании синхронизации с Outlook или автономной базой данных фильтры для этого пользователя собираются и используются для фильтрации коллекций записей и атрибутов, которые синхронизируются. Если для определенной сущности задано несколько фильтров, результирующий набор записей будет объединением результатов отдельных фильтров.
Существует новая привилегия, позволяющая администратору получить доступ к фильтрам других пользователей: prvAdminFilter Это называется "Управление фильтрами синхронизации пользователей" в веб-приложении. Роль системного администратора включает эту привилегию, так как без нее только пользователь может видеть свои фильтры. При вызове метода IOrganizationService.RetrieveMultiple в запросе пользователя будут извлекаться записи только для ответственного пользователя, если вызывающий пользователь имеет привилегию prvAdminFilter. Запрос должен содержать условия, в которых QueryType равно OutlookFilters или OfflineFilters И OwnerId равно UserId, где UserId не равно вызывающему пользователю. Если в запрос добавляются другие условия, это не будет работать.
Новые пользователи автоматически получают фильтры из шаблонов фильтров, которые отмечены как значения по умолчанию в атрибуте SavedQuery.IsDefault. Администраторы должны знать, что они могут изменить это значение, чтобы повлиять на это. Каждая сущность может иметь только один шаблон фильтра, помеченный как стандартный. Фильтры по умолчанию отсутствуют, только шаблоны фильтров. При создании пользовательской сущности и установке IsAvailableOffline свойства шаблон фильтра по умолчанию создается автоматически.
Существует новый тип фильтра, который администраторы могут определять, называемые системными фильтрами. Эти фильтры определяются как записи SavedQuery с типом запроса OutlookFilters или OfflineFilters. Системные фильтры автоматически применяются ко всем пользователям и не могут быть изменены пользователями.
Существует ограничение на количество добавленных фильтров. Этот параметр управляется администратором развертывания Dynamics 365 for Customer Engagement, чтобы запретить пользователям или администраторам создавать слишком много фильтров, что влияет на производительность сервера. Один и тот же параметр ограничения применяется ко всем сущностям.
По умолчанию существуют неограниченные параметры для системных фильтров и пользовательских фильтров.
Создание экземпляра шаблона
Вы можете создать экземпляр одного или нескольких фильтров для каждого пользователя. Чтобы сделать это вручную, используйте InstantiateFiltersRequest, чтобы создать экземпляр фильтра и запись запроса пользователя. Каждая запись запроса пользователя содержит ссылку обратно на фильтр. При обновлении фильтра можно снова вызвать создание экземпляра, чтобы обновить или переопределить изменения пользователя в фильтре (записи запроса пользователя).
Сброс фильтров пользователя до значения по умолчанию
Вы можете сбросить фильтры для пользователя по умолчанию с помощью параметра ResetUserFiltersRequest.
См. также
Расширение Dynamics 365 for Outlook
Справочник по сущностям SavedQuery
Пример. Получение фильтров Outlook
InstantiateFiltersRequest
ResetUserFiltersRequest