Criar um filtro interativo de campo de referência

Um filtro interativo de campo de referência permite que os usuários filtrem widgets de relatório com base no valor de um campo de referência.

Antes de Iniciar

Função necessária: hp_publisher_admin e report_admin. A função hp_publisher_admin existe somente para gerenciar filtros interativos. Por padrão, ele não contém outras funções e não está contido em nenhuma outra função.

Quando um usuário seleciona Todos, ele não vê um relatório com todas as opções de filtro aplicadas, ele vê o relatório não filtrado. Este exemplo de filtro de referência fornece opções de filtro do campo Grupo de atribuição na tabela Grupo [sys_user_group].

Nota:

Se o filtro interativo tiver um valor padrão ou especificar o último valor selecionado, os painéis não dinâmicos não vão aplicar esse valor automaticamente. Este recurso está disponível somente em Painéis dinâmicos.

Procedimento

1. Opcional: Verifique os filtros interativos existentes na mesma tabela.
   1. Navegar até Todos > Relatórios > Administração > Filtros interativos e selecione um filtro interativo com base na mesma tabela que você deseja filtrar.
   2. Em Links relacionados, selecione Outros filtros na Tabela.
   3. Revise os outros filtros que estão disponíveis na mesma tabela para ver se o filtro desejado já existe.
2. Navegar até Todos > Relatórios > Administração > Filtros interativos.
3. Clique em Nova.
4. Na lista Filtrar com base em, selecione Referência.
   
   
5. Na lista Tabela de referência, selecione a tabela que armazena os registros referenciados que você deseja filtrar.
6. Opcional: Selecione um Valor padrão para o filtro.
   Este padrão é aplicado automaticamente a todos os usuários. Os valores que um usuário seleciona substituem o padrão global para esse usuário. É possível especificar mais de um valor padrão ao usar um tipo de controle de IU que permite várias seleções, como Selecionar entrada múltipla.

   Nota:

   Para passar mais de 50 valores padrão ou se você vir o erro Isso está excedendo a limitação da chamada GET, crie vários filtros interativos.
7. Defina os seguintes campos:

   Nome	Descrição
   Nome	Insira um nome para o filtro. Este nome aparece no widget do painel para o filtro.
   Pesquisar nome	Insira um nome de pesquisa para o filtro. Este nome aparece no menu Adicionar conteúdo para usuários que adicionam um filtro a um painel. Use este nome para ajudar a organizar seus filtros. Se um nome de pesquisa não for especificado, o valor de Nome vai ser usado.
   Descrição	Insira uma descrição do filtro.
   Tipo de controle da IU	Selecione como as opções de filtragem disponíveis para este filtro aparecem no widget do painel. Consulte Tipos de controle de IU de filtro interativo disponíveis.
   Mostrar somente resultados de pesquisa que começam com palavra-chave	Quando selecionadas, as pesquisas retornam somente os resultados que começam com o termo de pesquisa. Caso contrário, as pesquisas retornarão resultados que contêm o termo de pesquisa em qualquer lugar. Considere esta opção ao configurar um filtro de referência em uma tabela muito grande, por exemplo, uma com milhões de registros. Uma pesquisa em um termo comum pode retornar muitos registros a serem gerenciados.

8. Opcional: Selecione Aplicar filtro às exibições e tabelas do banco de dados para aplicar o filtro aos widgets com base nas exibições e tabelas do banco de dados.
   Nota:

   Não é possível aplicar filtros a tabelas que estendem as tabelas de exibição do banco de dados. Para obter mais informações, consulte Filtros interativos em exibições de banco de dados e hierarquias de tabelas.
9. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
10. Opcional: Se o tipo de controle de IU for Selecionar entrada única, selecione a opção Remover tudo para configurar o filtro interativo sem a opção Todos.
    Quando um usuário seleciona Todos, ele não vê um relatório com todas as opções de filtro aplicadas, ele vê o relatório não filtrado.
11. Na lista relacionada Referências de filtro interativo, selecione Novo.
    Esta lista relacionada não aparece até que você salve o filtro.
12. No campo Tabela de referência, selecione uma tabela que tenha relatórios que você deseja filtrar.
13. Selecione o campo Referência para filtrar.

    O campo deve fazer referência à tabela especificada no campo Tabela de referência do filtro primário.

    Você pode fazer referência com pontos a partir de campos que fazem referência a outras tabelas. Por exemplo, se a tabela de referência do filtro primário for Departamento [cmn_department], você poderá selecionar Incidente como a tabelade referência de referência e, em seguida, selecionar Departamento do solicitante como o campo de referência.

    Nota:

    Os filtros interativos de referência não são compatíveis com campos de cadeia de caracteres.
14. Opcional: Adicione uma condição de lista relacionada.
    Você pode adicionar uma condição ao seu filtro com base nos registros em uma tabela relacionada.
    1. Clique no link rotulado como Maior ou Igual a 1.
       Na lista, selecione o número de registros na tabela de origem que devem estar relacionados a um registro na tabela de destino.

       As opções são:

       • Maior ou Igual a
       • Maior que
       • Menor ou igual a
       • Menos de
       • Igual a
       • Nenhum(a)
       • Entre

       

    2. Escolha a tabela relacionada.
    3. Especifique as condições nessa tabela que devem ser atendidas para que o filtro seja válido.
15. Clique em Enviar.

O que Fazer Depois

Repita as etapas 10 a 13 conforme necessário para cada campo de referência que você deseja filtrar. Depois de criar o filtro, adicione-o a um painel.

Nota:

Um filtro pode ser convertido do tipo de controle Caixas de seleção para o tipo de controle Selecionar várias entradas por motivos de desempenho.

Referência relacionada

• Tipos de filtros interativos disponíveis

Tópicos relacionados

• Tipo de campo de referência
• Condições para adicionar lista relacionada