PAFormulaUtils API

L’API PAFormulaUtils vous permet d’obtenir une valeur qui a été calculée dans le et de l’utiliser Centre d'analyse comme entrée pour une formule.

Pour utiliser l’API PAFormulaUtils , vous devez satisfaire les exigences 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 administrateur.

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 symbole 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.
• Paramètre de date que vous avez codé vous-même à l’aide de GlideDate ou de l’API GlideDateTime .

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)
  Renvoie la modification du score d’un indicateur entre deux dates spécifiées.
• getChangePercentage(String, indicator, Object fromDate, Object toDate)
  Renvoie le pourcentage de changement dans le score d’un indicateur entre deux dates spécifiées.
• getCurrentAggregateID()
  Renvoie l’identificateur d’agrégat de séries chronologiques (sys_id) de l’indicateur de la formule actuelle. La sys_id est renvoyée dynamiquement, au fur et à mesure que la sélection change Centre d'analyse .
• getCurrentBreakdownID()
  Renvoie l’identificateur de répartition de niveau 1 (sys_id) de l’indicateur de la formule actuelle. La sys_id est renvoyée dynamiquement, au fur et à mesure que la sélection change Centre d'analyse .
• getCurrentBreakdownLevel2ID()
  Renvoie l’identificateur de répartition de niveau 2 (sys_id) de l’indicateur de la formule en cours. La sys_id est renvoyée dynamiquement, au fur et à mesure que la sélection change Centre d'analyse .
• getCurrentElementID()
  Renvoie l’identificateur d’élément de répartition de niveau 1 (sys_id) de l’indicateur de la formule actuelle. La sys_id est renvoyée dynamiquement, au fur et à mesure que la sélection change Centre d'analyse .
• getCurrentElementLevel2ID()
  Renvoie l’identificateur d’élément de répartition de niveau 2 (sys_id) de l’indicateur de la formule en cours. La sys_id est renvoyée dynamiquement, au fur et à mesure que la sélection change Centre d'analyse .
• getGap(String, indicateur, objet onDate)
  Renvoie l’écart avec la cible globale de l’indicateur spécifié à la date spécifiée.
• getGlobalTarget(String, indicateur, objet onDate)
  Renvoie la cible globale associée à l’indicateur spécifié pour la date spécifiée.
• getPersonalTarget(String, indicateur, objet onDate)
  Renvoie la cible personnelle associée à l’indicateur spécifié pour la date spécifiée.
• getScore (indicateur de chaîne, objet onDate)
  Renvoie le score de l’indicateur spécifié pour la date spécifiée.