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 .

Esta tabela lista os operadores compatíveis com cada tipo de campo compatível com filtros JavaScript. Os tipos de campo que não estão nesta tabela não são compatíveis com filtros JavaScript e o. Valor o campo no construtor de condições para esses tipos de campo não tem a opção de colar suas próprias declarações.

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 (simples)	"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 (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.

Procedimento

1. Navegar até Tudo > Análise da plataforma > Biblioteca > Visualizações de dados.
2. Abra a visualização de dados à qual você deseja adicionar o filtro dinâmico e selecione Editar .
3. Em Configuração selecione a fonte de dados que você deseja filtrar.
4. Na seção Filtros, 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.
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_Statement>; .
   • Para uma instrução JavaScript que chama uma inclusão de script, use o formato javascript:new <Record_Name>().<Function_Name>(); em que Nome_do_registro 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("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.