Obtenir les méthodes d’analyse dans les formules

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • Pour insérer une valeur calculée à partir de dans Centre d'analyse une formule, utilisez une méthode dans la formule.

    Avant de commencer

    Rôle requis : pa_power_user, admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez utiliser une valeur qui a été calculée dans le Centre d'analyse comme entrée pour une formule. Cette valeur peut provenir de n’importe quel indicateur, y compris de l’indicateur de formule en cours lui-même.

    Pour obtenir une valeur à partir de , Centre d'analyse insérez une méthode de PAFormulaUtils() dans la formule. Pour appeler l’une de ces méthodes, utilisez la Analyse des performances variable pa. Par exemple, pour utiliser la méthode PAFormulaUtils.getScore , appelez pa.getScore. Pour plus d'informations, consultez PAFormulaUtils API.

    Procédure

    1. Ouvrez l’enregistrement de l’indicateur de formule.
    2. Sous la zone Formule, cliquez sur Parcourir pour trouver une méthode.
      Une boîte de dialogue s’ouvre dans laquelle vous pouvez sélectionner une méthode.
    3. Recherchez la méthode qui correspond à vos besoins.
      Les méthodes font référence soit à la formule en cours que vous modifiez, soit à un autre indicateur que vous devez spécifier. La liste affiche une étiquette descriptive pour chaque méthode au lieu du nom de la méthode.

      Liste des étiquettes descriptives des méthodes dans la boîte de dialogue « Ajouter une méthode à la formule », avec « Obtenir l’écart cible global de l’indicateur spécifié » mis en surbrillance.
    4. Sélectionnez une méthode.
      Lorsque vous sélectionnez une méthode, une description s’ouvre, comprenant le nom de la méthode et les champs de paramètres.

      Boîte de dialogue Ajouter une méthode à la formule affichant la méthode Obtenir l’écart cible global de l’indicateur spécifié sélectionné et la date spécifiée comme dernier score collecté
      Les champs Date peuvent prendre les valeurs 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 l’API GlideDate ou GlideDateTime .
    5. Renseignez les paramètres et cliquez sur Sélectionner.
      La boîte de dialogue se ferme et la méthode apparaît dans le champ de formule du formulaire d’indicateur.
    6. Si la méthode nécessite que vous spécifiiez un indicateur, sélectionnez le paramètre d’indicateur avec le curseur et cliquez sur Parcourir pour trouver un indicateur.
      La boîte de dialogue de sélection de l’indicateur s’ouvre.
      Ouverture de la boîte de dialogue de sélection de l’indicateur à partir d’une méthode dans la formule
    7. Sélectionnez l’indicateur.
    8. Facultatif : Sélectionnez des répartitions ou des éléments et une agrégation de série chronologique.
    9. Sélectionnez Utiliser dans la méthode et cliquez sur Soumettre.
      La méthode est terminée, avec un indicateur sélectionné. Notez qu’un symbole dollar, $, précède l’indicateur. Ce signe dollar signifie que les Centre d'analyse valeurs de l’indicateur sont renvoyées au lieu du score de l’indicateur. Les Centre d'analyse valeurs sont sélectionnées à la place du score lorsque vous cochez la case Utiliser dans la méthode .
      Indicateur, répartition, élément et case à cocher Utiliser dans la méthode sont cochés

    Indicateur d’index

    Les indicateurs d’index sont un cas d’utilisation des indicateurs de formule pour générer un score unique qui représente plusieurs indicateurs. Dans l’exemple suivant, vous souhaitez un index unique qui agrège l’écart entre le score et la cible globale pour les indicateurs suivants :
    • Pourcentage d’incidents en retard.
    • Âge moyen de la dernière mise à jour des incidents ouverts.
    • Nombre total d’incidents ouverts.
    Pour obtenir cet index unique, vous créez un indicateur de formule avec la direction définie sur Maximiser. Tous les indicateurs d’index doivent être maximisés. Ensuite, vous utilisez les fonctions Parcourir pour une méthode et Parcourir pour un indicateur pour créer la formule suivante :
    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;

    Définir des cibles pour un changement lui-même

    Vous souhaitez définir un objectif pour vos équipes de réduction de 10 % par mois du backlog des incidents. Vous créez un indicateur de formule avec la formule suivante et définissez un objectif de -10 % pour cet indicateur sur le Centre d'analyse.

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

    Filtrer les scores en fonction de la répartition et de l’élément

    Vous souhaitez filtrer les scores d’incidents où Priorité = 1 - Critique.
    1. Obtenez les identificateurs d’enregistrement uniques pour la répartition des priorités et l’élément 1 - Critique. Les enregistrements de répartition se trouvent dans la table Répartition. L’emplacement des enregistrements d’éléments varie, mais il est identifié dans la source de répartition de la répartition. Dans ce cas, l’élément est un enregistrement de choix [sys_choice]. Pour obtenir des instructions sur la façon d’obtenir les identificateurs d’enregistrement uniques, consultez L’identificateur d’enregistrement unique (sys_id).

      Les identificateurs d’enregistrement uniques sont baec0752bf130100b96dac808c0739ed pour la répartition des priorités et 8a4dde73c6112278017a6a4baf547aa7 pour l’élément 1 - Critique.

    2. Créez un indicateur avec la formule suivante :
      var res = [[Number of open incidents]];
if(pa.getCurrentBreakdownID() == 'baec0752bf130100b96dac808c0739ed' && pa.getCurrentElementID() == '8a4dde73c6112278017a6a4baf547aa7')
{
res = 0;
}
res;