Obtenha métodos de análise em fórmulas

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • Para inserir um valor calculado do Hub de análise em uma fórmula, use um método na fórmula.

    Antes de Iniciar

    Função necessária: pa_power_user, administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode usar um valor que foi calculado em Hub de análise como entrada para uma fórmula. Esse valor pode ser de qualquer indicador, incluindo o próprio indicador da fórmula atual.

    Para obter um valor do Hub de análise, insira um método de FormulaUtils() na fórmula. Para chamar um desses métodos, use Performance Analytics variável pa . Por exemplo, para usar o. PAFormulaUtils.getScore método, chamada Pontuação.getScore . Para obter mais informações, consulte API PAFormulaUtils.

    Procedimento

    1. Abra o registro do indicador de fórmula.
    2. Abaixo da caixa Fórmula, clique em Procure um método .
      Uma caixa de diálogo é aberta, na qual você pode selecionar um método.
    3. Procure o método que corresponde às suas necessidades.
      Os métodos se referem à fórmula atual que você está editando ou a um indicador diferente que você deve especificar. A lista mostra um rótulo descritivo para cada método em vez do nome do método.

      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.
    4. Selecione um método.
      Quando você seleciona um método, uma descrição é aberta, incluindo o nome do método e todos os campos de parâmetro.

      A caixa de diálogo Adicionar um método à fórmula mostrando o método Obter lacuna de meta global do indicador especificado selecionado e a data especificada como a última pontuação coletada
      Os campos de data podem ter os seguintes valores:
      • Uma data absoluta no formato AAAA-MM-DD, como 2018-12-21.
      • A variável score_start ou score_end . Essas variáveis representam o primeiro e o último segundo do período de coleta que está sendo calculado para o indicador referenciado. As horas são calculadas a partir da diferença entre o fuso horário do usuário e o fuso horário do servidor de banco de dados, que é GMT. Para obter mais informações, consulte Mudanças em score_start/end devido a fusos horários diferentes do usuário.
      • Um parâmetro de data que você mesmo codificou usando GlideDate ou o. GlideDateTime API.
    5. Preencha todos os parâmetros e clique em Selecione .
      A caixa de diálogo é fechada e o método aparece no campo de fórmula do formulário do indicador.
    6. Se o método exigir que você especifique um indicador, selecione indicador parâmetro com o cursor e clique Procure um indicador .
      A caixa de diálogo de seleção do indicador é aberta.
      Abrindo a caixa de diálogo de seleção de indicador de dentro de um método na fórmula
    7. Selecione o indicador.
    8. Opcional: Selecione detalhamentos ou elementos e uma agregação de séries temporais.
    9. Selecione Método de uso e clique em Enviar .
      O método está concluído, com um indicador selecionado. Observe que um cifrão, dólar, precede o indicador. Este cifrão significa que Hub de análise os valores do indicador em vez da pontuação do indicador são retornados. . Hub de análise os valores são selecionados em vez da pontuação quando você seleciona Método de uso caixa de seleção.
      Caixa de seleção Indicador, detalhamento, elemento e uso no método que está sendo marcada

    Indicador de índice

    Os indicadores de índice são um caso de uso de indicadores de fórmula para gerar uma pontuação única que representa vários indicadores. No exemplo a seguir, você deseja um único índice que agregue a lacuna entre a pontuação e a meta global para os seguintes indicadores:
    • A porcentagem de incidentes atrasados.
    • A idade média da última atualização de incidentes em aberto.
    • O número total de incidentes em aberto.
    Para obter este índice único, crie um indicador de fórmula com Direção definido como Maximizar . Todos os indicadores de índice devem maximizar. Em seguida, você usa o. Procure um método e. Procure um indicador funções para criar a seguinte fórmula:
    var a = pa.getGap($[[% of open overdue incidents]], score_start) / pa.getGlobalTarget($[[% of open overdue incidents]],score_start);
var b = pa.getGap($[[Average age of last update of open incidents]], score_start) / pa.getGlobalTarget($[[Average age of last update of open incidents]], score_start);
var c = pa.getGap($[[Number of open incidents]], score_start) / pa.getGlobalTarget($[[Number of open incidents]], score_start);
var res = 100 - (100 * (a + b + c) / 3);
res;

    Definir metas em uma mudança em si

    Você deseja definir uma meta para suas equipes de uma redução de 10% mês a mês no backlog de incidentes. Você cria um indicador de fórmula com a fórmula a seguir e define uma meta de -10% para este indicador no Hub de análise.

    var lastPeriod = new GlideDateTime(score_start.getYearUTC() + '-' + score_start.getMonthUTC() + '-01');
lastPeriod.addDaysUTC(-1);
pa.getChangePercentage($[[Number of open incidents]], lastPeriod.addDaysUTC(-1), score_start);

    Filtre pontuações com base no detalhamento e no elemento

    Você deseja filtrar as pontuações de incidentes em que a prioridade é 1 - Crítica.
    1. Obtenha os identificadores de registro exclusivos para o detalhamento de prioridade e o elemento 1 - Crítico. Os registros de detalhamento estão na tabela de detalhamento. O local dos registros de elemento varia, mas é identificado na Origem de detalhamento do detalhamento. Nesse caso, o elemento é um registro de escolha [sys_choice]. Para obter instruções sobre como obter os identificadores de registro exclusivos, consulte O identificador de registro exclusivo (sys_id) .

      Os identificadores de registro exclusivos são baec0752bf130100b96dac808c0739ed para o detalhamento de prioridade e 8a4dde73c6112278017a6a4baf547aa7 para o elemento Crítico 1.

    2. Crie um indicador com a seguinte fórmula:
      var res = [[Number of open incidents]];
if(pa.getCurrentBreakdownID() == 'baec0752bf130100b96dac808c0739ed' && pa.getCurrentElementID() == '8a4dde73c6112278017a6a4baf547aa7')
{
res = 0;
}
res;