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


---

# Obtenir des méthodes d'analyse dans des formules

# Obtenir des méthodes d'analyse dans des formules {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 l'entrée en tant qu'entrée d'une Centre d'analyse 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'analyseinsé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](https://servicenow-prod.fluidtopics.net/gTn6W7hgTtgFfMZdpb7VUQ "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.").

## Procédure

1. Ouvrez l'enregistrement d'indicateur de formule.
2. Sous la case Formule, cliquez sur Parcourir pour rechercher 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 se réfèrent soit à la formule actuelle que vous modifiez, soit à un indicateur différent que vous devez spécifier. La liste affiche une étiquette descriptive pour chaque méthode au lieu du nom de la méthode.  

   <br />

4. Sélectionnez une méthode.  
   Lorsque vous sélectionnez une méthode, une description s'affiche, y compris le nom de la méthode et tous les champs de paramètre.  

   <br />

   Les champs de date peuvent prendre les valeurs 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 .
   {#get-indicator-analytics__ul_pcg_2nx_tfb}
5. Renseignez tous les paramètres et cliquez sur Sélectionner.  
   La boîte de dialogue se ferme et la méthode s'affiche dans le champ de formule du formulaire d'indicateur.
6. Si la méthode vous demande de spécifier un indicateur, sélectionnez le paramètre `d'indicateur` à l'aide du curseur et cliquez sur Parcourir pour rechercher un indicateur.  
   La boîte de dialogue de sélection de l'indicateur s'ouvre.  

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 symbole dollar signifie que les Centre d'analyse valeurs de l'indicateur au lieu du score de l'indicateur sont renvoyées. Les Centre d'analyse valeurs sont sélectionnées à la place du score lorsque vous cochez la case Utiliser dans la méthode .  

## Indicateur d'index {#get-indicator-analytics__example_bdg_v2h_rsb}

Les indicateurs d'index sont un cas d'utilisation des indicateurs de formule permettant de générer un score unique qui représente plusieurs indicateurs. Dans l'exemple suivant, vous voulez un seul indice 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.
{#get-indicator-analytics__ul_ezd_m3q_4fb}  
Pour obtenir cet index unique, vous créez un indicateur de formule dont la direction est définie sur Maximiser. Tous les indicateurs d'index doivent être maximisés. Ensuite, vous utilisez les fonctions Parcourir pour rechercher une méthode et Parcourir pour un indicateur afin de 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 sur un changement lui-même {#get-indicator-analytics__example_xcc_fmz_3wb}

Vous souhaitez définir pour vos équipes un objectif 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 une cible de -10 % pour cet indicateur sur le Centre d'analyse.

    var lastPeriod = new GlideDateTime(score_start.getYear() + '-' + score_start.getMonth() + '-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 {#get-indicator-analytics__example_gfq_hlz_3wb}

Vous souhaitez filtrer les scores des incidents dont la 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 savoir comment obtenir les identificateurs d'enregistrement uniques, consultez [L'identificateur d'enregistrement unique (sys_id).](https://www.servicenow.com/docs/access?context=c_UniqueRecordIdentifier&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)

   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;

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

**Concepts associés**   

* [Empêcher un indicateur de contribution dans une formule de suivre les répartitions](https://servicenow-prod.fluidtopics.net/37uStp7rwkezpsI6EF7Mnw "Vous pouvez sélectionner des indicateurs de contribution dans une formule pour qu’ils ne soient pas ventilés. Lorsqu’un utilisateur applique une répartition à l’indicateur de formule, la répartition ne s’applique pas à ces indicateurs.")
* [Matrices de répartition dans les indicateurs de formule](https://servicenow-prod.fluidtopics.net/uB6s1H9XoKBG59K4LImghQ "Les indicateurs de formule héritent des matrices de répartition des indicateurs de la formule.")
* [Appliquer des séries chronologiques aux indicateurs de résultat ou de contribution](https://servicenow-prod.fluidtopics.net/sBigL7coRfRwhILY8p4oTQ "Pour un indicateur de formule, une agrégation de série chronologique peut s’appliquer soit à chaque indicateur de la formule individuellement, soit au résultat de la formule.")
* [Indexation de plusieurs indicateurs dans une formule](https://servicenow-prod.fluidtopics.net/CFf2r_QYrOKsZe1EPBTyKw "Vous pouvez écrire une formule pour mesurer l’écart par rapport à l’objectif global de plusieurs indicateurs combinés. Un tel indicateur de formule est appelé « indicateur d’indice ».")
* [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.")  
**Tâches associées**   

* [Créer un indicateur de formule](https://servicenow-prod.fluidtopics.net/80vf2arQg7m3aJK5WaWxag "Créez un indicateur de formule pour produire un nouveau score calculé à partir d’un ou de plusieurs indicateurs. Outre les scores d’indicateur, la formule peut inclure des calculs tels que l’écart entre un score d’indicateur et la cible de l’indicateur.")
* [Détecter les indicateurs sans score dans une formule](https://servicenow-prod.fluidtopics.net/OuBGQTLSy98CQ0i8JDBtLQ "En tant que créateur de formule, vous pouvez gérer les indicateurs de contribution qui ont des scores nuls. Définissez d’abord l’indicateur de formule pour calculer la formule même lorsqu’elle contient un score nul.")