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

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • Para inserir um valor calculado de 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, inclusive do próprio indicador de fórmula atual.

    Para obter um valor de Hub de análise, insira um método de PAFormulaUtils() na fórmula. Para chamar um desses métodos, use a variável Performance Analyticspa. Por exemplo, para usar o método PAFormulaUtils.getScore, chame pa.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 Procurar um método.
      Uma caixa de diálogo é aberta e você pode selecionar um método.
    3. Procure o método que corresponda à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" realçado.
    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 para score_start/end devido aos diferentes fusos horários do usuário.
      • Um parâmetro de data que você mesmo codificou usando a API GlideDate ou GlideDateTime.
    5. Preencha todos os parâmetros e clique em Selecionar.
      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 o parâmetro do indicador com o cursor e clique em Procurar um indicador.
      A caixa de diálogo de seleção do indicador é aberta.
      Abrindo a caixa de diálogo de seleção do 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érie temporal.
    9. Selecione Usar no método e clique em Enviar.
      O método está concluído, com um indicador selecionado. Observe que um cifrão, $, precede o indicador. Este cifrão significa que os valores Hub de análise do indicador em vez da pontuação do indicador são retornados. Os valores Hub de análise são selecionados em vez da pontuação quando você marca a caixa de seleção Usar no método.
      Indicador, detalhamento, elemento e caixa de seleção Usar no método estão sendo selecionados

    Indicador de índice

    Os indicadores de índice são um caso de uso de indicadores de fórmula para gerar uma única pontuação 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 que estão atrasados.
    • A idade média da última atualização de incidentes em aberto.
    • O número total de incidentes em aberto.
    Para obter esse índice único, crie um indicador de fórmula com Direção definida como Maximizar. Todos os indicadores de índice devem ser maximizados. Em seguida, use as funções Procurar um método e Procurar um indicador 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 seguinte fórmula e define uma meta de -10% para este indicador no Hub de análise.

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

    Filtrar pontuações com base em detalhamento e elemento

    Você deseja filtrar as pontuações de incidentes em que Prioridade = 1 - Crítico.
    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 Detalhamento. O local dos registros de elemento varia, mas é identificado na Origem de Detalhamento do detalhamento. Nesse caso, o elemento é um registro Opção [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 1 - Crítico.

    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;