Filtros JavaScript dinâmicos

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

Para criar um relatório usando uma declaração condicional dinâmica, coloque uma 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 instrução, o script deve ser colocado em seu próprio registro. Em seguida, você chama uma função desse registro no campo Valor da condição do relatório.

Adicione um filtro JavaScript dinâmico

Adicione uma declaraçã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 administrador. 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 instruçõ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. Execute uma das seguintes ações:
   • Em uma instância atualizada que não foi totalmente migrada para Análise da plataforma, navegue até Tudo > Relatórios > Exibir/Executar.
   • Em uma nova instância ou uma que foi totalmente migrada para Análise da plataforma, navegue até Tudo > Administração de Análise da plataforma > Uso e governança > Relatórios.
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. Crie sua condição de filtro.
   Essas combinações de tipos de campo e operadores permitem que você especifique uma instrução JavaScript dinâmica.

   Nota:

   • O operador "Entre" fornece dois campos que podem oferecer suporte aos mesmos URLs JavaScript ou a URLs diferentes.
   • O operador "is" pode retornar uma matriz de elementos de dados do tipo esperado. Neste caso, o operador é tratado como o operador "é um de".
   • Os campos de lista não são compatíveis com filtros JavaScript dinâmicos.

   Tipo de campo	Operadores permitidos	Tipo de dados de retorno esperado
   SYS ID (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 sys_id completo ou parcial. Para o operador "É um de", o tipo de retorno esperado seria uma lista delimitada por vírgulas de valores 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 contendo 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 total 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 preencherão o 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 contendo 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 deve) 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 deve) estar no campo Script.
   Script (lado do servidor)
   Script
   Nome Curto da Tabela	"é", "não é"	Valor textual (com 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 representaria um nome curto de tabela.
   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 contendo cada nome de campo que deve ser incluído nos resultados.
5. Escolha um tipo de campo e um 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 TextJSFilter().getGroupIDs("Serviços Profissionais","Vendas"); .

O que Fazer Depois

Depois de adicionar as instruçõ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.