Crie um indicador de fórmula

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura
  • Crie um indicador de fórmula para produzir uma nova pontuação calculada a partir de um ou mais indicadores. Além das pontuações do indicador, a fórmula pode incluir cálculos como a lacuna entre uma pontuação do indicador e a meta do indicador.

    Antes de Iniciar

    Função necessária: pa_power_user, pa_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    As fórmulas são frequentemente usadas para:
    • Calcule proporções e porcentagens.
    • Combine dados de diferentes aplicações.
    • Crie indicadores preditivos com base no desempenho histórico.

    Os campos de um indicador de fórmula são semelhantes aos campos de um indicador automatizado. No entanto, em vez de Origem, Condições adicionais e Propriedades de coleção, uma Declaração de fórmula é definida. As fórmulas podem consistir em outros indicadores, constantes, variáveis e séries temporais ou qualquer combinação desses elementos.

    Nota:
    • Você deve ter uma assinatura para Performance Analytics para criar indicadores.
    • Se você estiver usando separação de domínio, o indicador será criado no domínio em que você está atualmente.

    Procedimento

    1. Use um dos seguintes caminhos de navegação:
      • Se você estiver em uma instância atualizada que não migrou para Análise da plataforma, navegue até Tudo > Performance Analytics > Indicadores > Indicadores de Fórmula e selecione Novo .
      • Se você estiver em uma nova instância ou tiver migrado para Análise da plataforma, navegue até Tudo > Administração de Análise da plataforma > Indicadores > Indicadores de Fórmula e selecione Novo .
    2. Em Nome Dê ao indicador um nome descritivo, como duração média dos incidentes em aberto.
    3. Em Calendários selecione o calendário padrão ou um grupo de calendário comercial ou fiscal.
    4. Se você selecionou um calendário comercial ou fiscal, selecione a frequência do calendário.
      Pelo menos um indicador na fórmula deve corresponder à frequência de calendário especificada. A escolha das frequências do calendário depende da configuração das entradas do calendário comercial ou dos cronogramas do calendário fiscal.
      Por exemplo, o calendário gregoriano tem frequências de Trimestre, Mês, Semana e Ano. Se você estiver usando o calendário gregoriano, você deve escolher uma dessas frequências.
      Opções de frequência de calendário para o calendário gregoriano
    5. Se você preferir que a pontuação deste indicador aumente ou diminua ao longo do tempo, selecione Maximizar ou Minimizar em Direção campo.
      As ferramentas analíticas e exibições gráficas usam isso Direção com este indicador.
      Dica:
      Sempre que puder, defina uma direção. Todos os indicadores-chave devem ser definidos para maximizar ou minimizar.
      ValorCaso de uso
      Maximizar Selecione se um aumento nesta pontuação do indicador for desejado. Por exemplo, considere selecionar Maximizar para um indicador que mostra receita. As ferramentas analíticas e elementos gráficos refletem que um aumento na pontuação desse indicador é bom e uma diminuição é ruim.
      Minimizar Selecione se uma diminuição nesta pontuação do indicador for desejada. Por exemplo, considere selecionar Minimizar para um indicador que mostra custos. As ferramentas analíticas e elementos gráficos refletem que uma diminuição na pontuação desse indicador é boa e um aumento é ruim.
      Nenhum(a) Selecione se a direção da mudança nesta pontuação não for importante para o seu negócio.
    6. Defina a fórmula para este indicador.
      1. Para usar um valor calculado na fórmula, clique em Procure um método (Repetível).
        Uma caixa de diálogo é aberta para você inserir um método de FormulaUtils() na fórmula. Esta API retorna o valor calculado de um indicador. Para obter mais informações sobre como usar esta API, consulte Obtenha métodos de análise em fórmulas.
        Lista de rótulos descritivos de métodos na caixa de diálogo "Adicionar um método à fórmula", com Obter lacuna de meta global do indicador especificado em destaque.
      2. Para colocar a pontuação de um indicador na fórmula, clique em Procure um indicador Link e preencha a caixa de diálogo (repetível).
        Tabela 1. Caixa de diálogo de seleção do indicador
        Campo Descrição
        Indicador O indicador que você está inserindo como um indicador de contribuição na fórmula.

        Se você usar um calendário comercial ou fiscal para este indicador, pelo menos um indicador na fórmula deve usar o calendário correspondente e a frequência do calendário.

        Detalhamento, elemento, detalhamento de segundo nível, elemento de segundo nível Até dois níveis de detalhamento e elemento para filtrar as pontuações no indicador. Se você especificar um detalhamento, deverá especificar um elemento desse detalhamento. Esses detalhamentos e elementos se aplicam somente a este indicador de contribuição e não ao indicador de fórmula como um todo.
        Série temporal Uma função analítica predefinida, como uma média de execução de 7 dias, a ser aplicada ao indicador em vez de mostrar as pontuações brutas do indicador. Esta série temporal se aplica somente a este indicador de contribuição e não ao indicador de fórmula como um todo.
        Permitir detalhamentos Aplica detalhamentos que se aplicam a todo o indicador de fórmula, em vez de indicadores individuais na fórmula, para aplicar a este indicador de contribuição. Habilitado por padrão. Para obter mais informações, consulte Evite que um indicador de contribuição em uma fórmula siga detalhamentos.

        Os detalhamentos são adicionados à fórmula inteira por meio de Gerencie detalhamentos caixa de diálogo, disponível depois que o indicador é salvo. Consulte a Etapa 11.

        Usar no método Retorna um identificador exclusivo em vez da pontuação deste indicador. Selecione esta caixa quando estiver especificando um indicador para um método na fórmula. Esses métodos obtêm valores calculados para o indicador do Hub de análise. Para obter mais informações sobre como usar esses métodos, consulte Obtenha métodos de análise em fórmulas.

        Você pode adicionar indicadores manualmente. No entanto, usando o. Procure um indicador , você garante que tem a notação adequada para indicadores e. elementos de detalhamento.

        Depois de salvar o indicador de fórmula, os indicadores na fórmula aparecem no Indicadores de contribuição lista relacionada. Se você incluiu indicadores de fórmula, os indicadores de contribuição também serão listados.
      3. Adicione operadores matemáticos e símbolos ao Fórmula conforme necessário.

        Insira operadores ou números a serem incluídos na fórmula. Use símbolos de operador válidos, como -, /, %, . Você também pode adicionar mais indicadores à fórmula. Por exemplo, para calcular a idade média dos incidentes em aberto com base na soma da idade dos incidentes em aberto e no número de incidentes em aberto, use a seguinte fórmula: [[soma da idade dos incidentes em aberto]] / [[Incidentes em aberto]] / 24

        Para especificar um período de coleta de dados na fórmula, você pode usar as variáveis score_start e. score_end para se referir ao início e ao fim do período de coleta de dados, respectivamente. No entanto, consulte as advertências em Mudanças em score_start/end devido a fusos horários diferentes do usuário.
        Aviso:
        Tente não usar GlideRecords ou GlideAggregates em scripts Performance Analytics ou indicadores de fórmula. Embora às vezes você precise usar essas operações para obter o que deseja, elas são caras e podem ser executadas centenas de milhares de vezes. Certifique-se de que não há alternativas antes de usá-las.
    7. Em Controle de acesso , defina se este indicador deve ser salvo na biblioteca e se deve ser limitado a visibilidade do indicador por usuário, grupo ou função.
    8. Em Outro definir propriedades diversas.
      Essas propriedades se aplicam a todo o indicador de fórmula.
      Tabela 2. Campos da guia "Outros"
      Campo Descrição
      Série temporal padrão Uma função analítica predefinida, como uma média de execução de 7 dias. Dependendo se Aplicar série temporal ao resultado esta série temporal pode ser aplicada a cada indicador de componente antes que o resultado seja calculado ou ao resultado.
      Perfil do grupo em tempo real

      Perfil de grupo em tempo real [live_group_profile] para um grupo de Feed em tempo real. Especifique um perfil de grupo para fazer com que esse grupo receba notificações sobre este indicador.

      Para obter mais informações sobre esta aplicação social no ServiceNow AI Platform, consulte Feed em tempo real .

      Ordem

      Número que indica a ordem em que os indicadores são exibidos no Hub de análise. Os indicadores com o valor mais baixo são exibidos na parte superior da lista. Se nenhum valor for fornecido no Pedido os indicadores são exibidos de a a z usando o. Nome campo. Para usar o campo Pedido, insira os números de pedido para todos os indicadores. Se você inserir números para apenas alguns indicadores, a ordem em que os indicadores são exibidos reverte para A a z.

      Não usado em Análise da plataforma experiência.

      Linhas contínuas de renderização

      Quando selecionado, o. Hub de análise e. Detalhes de KPI mostrar linhas de dados ininterruptas para este indicador, mesmo quando não houver dados para uma data específica. Esse comportamento pode ser útil ao exibir conjuntos de dados com datas de início variadas ou para dados que não são atualizados regularmente, como informações de estoque.

      As linhas contínuas não são renderizadas quando uma série temporal é definida no indicador ou no Hub de análise ou Detalhes de KPI.

      Aplicar série temporal ao resultado Aplica uma agregação de séries temporais ao resultado do cálculo da fórmula em vez de a cada indicador de componente antes que o resultado seja calculado. Esta opção se aplica a uma série temporal selecionada para o indicador em um widget ou no Hub de análise. Se uma série temporal padrão for especificada para o indicador, esta opção também se aplicará a essa série temporal. Para obter mais informações, consulte Aplicando séries temporais ao resultado ou aos indicadores de contribuição.
      Permitir que o componente da fórmula seja NULO Tem a fórmula calculada mesmo quando contém uma pontuação nula. Útil para solução de problemas. Para obter mais informações, consulte Detecte indicadores sem pontuações em uma fórmula.
      Permitir agregação de várias pontuações de elemento de detalhamento Permite que os widgets mostrem a soma da pontuação de vários elementos de detalhamento neste indicador. Se este campo estiver selecionado, você poderá selecionar valores agregados ou separados no formulário para um painel de detalhamento que usa este indicador. Fórmulas baseadas em adição, subtração ou multiplicação são geralmente boas candidatas para permitir agregação. As porcentagens também são compatíveis, desde que as porcentagens totalizem 100%. Por outro lado, os resultados da agregação de elementos em médias, ou de porcentagens que não estão relacionadas, geralmente não são significativos.
      Aviso:
      A validade matemática dessas agregações não é verificada.
    9. Opcional: Em Previsão , defina o método de previsão, o número de períodos de coleta de dados para prever, a quantidade de dados históricos nos quais basear a previsão e os limites superior e inferior dos valores de previsão.
      Para obter mais informações, consulte Previsões de pontuações da Performance Analytics.
    10. Expanda o menu de contexto e clique em Salvar .

      Opção Salvar no menu de contexto
    11. Para aplicar um detalhamento ao indicador de fórmula inteiro, clique em Gerencie detalhamentos na parte superior da página.
      Por padrão, você pode aplicar somente detalhamentos configurados para cada indicador de contribuição na fórmula.
      Nota:
      A propriedade do sistema com.snc.pa.formula_indicator_valid_breakdowncontrola este comportamento. Por padrão, é verdadeiro. Mudar para falso permite que você aplique um detalhamento a um indicador de fórmula quando pelo menos um indicador de contribuição usa esse detalhamento. Tentativas de exibir pontuações de detalhamentos incompatíveis em um widget, o. Hub de análise, ou Detalhes de KPI resultado em uma mensagem de aviso em vez de um valor.

      Não é possível selecionar um elemento de detalhamento no registro do indicador de fórmula. Você pode selecionar o detalhamento O detalhamento só pode ser usado interativamente, ou seja, no Hub de análise, Detalhes de KPI, widgets configurados adequadamente e painéis de detalhamento. Para obter informações sobre como usar o. Gerencie detalhamentos ferramenta, consulte Atribua e mapeie detalhamentos.

    Crescimento de backlog de incidentes

    Como gerente de incidentes, você deseja melhorar a eficiência da resolução de incidentes. Você já rastreia incidentes novos e resolvidos como os indicadores Número de novos incidentes e Número de incidentes resolvidos. No entanto, esses indicadores não informam se você está atingindo seu objetivo de melhorar a resolução de incidentes.

    Você precisa de um novo KPI de crescimento do backlog para medir o volume de incidentes pendentes. Para implementar este KPI, crie um indicador de fórmula chamado Crescimento do backlog de incidentes, com a seguinte fórmula:
    [[Number of new incident]] - [[Number of resolved incidents]]

    Registro do indicador de crescimento do backlog de incidentes.
    Ativando Mostrar na biblioteca , você torna o indicador visível em Detalhes de KPI. No painel de informações em Detalhes de KPI, você pode ver a fórmula usada no indicador.
    O indicador de crescimento do backlog de incidentes em Detalhes de KPI