Criar uma opção de filtro dinâmico

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • 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âmica.

    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 sejam reutilizadas em vários construtores de condição e qualificadores de referênciadinâmicos. Esse tipo de filtro permite que você modifique um script uma vez e faça com que as mudanças tenham efeito automaticamente em todos os lugares em que a opção de filtro dinâmico é usada.

    Ao definir um filtro dinâmico, você pode:
    • usar uma opção de filtro dinâmico é (dinâmico) existente (somente construtor de condições)
    • 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ções 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 pré-existente Me está sendo usada. Para obter uma lista de opções de filtro dinâmico do construtor de condições pré-existentes disponíveis, consulte Operadores dinâmicos.
    Nota:
    Os filtros dinâmicos não são compatíveis com aplicações com escopo ou condições da Política de IU.
    Figura 1. Operandos dinâmicos
    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 inclusão de script/chamada de regra de negócio 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ócio que você criou para o filtro com script. Se o campo Script contiver JavaScript, uma consulta codificada ou toda a referência de regra de negócio/inclusão de script, este campo poderá estar vazio.
      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 de 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âmica.
      Nota:
      Os filtros dinâmicos que usam métodos GET da API da tabela em scripts funcionam somente quando o mesmo usuário configurado no perfil de autenticação básica é usado. Para permitir que vários usuários acessem os filtros dinâmicos, use as APIs JavaScript globais, como as APIs GlideRecord e GlideQuery.
    5. Clique em Enviar.