Filtros e modelos do Outlook e offline

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Os filtros de dados para Microsoft Office Outlook determinam quais dados devem ser sincronizados entre o servidor Microsoft Dynamics 365 e Dynamics 365 para Outlook.Microsoft Dynamics 365 e Microsoft Dynamics 365 (online) suportam a capacidade de alterar o filtro padrão e usam o SDK para enviar por push essas alterações a alguns ou a todos os usuários.

Como parte do novo suporte para personalização de filtragem, você pode escrever código que permite que os administradores criem e publiquem modelos de filtragem. Isso permite um administrador do Microsoft Dynamics 365 criar filtros comuns ou desejados que podem ser publicados para os usuários para sincronizar com o Microsoft Outlook Store e o banco de dados offline. Isso também fornece uma forma de personalizar o modelo de filtro padrão que será aplicado aos usuários que serão adicionados ao sistema depois que os modelos forem publicados originalmente. O administrador também tem a capacidade de atualizar ou excluir filtros do usuário após serem publicados.

Para suportar essas personalizações, há quatro novos tipos de consulta para a consulta salva (exibição). Quando você cria um registro de consulta salva (exibição), especifica um desses tipos no atributo SavedQuery.QueryType, usando a enumeração SavedQueryQueryType. Só são acessíveis usando os métodos descritos aqui; não há interface do usuário disponível para alteá-los. Você pode especificar filtros diferentes para que possa sincronizar tudo do Microsoft Outlook para sincronizar seu celular. Os modelos de filtragem são soluções conhecidas para que possam ser exportados com uma solução.

A tabela a seguir lista os novos tipos de consulta usados para filtros e modelos de filtragem.

Criar uma instância do filtro

Os modelos de filtragem padrão são instanciados automaticamente para a entidade UserQuery para cada usuário quando a assinatura de sincronização será criada. Quando a sincronização para o Microsoft Outlook ou o banco de dados offline é lançada, os filtros desse usuário são coletados e usados para filtrar os conjuntos de entradas e atributos que estão sendo sincronizados. Se vários filtros são especificados para uma determinada entidade, o conjunto resultante de entradas será uma união dos resultados de filtros individuais.

Há um novo privilégio permitindo que o administrador acesse os filtros de outro usuário: prvAdminFilter. Isso é chamado Gerenciar Filtros de Sincronização do Usuário no aplicativo Web. A função de administrador do sistema inclui esse privilégio porque sem ela, apenas o usuário pode ver os filtros. Chamar o método IOrganizationService.RetrieveMultiple na consulta do usuário recuperará registros apenas para o usuário proprietário, a não ser que o chamador tenha o privilégio prvAdminFilter, a consulta deve conter condições onde QueryType é igual a OutlookFilters ou OfflineFilters E OwnerId é igual a UserId, onde UserId não é igual ao chamador. Se outras condições forem adicionada à essa consulta, não funcionará.

Os novos usuários são fornecidos com filtros automaticamente dos modelos de filtragem marcados como padrão no atributo SavedQuery.IsDefault. Os administradores precisam saber que eles podem alterar esse valor para afetar. Cada entidade pode ter apenas um modelo de filtragem marcado como padrão. Pode não haver filtros padrão, apenas modelos de filtragem. Se você criar uma entidade personalizada e definir a propriedade IsAvailableOffline, um modelo de filtragem padrão é criado automaticamente.

Há um novo tipo de filtro que os administradores podem definir, chamados filtros do sistema. Esses filtros são definidos como registros SavedQuery com o tipo de consulta de OutlookFilters ou OfflineFilters. Os filtros do sistema são aplicados automaticamente a todos os usuários e não podem ser alterados se os usuários.

Há um limite sobre o número de filtros que podem ser adicionados. Essa configuração é controlada pelo administrador de implantação do Microsoft Dynamics 365 para evitar que os usuários ou administradores criem muitos filtros, que afeta o desempenho do servidor. A mesma configuração de limite é aplicada a todas as entidades.

Por padrão, há configurações ilimitados para filtros do sistema e filtros do usuário.

Instanciar um modelo

Você pode instanciar um mais filtros por usuário. Para fazer isso manualmente, use o InstantiateFiltersRequest para instanciar um filtro criando um registro de consulta do usuário. Cada registro de consulta do usuário contém uma referência de volta para o filtro. Se você atualizar o filtro, é possível chamar uma instância novamente para atualizar ou substituir as alterações do usuário para o filtro (registro de consulta do usuário).

Redefina os filtros de um usuário para o padrão

Você pode redefinir os filtros para um usuário como padrão usando ResetUserFiltersRequest.

Confira Também

InstantiateFiltersRequest
ResetUserFiltersRequest
Estender o Microsoft Dynamics 365 para Outlook
Escrever código personalizado do Microsoft Dynamics 365 para Outlook
Mensagens e métodos da entidade SavedQuery (exibição)
Exemplo: Criar e recuperar filtros do Outlook
Interface do usuário com função de segurança para mapeamento de privilégios

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais