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

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Yokohama Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# PAFormulaUtils API

# PAFormulaUtils API {#ariaid-title1}

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

L'API PAFormulaUtils vous permet d'obtenir une valeur qui a été calculée dans le Centre d'analyse et de l'utiliser comme entrée pour une formule.  
Pour utiliser l'API PAFormulaUtils , vous devez satisfaire à ces exigences :

* Analyse des performances doit être activé.
* L'utilisateur qui crée l'indicateur de formule qui utilise cette API doit avoir les rôles pa_power_user, pa_admin ou administrateur.
{#PAFormulaUtils__ul_rxq_nnk_ffb}

Un signe dollar, $, précède les noms d'indicateurs dans les paramètres PAFormulaUtils , comme l'indicateur Nombre d'incidents ouverts dans cet exemple : `pa.getGap($[[Nombre d'incidents ouverts]], score_end) ;`. Ce signe dollar signifie que les Centre d'analyse valeurs calculées pour l'indicateur sont renvoyées à la place du score de l'indicateur.  
Les paramètres de date dans les méthodes PAFormulaUtils prennent l'une des formes suivantes :

* Une date absolue au format AAAA-MM-JJ, telle que 2018-12-21.
* La variable `score_start` ou `score_end`. Ces variables représentent la première et la dernière seconde de la période de collecte en cours de calcul pour l'indicateur référencé. Les heures sont calculées à partir de la différence entre le fuseau horaire de l'utilisateur et le fuseau horaire du serveur de base de données, qui est GMT. Pour plus d'informations, consultez [Changements apportés à l'score_start/à la fin en raison de fuseaux horaires utilisateur différents](https://servicenow-prod.fluidtopics.net/27_YaeocpojWGifRo5Y12Q "Pour les indicateurs de formule, les valeurs des variables score_start et score_end sont calculées en fonction du fuseau horaire de l’utilisateur qui exécute la formule. Si des utilisateurs situés dans des fuseaux horaires différents exécutent la même formule, les valeurs de score_start et de score_end changent.").
* Paramètre de date que vous avez codé vous-même à l'aide de l'API GlideDate ou GlideDateTime .
{#PAFormulaUtils__ul_jsg_gzx_tfb}  
Avertissement :  
L'API PAFormulaUtils ne peut être utilisée que dans les indicateurs de formule, pas dans les scripts.

L'API PAFormulaUtils contient les méthodes suivantes :
* **[getChange(indicateur de chaîne, objet fromDate, objet toDate)](https://servicenow-prod.fluidtopics.net/nxmkJNyjcDL1_IwUsbdEHA)**   
  Renvoie la modification du score d'un indicateur entre deux dates spécifiées.
* **[getChangePercentage(indicateur de chaîne, objet fromDate, objet toDate)](https://servicenow-prod.fluidtopics.net/XvLsTdGNQaxLQMnNFTpnMQ)**   
  Renvoie le pourcentage de changement du score d'un indicateur entre deux dates spécifiées.
* **[getCurrentAggregateID()](https://servicenow-prod.fluidtopics.net/8cwjKMjAPXR7jzb2J1U5YQ)**   
  Renvoie l'identificateur d'agrégat de série chronologique (sys_id) de l'indicateur de la formule actuelle. Le sys_id est renvoyé dynamiquement, à mesure que la sélection dans les Centre d'analyse changements.
* **[getCurrentBreakdownID()](https://servicenow-prod.fluidtopics.net/kZ3puYU8iIoqKg1Cq29nGw)**   
  Renvoie l'identificateur de répartition de niveau 1 (sys_id) de l'indicateur de la formule en cours. Le sys_id est renvoyé dynamiquement, à mesure que la sélection dans les Centre d'analyse changements.
* **[getCurrentBreakdownLevel2ID()](https://servicenow-prod.fluidtopics.net/AFtdLgRVo6tLXrT6RfFlzA)**   
  Renvoie l'identificateur de répartition de niveau 2 (sys_id) de l'indicateur de la formule en cours. Le sys_id est renvoyé dynamiquement, à mesure que la sélection dans les Centre d'analyse changements.
* **[getCurrentElementID()](https://servicenow-prod.fluidtopics.net/QCxSYrdHfLGXsPisGQyDcw)**   
  Renvoie l'identificateur d'élément de répartition de niveau 1 (sys_id) de l'indicateur de la formule en cours. Le sys_id est renvoyé dynamiquement, à mesure que la sélection dans les Centre d'analyse changements.
* **[getCurrentElementLevel2ID()](https://servicenow-prod.fluidtopics.net/cfPWBIBwFFXAVYq5cOUTzw)**   
  Renvoie l'identificateur d'élément de répartition de niveau 2 (sys_id) de l'indicateur de la formule en cours. Le sys_id est renvoyé dynamiquement, à mesure que la sélection dans les Centre d'analyse changements.
* **[getGap(indicateur de chaîne, objet onDate)](https://servicenow-prod.fluidtopics.net/4fDaGOREfVDfXpCtdFPQqA)**   
  Renvoie l'écart cible global pour l'indicateur spécifié à la date spécifiée.
* **[getGlobalTarget(indicateur de chaîne, objet onDate)](https://servicenow-prod.fluidtopics.net/8f_rzfYedQmxjfYDnDyClw)**   
  Renvoie la cible globale associée à l'indicateur spécifié pour la date spécifiée.
* **[getPersonalTarget(indicateur de chaîne, objet onDate)](https://servicenow-prod.fluidtopics.net/FtsEscMg3ttu~P_AxU5fMA)**   
  Renvoie la cible personnelle associée à l'indicateur spécifié pour la date spécifiée.
* **[getScore(indicateur de chaîne, objet onDate)](https://servicenow-prod.fluidtopics.net/fdXpR0B63y2n2bYmQtRSwQ)**   
  Renvoie le score de l'indicateur spécifié pour la date spécifiée.