API PAFormulaUtils

A API PAFormulaUtils permite obter um valor que foi calculado no Hub de análise e usam esse valor como entrada para uma fórmula.

Para usar o. FormulaUtils API, você deve atender a estes requisitos:

• Performance Analytics deve ser habilitado.
• O usuário que cria o indicador de fórmula que usa esta API deve ter as funções pa_power_user, pa_admin ou admin.

Um cifrão, dólar, precede os nomes dos indicadores em FormulaUtils Parâmetros, como o indicador Número de incidentes em aberto neste exemplo: ([[Número de incidentes em aberto]], score_end); . Este cifrão significa que Hub de análise os valores calculados para o indicador são retornados em vez da pontuação do indicador.

Parâmetros de data em FormulaUtils os métodos assumem uma das seguintes formas:

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

Aviso:

. FormulaUtils A API pode ser usada somente em indicadores de fórmula, não em scripts.

. FormulaUtils A API contém os seguintes métodos:

• GetChange (Indicador de cadeia de caracteres, Objeto fromDate, Objeto até a data)
  Retorna a mudança na pontuação de um indicador entre duas datas especificadas.
• GetChangePercentage(Indicador de cadeia de caracteres, Objeto fromDate, Objeto até a data)
  Retorna a porcentagem de mudança na pontuação de um indicador entre duas datas especificadas.
• AggregateId()
  Retorna o identificador agregado da série temporal (sys_id) do indicador da fórmula atual. O sys_id é retornado dinamicamente, como a seleção no Hub de análise mudanças.
• GetCurrentBreakdownID()
  Retorna o identificador de detalhamento de nível 1 (sys_id) do indicador da fórmula atual. O sys_id é retornado dinamicamente, como a seleção no Hub de análise mudanças.
• Nível de getCurrentBreakdown2ID()
  Retorna o identificador de detalhamento de nível 2 (sys_id) do indicador da fórmula atual. O sys_id é retornado dinamicamente, como a seleção no Hub de análise mudanças.
• GetCurrentElementId()
  Retorna o identificador do elemento de detalhamento de nível 1 (sys_id) do indicador da fórmula atual. O sys_id é retornado dinamicamente, como a seleção no Hub de análise mudanças.
• MetCurrentElementLevel2ID()
  Retorna o identificador do elemento de detalhamento de nível 2 (sys_id) do indicador da fórmula atual. O sys_id é retornado dinamicamente, como a seleção no Hub de análise mudanças.
• GetGap (Indicador de cadeia de caracteres, Objeto onDate)
  Retorna a lacuna de meta global para o indicador especificado na data especificada.
• GetGlobalTarget (indicador de cadeia de caracteres, Objeto onDate)
  Retorna a meta global associada ao indicador especificado para a data especificada.
• GetPersonalTarget (indicador de cadeia de caracteres, Objeto onDate)
  Retorna a meta pessoal associada ao indicador especificado para a data especificada.
• GetScore (Indicador de cadeia de caracteres, Objeto onDate)
  Retorna a pontuação do indicador especificado para a data especificada.