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 ao banco de dados. O campo de função gera o valor com base em cálculos de outros campos e constantes. Você pode usar esses campos em relatórios como usaria outros campos.
A responsabilidade de 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 Criação de uma função.
Saiba mais sobre os campos de função aqui: Campo de função.
Operações de campo de função
| 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 os 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 primário. Tipos de retorno possíveis: 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 os valores numéricos entre aspas simples ou duplas. |
glidefunction:subtract(u_num1, u_num2) Retorna 2 se num1 = 8 e num_2 = 6. Tipos de retorno possíveis: 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 os valores numéricos entre aspas simples ou duplas. |
glidefunction:multiply(u_num1, u_num2) Retorna 48 se num1 = 8 e num_2 = 6. Tipos de retorno possíveis: 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 os valores numéricos entre aspas simples ou duplas. |
glidefunction:divide(u_num2,u_num1) Retorna 5 se num2 = 10 e num1 = 2. Tipos de retorno possíveis: Decimal, Número de ponto flutuante, Número inteiro grande, Número inteiro |
| concatenar () | 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 de número for "INC0001" e o short_description for "Meu cliente precisa de um novo laptop". Tipo de retorno: texto |
| datadiff() | 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 a partir da data de criação até a data de encerramento. Exemplo de resultado: 10 dias, 8 horas, 23 minutos e 11 segundos Tipo de retorno: duração |
| dia da semana () | Usa dois argumentos: um campo de data e uma constante de '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. A função dayofweek() 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 = "Esta aplicação está executando um teste". Tipo de retorno: número inteiro |
| aglutinar () | Usa qualquer número de campos separados por vírgula como entrada e retorna o primeiro valor não vazio. | glidefunction:coalesce(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 0 se o primeiro campo de texto não estiver presente no segundo (após a posição do número inteiro, se especificado). |
Tipo de retorno: número inteiro |
| subcadeia de caracteres () | 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 tem o comprimento do segundo. | glidefunction:substring(short_description, '7', '2') Se o valor do campo short_description for "Indo para a loja", retorna "ir". Tipo de retorno: texto |