---
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


---

# Crie um campo de função

# Crie um campo 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) 2 min. de leitura

Crie um campo de função para poder agrupar e empilhar um relatório pelos resultados do cálculo do campo.

## Antes de Iniciar

Função necessária: administrador, function_field_admin

Cada campo de função requer um rótulo, um tipo de retorno e uma definição. A definição consiste na operação e em um ou mais campos nos quais a operação é executada.  
Nota:  
Não é possível mudar o rótulo ou o tipo de retorno depois de salvar um campo de função. Se necessário, desative o campo de função e comece novamente.

## 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é TudoRelatóriosCriar novo.
   * Em uma nova instância ou uma que foi totalmente migrada para Análise da plataforma, navegue até TudoAdministração de Análise da plataformaUso e governançaRelatórios e selecione Novo .
   {#create-function-field__choices_wjj_z4z_42c}
2. Selecione o relatório ao qual você deseja adicionar um campo de função.  
   Quando você configura um campo de função em uma tabela, ele está disponível em qualquer lugar em que você use a tabela no Now Platform, incluindo qualquer relatório na mesma tabela. Por exemplo, um campo de função que calcula a idade dos incidentes em aberto está disponível para todos os relatórios na tabela de incidentes.
3. Abra o. Configurar e clique em Campo de função de configuração .
4. **Opcional:** Insira o nome do campo na barra de pesquisa para ver se alguém já criou o campo de função.  
   Aponte para os resultados da pesquisa para ver a definição da função.
5. Clique em Criar.  
   Pode haver no máximo 20 campos de função ativos na tabela na qual o relatório se baseia. Se a tabela já tiver 20 campos de função, um criador de um dos campos ou um platform_admin deve desativar ou excluir um.
6. Especifique o. Rótulo .  
   O rótulo é o nome que os usuários podem ver quando agrupam ou empilham dados em um relatório.
7. Selecione Tipo de retorno .  
   O tipo de retorno é o tipo de informação que a função produz. Por exemplo, o. `datediff() `A função retorna um tipo de duração porque calcula a duração entre duas datas.  
   Nota:  
   Você não verá uma mensagem se o tipo de retorno não for um resultado lógico da função.
8. Selecione a operação.  
   . Sintaxe a caixa de texto mostra o nome da função precedida por `glidefunction: `.

9. Selecione os campos nos quais a função opera.  
   Algumas funções exigem apenas um campo; algumas exigem dois ou três campos. Consulte [Relatório sobre campos de função](https://servicenow-prod.fluidtopics.net/XyeJonUrMgP7sDshoBzpMw "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."). Separe os campos com vírgulas.
10. Quando a sintaxe estiver correta, você poderá salvar o campo de função.  
    Quando a sintaxe estiver incorreta, você verá a mensagem: Erro de sintaxe: Expressão inválida . Você também pode ver outras mensagens.

{#create-function-field__steps_rdv_l2t_fnb}

## Resultado

Os campos de função configurados aparecem em Agrupar por e. Agrupar adicional por listas depois que você salva o relatório.
Use o campo de função criado na configuração do relatório. Para obter informações sobre como usar campos de função em outro lugar no Now Platform, consulte [Campo de função](https://www.servicenow.com/docs/access?context=platform-support-functions&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).