Ir para o conteúdo

Como Configurar um Filtro Predefinido

No Vinyl você pode configurar um painel Grid para carregar com um valor de filtro predefinido. O filtro pode ser facilmente limpo pelo usuário, se desejar, para ver todos os resultados (não apenas o conjunto filtrado). Este artigo orientará você sobre como configurar um filtro predefinido.

Em termos de onde você irá configurar o filtro predefinido, ele pode ser configurado em qualquer controle que possa atuar como um link. Você pode configurar o filtro em um controle Button que existe em uma página Parâmetro. Alternativamente, você pode configurá-lo no Menu do Site usando um Objeto de Menu do Site.

Exemplo de Caso de Uso Comercial

Para ilustrar esse conceito, considere o cenário de caso de uso de negócios em que você tem um painel Contas e gostaria que os registros carregados inicialmente exibissem apenas aqueles no Status Qualificado ou Lead. Sem o filtro predefinido instalado, o painel está atualmente carregando todos os registros incluindo os do Status Fechado Perdido e Fechado Ganho.

presetfilter.png

Painel de contas com filtro predefinido

allstatus.png

Painel de contas sem filtro predefinido configurado

Para Configurar um Filtro Predefinido Acionado por Controle de Botão

Neste cenário, configuraremos um filtro predefinido usando o controle Button residente em uma página Parâmetro. Esta configuração pressupõe que você tenha uma tabela de parâmetros instalada, com colunas referentes ao StatusID valores que você deseja usar como filtros. Também presumimos que você tenha uma Regra de Negócios definida, que representa um Objeto de Negócios construído a partir da tabela de Parâmetros e contém o StatusID valores nele que você deseja representar pelo filtro.

  1. Navegue em seu aplicativo até a área a partir da qual você definirá o filtro predefinido. Por exemplo: página de parâmetros
  2. Vá para Gaveta de Ação > Live Designer
  3. Selecione o controle no painel que você deseja filtrar
  4. Clique na aba Botão
  5. Expanda Navegação e Ações
  6. Defina o valor Link para página
  7. Clique no botão Critérios de link
  8. Clique em + Critérios
  9. Defina a Coluna de Origem como StatusID1 e a Coluna de destino como {{PanelName}}.$f.in.StatusID.0
  10. Deixe o valor Type como Bind
  11. Clique no ícone marca de seleção para salvar
  12. Clique em Criar
  13. Defina a Coluna de Origem como StatusID2 e a Coluna de destino como {{PanelName}}.$f.in.StatusID.1
  14. Deixe o valor Type como Bind
  15. Clique no ícone marca de seleção para salvar
  16. Retorne à visualização da aplicação e teste se o botão agora leva o usuário ao painel apropriado com o filtro predefinido sendo aplicado

Para Configurar um Filtro Predefinido Orientado pelo Objeto de Menu do Site

Se você deseja que uma página fora do menu do site do aplicativo seja carregada com o filtro predefinido aplicado, você pode configurar o filtro predefinido usando um objeto de menu do site. Por exemplo, gostaríamos que o painel Contas fosse carregado em um estado filtrado quando o usuário clicasse em Contas no menu do site do aplicativo.

Esta configuração pressupõe que você tenha uma tabela de parâmetros instalada, com colunas referentes ao StatusID valores que você deseja usar como filtros. Também presumimos que você tenha uma Regra de Negócios definida, que representa um Objeto de Negócios construído a partir da tabela de Parâmetros e contém o StatusID valores nele que você deseja representar pelo filtro.

paramcolumnexamples.png

Tabela de parâmetros ilustrando as colunas definidas para representar Qualified e Lead StatusID

  1. Navegue até App Workbench > Menu
  2. Clique em Abrir registro para acessar o menu do aplicativo
  3. Clique em Editar
  4. Defina o valor Regra de Origem para a Regra de Negócios configurada que contém os valores de filtro definidos
  5. Clique em Salvar
  6. Clique em x para sair do painel Menu
  7. Localize o valor de navegação que deseja configurar no painel Itens de Menu. Por exemplo: contas
  8. Clique em Abrir registro
  9. Clique em Opções de link
  10. Clique no ícone Critérios de link
  11. Clique em Criar

  12. Defina a Coluna de Origem como StatusID1 e a Coluna de destino como {{PanelName}}.$f.in.StatusID.0.

    Por exemplo:

    • Coluna de origem = LeadStatusID
    • Coluna de destino = Accounts.$f.in.AccountStatusID.1

  13. Deixe o valor Type como Bind

  14. Clique no ícone marca de seleção para salvar
  15. Clique em Criar
  16. Defina Coluna de Origem como StatusID2 e a Coluna de destino como {{PanelName}}.$f.in.StatusID.1
  17. Deixe o valor Type como Bind
  18. Clique no ícone marca de seleção para salvar
  19. Clique em x para sair da tela Critérios do link de controle
  20. Retorne à visualização do aplicativo, atualize o navegador da web e teste