---
sourceDocument: Analyse de la plateforme Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Analyse de la plateforme Xanadu

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# PAFormulaUtils API

# PAFormulaUtils API {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](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 d'utiliser cette valeur comme entrée pour une formule.  
Pour utiliser l'API PAFormulaUtils , vous devez remplir les conditions suivantes :

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

Un symbole 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 de 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, comme 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 calculée 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 de score_start/de fin en raison des différents fuseaux horaires de l'utilisateur](https://servicenow-prod.fluidtopics.net/UJqgcoJq_elFm3QIEzrSHQ "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 les utilisateurs de 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/kv3Ztv9hvx8RYZee3PeGhQ)**   
  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/Cj5aACwzjF9qNCm0JS1ixg)**   
  Renvoie le pourcentage de changement du score d'un indicateur entre deux dates spécifiées.
* **[getCurrentAggregateID()](https://servicenow-prod.fluidtopics.net/tHcSYuVFEOUe2n7SE2Jxqg)**   
  Renvoie l'identificateur d'agrégat de séries chronologiques (sys_id) de l'indicateur de la formule actuelle. Le sys_id est renvoyé dynamiquement, car la sélection dans le Centre d'analyse champ change.
* **[getCurrentBreakdownID()](https://servicenow-prod.fluidtopics.net/9ReiyaXHM92a~aMoPfnxHw)**   
  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, car la sélection dans le Centre d'analyse champ change.
* **[getCurrentBreakdownLevel2ID()](https://servicenow-prod.fluidtopics.net/wUdgK_hBDc0Nv6FE13g8uQ)**   
  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, car la sélection dans le Centre d'analyse champ change.
* **[getCurrentElementID()](https://servicenow-prod.fluidtopics.net/qVKcgnl9wxjRtf0YpfEpDQ)**   
  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, car la sélection dans le Centre d'analyse champ change.
* **[getCurrentElementLevel2ID()](https://servicenow-prod.fluidtopics.net/Mkp45dRuS1d9THGNnIv_Aw)**   
  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, car la sélection dans le Centre d'analyse champ change.
* **[getGap(Indicateur de chaîne, objet onDate)](https://servicenow-prod.fluidtopics.net/4fjMUmc9NPjUyH5d5T0Qjw)**   
  Renvoie l'écart avec la cible globale de l'indicateur spécifié à la date spécifiée.
* **[getGlobalTarget(Indicateur de chaîne, objet onDate)](https://servicenow-prod.fluidtopics.net/Ok8Utl6H1qX5oMkqGwpdpg)**   
  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/KmMUxUUp8qPb8IQM3NkMuA)**   
  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/3J~uxDHB3AN7NICt77E7lw)**   
  Renvoie le score de l'indicateur spécifié pour la date spécifiée.