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


---

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

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

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](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 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](https://servicenow-prod.fluidtopics.net/oTlICcZoPfW5CdWVT5L4wg "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.").

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

   <br />

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.  

   <br />

   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](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 .
   {#get-indicator-analytics__ul_pcg_2nx_tfb}
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.  

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 d'index {#get-indicator-analytics__example_bdg_v2h_rsb}

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.
{#get-indicator-analytics__ul_ezd_m3q_4fb}  
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 {#get-indicator-analytics__example_xcc_fmz_3wb}

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 {#get-indicator-analytics__example_gfq_hlz_3wb}

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).](https://www.servicenow.com/docs/access?context=c_UniqueRecordIdentifier&version=yokohama&pubname=yokohama-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/oTlICcZoPfW5CdWVT5L4wg)**   
  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.

**Concepts associés**   

* [Empêcher un indicateur de contribution dans une formule de suivre les répartitions](https://servicenow-prod.fluidtopics.net/Vx1kWOCm9bUiP9LFleu_GA "Vous pouvez sélectionner des indicateurs de contribution dans une formule à ne pas ventiler. 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 des indicateurs de formule](https://servicenow-prod.fluidtopics.net/z343ems5bzjb1VKU4W4dBw "Les indicateurs de formule héritent des matrices de répartition des indicateurs de la formule.")
* [Application de séries chronologiques au résultat ou aux indicateurs de contribution](https://servicenow-prod.fluidtopics.net/S5nYUmwH1iMsEvCeVDjiIA "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/RIfhHFLP9V0KqtbTosEcOw "Vous pouvez écrire une formule pour mesurer l’écart par rapport à la cible globale de plusieurs indicateurs combinés. Un tel indicateur de formule est appelé « indicateur d’index ».")
* [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.")  
**Tâches associées**   

* [Créer un indicateur de formule](https://servicenow-prod.fluidtopics.net/f0wz_4Mn5bDHzoeRPYfwmw "Créez un indicateur de formule pour produire un nouveau score calculé à partir d’un ou de plusieurs autres 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.")
* [Indicateurs de détection sans score dans une formule](https://servicenow-prod.fluidtopics.net/Em765VFZh_HmacAGVYsWXA "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 s’il contient un score nul.")