Crie um campo de função

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 em que 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é Tudo > Relatórios > Criar novo.
      • Em uma nova instância ou uma que foi totalmente migrada para Análise da plataforma, navegue até Tudo > Administração de Análise da plataforma > Uso e governança > Relatórios e selecione Novo .
    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 ServiceNow AI 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 selecione 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.
      Passe o mouse sobre os resultados da pesquisa para ver a definição da função.
    5. Selecione 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 usuário com a função de administrador deverá 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: .

      Criar janela de campo de função com legendas para Rótulo, Tipo de retorno e Adicionar operação. A operação de subtração é realçada.

    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. Certifique-se de separar os campos com vírgulas.
    10. Quando a sintaxe estiver correta, você pode 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.

      Criar janela de campo de função com legendas para Adicionar campo e a mensagem Sintaxe está correta. O campo Incidentes secundários está realçado.

    Resultado

    Os campos de função configurados aparecem em Agrupar por e. Grupo adicional por listas depois que você salva o relatório.

    Use o campo de função criado em seu relatório ou configuração de visualização de dados. Para obter informações sobre como usar campos de função em outro lugar no ServiceNow AI Platform, consulte Campo de função .