---
sourceDocument: Yokohama Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/now-intelligence

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# API de Utils de FormulaPAFormula

# API de Utils de FormulaPAFormula {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

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.
{#PAFormulaUtils__ul_rxq_nnk_ffb}

Um sinal de dólar, 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 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](https://servicenow-prod.fluidtopics.net/s~MaOVsCQHuPOv4fe7FBCQ "Para indicadores de fórmula, os valores das variáveis score_start e. score_end são calculados com base no fuso horário do usuário que está executando a fórmula. Se usuários em fusos horários diferentes executarem a mesma fórmula, os valores de score_start e. score_end mudança.").
* Um parâmetro de data que você mesmo codificou usando GlideDate ou o. GlideDateTime API.
{#PAFormulaUtils__ul_jsg_gzx_tfb}  
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)](https://servicenow-prod.fluidtopics.net/BP8b3F_Rvbki9HRhvlG8Lg)**   
  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)](https://servicenow-prod.fluidtopics.net/CRbQb4CEnZBuIxVD5QNtzw)**   
  Retorna a porcentagem de mudança na pontuação de um indicador entre duas datas especificadas.
* **[AggregateId()](https://servicenow-prod.fluidtopics.net/2dUJi7pHm3hLHWENj9bqaQ)**   
  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()](https://servicenow-prod.fluidtopics.net/6KHKnfXocMNKshQmQpgojQ)**   
  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.
* **[Level2Id() getCurrentBreakdownBreakdownLevel2Id()](https://servicenow-prod.fluidtopics.net/Yre3_ZdWZZVHsIL1___Myg)**   
  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.
* **[Id getCurrentElementId()](https://servicenow-prod.fluidtopics.net/slbMUgbIoCF6ZH59FotGug)**   
  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.
* **[GetCurrentElementLevel2Id()](https://servicenow-prod.fluidtopics.net/lOuFtb3lIA9T7tWBz8PXrQ)**   
  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)](https://servicenow-prod.fluidtopics.net/qiDNq_StFI2LV8nNh6Aykg)**   
  Retorna a lacuna de meta global para o indicador especificado na data especificada.
* **[GetGlobalTarget (indicador de cadeia de caracteres, Objeto onDate)](https://servicenow-prod.fluidtopics.net/a6c~prZ0KbTLoQuAGQSIcA)**   
  Retorna a meta global associada ao indicador especificado para a data especificada.
* **[GetPersonalTarget (indicador de cadeia de caracteres, Objeto onDate)](https://servicenow-prod.fluidtopics.net/5oNPje5VLFOKrBlBJ7nhsA)**   
  Retorna a meta pessoal associada ao indicador especificado para a data especificada.
* **[GetScore (Indicador de cadeia de caracteres, Objeto onDate)](https://servicenow-prod.fluidtopics.net/DZ75CVgXZA2QpS51BMnqCw)**   
  Retorna a pontuação do indicador especificado para a data especificada.