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


---

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

# Obter métodos de análise em fórmulas {#ariaid-title1}

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

Para inserir um valor calculado do Hub de análiseem 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álisecomo 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 Analyticsvariável `pa `. Por exemplo, para usar o. FormulaUtils.getScore método, chamada `Pontuação.getScore `. Para obter mais informações, consulte [API de Utils de FormulaPAFormula](https://servicenow-prod.fluidtopics.net/lC1MNUe2EOTqVJWk1D2Uvg "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.").

## 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, onde 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.  

   <br />

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.  

   <br />

   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](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.
   {#get-indicator-analytics__ul_pcg_2nx_tfb}
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 de 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.  

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 sinal de dólar, dólar, precede o indicador. Este cifrão significa que Hub de análisevalores do indicador em vez da pontuação do indicador são retornados. . Hub de análiseos valores são selecionados em vez da pontuação quando você seleciona Método de uso caixa de seleção.  

## Indicador de índice {#get-indicator-analytics__example_bdg_v2h_rsb}

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.
{#get-indicator-analytics__ul_ezd_m3q_4fb}  
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;

## Defina metas em uma mudança em si {#get-indicator-analytics__example_xcc_fmz_3wb}

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 {#get-indicator-analytics__example_gfq_hlz_3wb}

Você deseja filtrar as pontuações de incidentes em que a 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 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)](https://www.servicenow.com/docs/access?context=c_UniqueRecordIdentifier&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

   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;

{#get-indicator-analytics__ol_exr_wm5_5fb}
* **[API de Utils de FormulaPAFormula](https://servicenow-prod.fluidtopics.net/lC1MNUe2EOTqVJWk1D2Uvg)**   
  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.

**Conceitos relacionados**   

* [Evite que um indicador de contribuição em uma fórmula siga detalhamentos](https://servicenow-prod.fluidtopics.net/CafHfOfZ4txCjs89hBE_ZQ "Você pode selecionar indicadores de contribuição em uma fórmula para não serem detalhados. Quando um usuário aplica um detalhamento ao indicador de fórmula, o detalhamento não se aplica a esses indicadores.")
* [Matrizes de detalhamento em indicadores de fórmula](https://servicenow-prod.fluidtopics.net/z9~Fx1T85eQh8mCo7GCP~w "Os indicadores de fórmula herdam matrizes de detalhamento dos indicadores na fórmula.")
* [Aplicando séries temporais ao resultado ou aos indicadores de contribuição](https://servicenow-prod.fluidtopics.net/8EjkNNWQJVArXlwDDkBLFA "Para um indicador de fórmula, uma agregação de série temporal pode ser aplicada a cada indicador na fórmula individualmente ou ao resultado da fórmula.")
* [Indexando vários indicadores em uma fórmula](https://servicenow-prod.fluidtopics.net/W5QRRh6ae5oTszw5l4VVaA "Você pode escrever uma fórmula para medir qual é a lacuna em relação à meta geral de vários indicadores combinados. Esse indicador de fórmula é chamado de \"indicador de índice\".")
* [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.")  
**Tarefas relacionadas**   

* [Crie um indicador de fórmula](https://servicenow-prod.fluidtopics.net/syJI8OCAWZXSuFL4WZI9XA "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.")
* [Detecte indicadores sem pontuações em uma fórmula](https://servicenow-prod.fluidtopics.net/uYT_usP5T8otVlKbimmmIg "Como o criador da fórmula, você pode lidar com indicadores de contribuição que têm pontuações nulas. Primeiro, defina o indicador de fórmula para calcular a fórmula mesmo quando ela contiver uma pontuação nula.")