--- sourceDocument: Yokohama Platform Analytics sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/now-intelligence Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Platform Analytics ft:clusterId : - par bundleId : - par workflow : - Platform --- # Relatório sobre campos de função # Relatório sobre campos de função {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura 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 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](https://www.servicenow.com/docs/access?context=t_CreateARole&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Saiba mais sobre os campos de função aqui: [Campo de função](https://www.servicenow.com/docs/access?context=platform-support-functions&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). ## Operações de campo de função {#function-fields-reporting__section_nym_1f2_tmb} Os campos de função podem executar as seguintes operações usando glidefunction:\ 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. {#function-fields-reporting__table_mdb_1zs_dbb__entry__3}{#function-fields-reporting__add-func-ex}{#function-fields-reporting__sub-func-ex}{#function-fields-reporting__mult-func-ex}{#function-fields-reporting__div-func-ex}{#function-fields-reporting__concat-func-ex}{#function-fields-reporting__datediff-func-ex}{#function-fields-reporting__dayofweek-func-ex}{#function-fields-reporting__length-func-ex}{#function-fields-reporting__coal-func-ex}{#function-fields-reporting__pos-func-ex}{#function-fields-reporting__subs-func-ex} | 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 o 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 | | diaofweek() | 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. . diaofweek() 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. 1. Retorna a posição da primeira ocorrência da cadeia de caracteres do primeiro campo de texto no segundo. 2. 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. {#function-fields-reporting__ol_gqd_rvh_2nb} 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. {#function-fields-reporting__ol_kjd_2g5_dnb} 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 | [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.] {#function-fields-reporting__table_mdb_1zs_dbb} * **[Configurando campos de função](https://servicenow-prod.fluidtopics.net/430cTPxRFD~k_U7YjS3IaQ)** Você pode configurar até 20 campos de função ativos por tabela para uso na emissão de relatórios 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.