Relatório sobre campos de função

Enquanto os campos regulares armazenam um valor no banco de dados, um campo de função exibe os resultados de uma consulta de banco de dados. O campo Função gera o valor com base nos cálculos de outros campos e constantes. Você pode usar esses campos em relatórios e visualizações de dados como faria com outros campos.

A responsabilidade por criar, editar e desativar campos de função pertence ao usuário com a função function_field_admin. No upgrade, nenhum usuário tem esta função. Um administrador deve atribuir esta função a um usuário não administrador. Consulte Crie uma função .

Saiba mais sobre os campos de função aqui: Campo de função .

Operações de campo de função

Os campos de função podem executar as seguintes operações usando glidefunction:<operation> sintaxe.

Nota:

Especifique constantes entre aspas simples ou duplas. Os exemplos para concat() , diaofweek() , posição() e. substring() as operações mostram o uso de constantes nos campos de função.

Tabela 1. Operações de campo de funçãoA tabela de operações do campo de função contém colunas para os nomes das operações do campo de função, uma descrição detalhada do que a operação faz e um exemplo que inclui o código e o que o código retorna.

Operação	Descrição	Exemplo
add()	Usa dois campos numéricos como entrada, adiciona-os e retorna os resultados como o valor do campo. Esta função também usa valores numéricos para qualquer uma das entradas. Coloque valores numéricos entre aspas simples ou duplas.	glidefunction:add(child_incidents, parent_incident) Retorna 6 se o incidente tiver cinco incidentes secundários e um incidente primário. Possíveis tipos de retorno: Decimal, número de ponto flutuante, número inteiro grande, número inteiro
subtract()	Usa dois campos numéricos como entrada, subtrai o segundo do primeiro e retorna o resultado como o valor do campo. Esta função também usa valores numéricos para qualquer uma das entradas. Coloque valores numéricos entre aspas simples ou duplas.	glidefunction:subtrair(u_num1, u_num2) Retorna 2 se num1 for igual a 8 e num_2 for igual a 6. Possíveis tipos de retorno: Decimal, número de ponto flutuante, número inteiro grande, número inteiro
multiplicar()	Usa dois campos numéricos como entrada, executa a multiplicação e retorna os resultados como um valor de campo. Esta função também usa valores numéricos para qualquer uma das entradas. Coloque valores numéricos entre aspas simples ou duplas.	glidefunction:multiplicar(u_num1, u_num2) Retorna 48 se num1 for igual a 8 e num_2 for igual a 6. Possíveis tipos de retorno: Decimal, número de ponto flutuante, número inteiro grande, número inteiro
dividir()	Usa dois campos numéricos como entrada, divide o primeiro pelo segundo e retorna os resultados como o valor do campo. Esta função também usa valores numéricos para qualquer uma das entradas. Coloque valores numéricos entre aspas simples ou duplas.	glidefunction:dividir(u_num2,u_num1) Retorna 5 se num2 for igual a 10 e num1 for igual a 2. Possíveis tipos de retorno: Decimal, número de ponto flutuante, número inteiro grande, número inteiro
concat()	Usa qualquer número de constantes e campos separados por vírgula como entrada, concatena a entrada e retorna apenas uma cadeia de caracteres como um valor de campo.	glidefunction:concat(incident_number, '/', short_description) Retorna "INC0001 / Meu cliente precisa de um novo laptop." Se o valor do campo numérico for "INC0001" e short_description for "Meu cliente precisa de um novo laptop". Tipo de retorno: Texto
datediff()	Usa dois campos de data/hora como entrada, calcula a diferença entre as datas em dias, minutos e segundos e retorna os resultados como o valor do campo de duração.	glidefunction:datediff(closed_at, sys_created_on) Retorna a duração de um incidente desde a data de criação até a data de fechamento. Resultado de exemplo: 10 dias, 8 horas, 23 minutos e 11 segundos Tipo de retorno: Duração
diadesemana()	Usa dois argumentos: Um campo de data e uma constante de qualquer um "1" (A semana começa no domingo) ou "2" (A semana começa na segunda-feira). Retorna os resultados como um valor inteiro que representa o dia da semana. . diadesemana() A função usa datas UTC, mas ajusta os valores de comparação com base no fuso horário da instância.	glidefunction:dayofweek(resolved_at, '1') . Se resolved_at ocorrer em uma quarta-feira, retornará 4 se o número inteiro for 1 e retornará 3 se o número inteiro for 2. Tipo de retorno: Número inteiro
comprimento ()	Usa um campo de cadeia de caracteres como entrada, calcula o tamanho do campo em caracteres e retorna os resultados como um valor de campo.	glidefunction:length(short_description) Retorna 37 se short_description for "Esta aplicação está realizando um teste". Tipo de retorno: Número inteiro
aglutinar()	Usa qualquer número de campos separados por vírgulas como entrada e retorna o primeiro valor não vazio.	glidefunction:aglutinar(closed_at, resolved_at, sys_updated_on) Se o valor de closed_at estiver vazio, a função retornará o valor de resolved_at. Se o valor de resolved_at também estiver vazio, a função retornará o valor de sys_updated_on. Tipo de retorno: Texto
posição()	Usa dois campos de texto ou dois campos de texto e um número inteiro como entrada. Um ou ambos os campos de texto também podem ser cadeias de caracteres. Retorna a posição da primeira ocorrência da cadeia de caracteres do primeiro campo de texto no segundo. Se um número inteiro for especificado, esta função retornará a posição do segundo campo de texto após a posição do número inteiro. Retorna 0 se o primeiro campo de texto não estiver presente no segundo (após a posição do número inteiro, se especificado).	glidefunction:position('e',short_description) Se o valor do campo short_description for "Este computador está executando um upgrade", retornará 12. glidefunction:position('e',short_description,'14') Se o valor do campo short_description for "Este computador está executando um upgrade", retornará 19. Tipo de retorno: Número inteiro
substring()	Usa um campo de texto e dois números inteiros como entrada. Retorna a primeira instância de uma cadeia de caracteres que começa na posição do primeiro número inteiro e é o comprimento do segundo.	glidefunction:substring(short_description, '7', '2') Se o valor do campo short_description for "Vamos para a loja", retornará "GO". Tipo de retorno: Texto

• Configurando campos de função
  Você pode configurar até 20 campos de função ativos por tabela usando o Designer de relatórios. Ao configurar um campo de função em uma tabela, você pode agrupar ou empilhar pelos resultados do cálculo da função.
• Crie um campo de função
  Crie um campo de função para poder agrupar e empilhar um relatório pelos resultados do cálculo do campo.
• Edite um campo de função
  O usuário que criou um campo de função ou um usuário com a função admin ou function_field_admin pode editar a definição de um campo de função salvo. Não é possível editar o rótulo ou o tipo de retorno de um campo de função salvo.
• Desative um campo de função
  O usuário que criou um campo de função ou um usuário com a função de administrador pode desativá-lo. Se uma tabela já tiver 20 campos de função, você deverá desativar um ou mais campos existentes antes de criar outro.
• Exclua um campo de função
  Um usuário com a função de administrador pode excluir um campo de função de sua tabela. A exclusão de um campo de função é útil se você quiser criar um campo de função com o mesmo nome que existe nessa tabela.
• Desabilite a criação do campo de função
  Configure uma propriedade do sistema para remover a capacidade de criar campos de função no Designer de relatórios.