Criar uma opção de filtro dinâmico

As opções de filtro dinâmico aprimoram a filtragem, permitindo que os usuários executem inclusões de script existentes ou JavaScript em um campo de referência em construtores de condição e qualificadores de referência dinâmicos.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Esta tarefa descreve como criar uma nova opção de filtro dinâmico e uma inclusão de scriptassociada.

As opções de filtro dinâmico "objetivam" inclusões de script/JavaScript, permitindo que elas sejam reutilizadas em vários construtores de condição e qualificadores de referênciadinâmicos. Este tipo de filtro permite que você modifique um script uma vez e faça com que as mudanças entrem em vigor automaticamente em todos os lugares em que a opção de filtro dinâmico for usada.

Ao definir um filtro dinâmico, você pode:

• usar uma opção de filtro dinâmico é (dinâmico) existente (somente construtor de condição)
• usar uma opção de filtro dinâmico existente (OOB ou personalizado)
• criar uma nova opção de filtro dinâmico e inclusão de script/JavaScript

Todos os filtros dinâmicos do construtor de condição usam o operador is (dynamic) e chamam uma opção de filtro dinâmico. No exemplo a seguir, a opção de filtro dinâmico preexistente Me está sendo usada. Para obter uma lista de opções de filtro dinâmico do construtor de condições preexistentes disponíveis, consulte Operadores dinâmicos.

Nota:

Filtros dinâmicos não são compatíveis com aplicações com escopo ou condições de política de IU.

Figura 1. Operandos dinâmicos

Procedimento

1. Crie um filtro com script como uma inclusão de script de cliente chamável ou regra de negócio.
2. Navegar até Definição do Sistema > Opções de Filtro Dinâmico.
3. Clique em Nova.
4. Preencha o formulário.

   Tabela 1. Opções de filtro dinâmico

   Campo	Descrição
   Rótulo	Insira um nome descritivo para a opção de filtro dinâmico.
   Script	Insira o nome da função que você criou, JavaScript (nenhuma inclusão de script necessária) ou a chamada de regra de negócios/inclusão de script completa, como new GlobalCanvasUtil().refQualPaTabs().
   Tipo de campo	Selecione Referência.
   Tabela referenciada	Selecione a tabela à qual esta opção de filtro dinâmico se aplica.
   Ordem	Insira um número para designar o posicionamento desta opção de filtro dinâmico na lista de seleção de opções de filtro.
   Funções	Selecione a função que um usuário deve ter para ver esta opção.
   Ativo	Habilite ou desabilite a opção.
   Script de referência	Opcional. Selecione a inclusão de script de cliente chamável ou a regra de negócios que você criou para o filtro com script. Se o campo Script contiver JavaScript, uma consulta codificada ou a inclusão de script/referência de regra de negócios, esse campo poderá ficar em branco.
   Disponível para filtro	Selecione esta opção para exibir a opção de filtro dinâmico como uma trilha de filtro.
   Disponível como padrão	Selecione esta opção para permitir que a opção de filtro dinâmico seja um padrão em uma entrada do dicionário.
   Disponível como qualificador de referência	Selecione esta opção para permitir que a opção de filtro dinâmico seja selecionada como um qualificador de referência dinâmico.

   Nota:

   Os filtros dinâmicos que usam métodos GET da API da tabela em scripts funcionam somente ao usar o mesmo usuário configurado no perfil de autenticação básica. Para permitir que vários usuários acessem os filtros dinâmicos, use APIs JavaScript globais, como APIs GlideRecord e GlideQuery.
5. Clique em Enviar.

Tarefas relacionadas

• Criar e editar filtros
• Excluir filtros
• Criar filtros com script