Filtros JavaScript dinâmicos

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura

    • Crie condições dinâmicas em JavaScript que você pode configurar como parte dos critérios de visualização de um relatório em vez de valores especificados.

    Para criar um relatório usando uma declaração condicional dinâmica, você coloca um URL JavaScript na declaração de valor condicional do filtro. Você pode inserir um comando JavaScript diretamente no campo, mas para um script com mais de uma declaração, o script deve ser colocado em seu próprio registro. Em seguida, você chama uma função desse registro no campo de valor da condição de relatório.

    Adicionar um filtro JavaScript dinâmico

    Adicione uma instrução JavaScript dinâmica para avaliação como parte dos critérios de filtro de uma visualização de relatório.

    Antes de Iniciar

    Função necessária: itil, report_user, report_group, report_global, report_admin ou admin. Para criar um relatório significativo, você deve ter o direito de acessar os dados sobre os quais deseja relatar.

    Por Que e Quando Desempenhar Esta Tarefa

    Os filtros JavaScript podem ser declarações de linha única ou scripts mais longos. Para instruções JavaScript mais longas, crie uma inclusão de script que retorne o formato e o tipo de dados corretos, esteja em conformidade com os dados específicos que o relatório deve filtrar e seja chamável pelo cliente. Para obter mais informações, consulte Inclusões de script.

    Procedimento

    1. Navegar até Todos > Relatórios > Exibir/Executar.
    2. Abra a visualização de relatório à qual você deseja adicionar o filtro dinâmico.
    3. Selecione o ícone de filtro () para expandir o construtor de condições.
    4. Construa sua condição de filtro.
      Essas combinações de tipos de campo e operadores permitem especificar uma instrução JavaScript dinâmica.
      Nota:
      • O operador "entre" fornece dois campos que podem oferecer suporte a URLs JavaScript iguais ou diferentes.
      • O operador "is" pode retornar uma matriz de elementos de dados do tipo esperado. Nesse caso, o operador é tratado como o operador "é um de".
      Tipo de campo Operadores permitidos Tipo de dados de retorno esperado
      ID do Sistema (GUID) "é", "não é", "é um de", "começa com", "termina com", "contém", "não contém", "entre", "maior que ou é", "menor que ou é". Representação textual de um valor de sys_id completo ou parcial.

      Para o operador "é um de", o tipo de retorno esperado seria uma lista delimitada por vírgulas de valores de sys_id ou uma matriz contendo cada sys_id que deve ser incluído nos resultados.
      Cadeia de caracteres de texto livre "é", "não é", "é um de", "começa com", "termina com", "contém", "não contém", "entre", "maior que ou é", "menor que ou é" Um ou mais caracteres textuais. Para o operador "é um de", o resultado esperado seria uma lista delimitada por vírgulas de valores de cadeia de caracteres ou uma matriz que contém cada um dos valores a serem incluídos no campo de valor de pesquisa "é um de".
      Referência "começa com", "termina com", "contém", "não contém" Um ou mais caracteres textuais que podem representar algum valor ou parte de um valor encontrado neste campo na tabela ou fonte de dados.
      Cadeia de caracteres (referenciando outra tabela) "contém", "começa com", "termina com", "não contém" Um ou mais caracteres textuais que podem representar algum valor ou parte de um valor encontrado neste campo na tabela ou fonte de dados.
      Entrada do usuário "é", "não é" Caracteres textuais que podem representar o valor completo de algum registro para este campo na tabela ou fonte de dados.
      Nome da tabela "é", "não é", "é um de", "começa com", "termina com", "contém", "não contém", "entre", "maior que ou é", "menor que ou é" Representação textual de um nome de tabela completo ou parcial no sistema. Para o operador "é um de", o tipo de retorno esperado seria uma lista delimitada por vírgulas de valores de Nome de tabela ou uma matriz contendo cada Nome de tabela que deve ser incluído nos resultados.
      Valor do Modelo "é", "não é" Caracteres textuais que atenderão ao valor de acordo com um modelo encontrado na instância.
      ID do Domínio "começa com", "termina com", "contém", "não contém" Um ou mais caracteres textuais que podem representar algum valor ou parte de um valor encontrado no campo de domínio na tabela ou fonte de dados.
      Funções de usuário "é", "não é" Representação textual de um valor de cadeia de caracteres de função do usuário.
      Caminho de domínio "começa com", "termina com", "contém", "não contém", "é", "não é", "é um de", "menor que ou é", "maior que ou é", " entre" Um ou mais caracteres textuais que podem representar algum valor ou parte de um valor encontrado neste campo na tabela ou fonte de dados. Para o operador "é um de", uma lista delimitada por vírgulas de valores textuais ou um objeto de matriz que contém cada valor que deve ser incluído.
      Texto Traduzido "é", "não é", "é um de", "começa com", "termina com", "contém", "não contém", "entre", "maior que ou é", "menor que ou é" Valor textual.

      Para o operador "é um de", o tipo de retorno esperado seria uma lista delimitada por vírgulas de valores textuais ou uma matriz de valores textuais.
      Campo Traduzido
      HTML "contém", "não contém" Valor textual que pode corresponder aos dados no campo selecionado nestes critérios de relatório.
      Modelo HTML
      Script de E-mail "contém", "não contém" Valor textual que representa um valor que deve (ou não) estar no campo Script de e-mail.
      Script (Texto sem Formatação) "contém", "não contém" Valor textual que representa um valor que deve (ou não) estar no campo Script.
      Script (lado do servidor)
      Script
      Nome Curto da Tabela "é", "não é" Valor textual (menos de 40 caracteres).

      Para o operador "é um de", o tipo de retorno esperado é uma lista delimitada por vírgulas de valores textuais ou uma matriz que contém cada caractere textual que representa um nome de tabela curto.
      Nome do Campo "é", "não é", "é um de", "começa com", "termina com", "contém", "não contém", "entre", "maior que ou é", "menor que ou é" Representação textual de um valor de nome de campo completo ou parcial.

      Para o operador "é um de", o tipo de retorno esperado seria uma lista delimitada por vírgulas de valores de nome de campo ou uma matriz que contém cada nome de campo que deve ser incluído nos resultados.
    5. Escolha um tipo de campo e operador e insira uma instrução JavaScript.
      • Para uma instrução JavaScript de uma linha, use o formato javascript:<JavaScript_Statement> ; .
      • Para uma instrução JavaScript que chama uma inclusão de script, use o formato javascript:new <Record_Name> ().<Function_Name> (); em que Record_Name corresponde ao nome do registro da inclusão de script e Function_Name é a função na inclusão de script que retorna o valor comparado no filtro.
      Nota:
      O URL Javascript também pode incluir um ou mais parâmetros passados para a função que executa o cálculo e retorna um resultado. Por exemplo, uma função JavaScript que passa dois parâmetros para o registro de inclusão de script pode ser gravada como javascript:new TextJSFilter().getGroupIDs("Professional Services","Sales");.

    O que Fazer Depois

    Depois de adicionar as declarações e condições JavaScript necessárias e configurar o restante do relatório, teste o relatório para garantir que ele retorne e exiba os resultados esperados.