Créer un indicateur de formule

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

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

    Avant de commencer

    Rôle requis : pa_power_user, pa_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Les formules sont souvent utilisées pour :
    • Calculez les ratios et les pourcentages.
    • Combinez des données provenant de différentes applications.
    • Créez des indicateurs prédictifs basés sur les performances historiques.

    Les champs d’un indicateur de formule sont similaires à ceux d’un indicateur automatisé. Cependant, au lieu des propriétés Source, Additional Conditions et Collection, une instruction Formula (Formule) est définie. Les formules peuvent être constituées d’autres indicateurs, constantes, variables et séries chronologiques, ou de toute combinaison de ces éléments.

    Remarque :
    • Vous devez disposer d’un abonnement pour Analyse des performances créer des indicateurs.
    • Si vous utilisez Séparation en domaines, l’indicateur est créé dans le domaine dans lequel vous vous trouvez actuellement.

    Procédure

    1. Utilisez l’un des chemins de navigation suivants :
      • Si vous êtes sur une instance mise à niveau qui n’a pas migré vers , accédez à Platform Analytics Tout > Analyse des performances > Indicateurs > Indicateurs de formule et sélectionnez New (Nouveau).
      • Si vous utilisez une nouvelle instance ou avez migré vers , accédez à Platform Analytics Tout > Administration de Platform Analytics > Indicateurs > Indicateurs de formule et sélectionnez New (Nouveau).
    2. Dans le champ Nom , donnez à l’indicateur un nom descriptif, tel que Durée moyenne des incidents ouverts.
    3. Dans le champ Calendriers , sélectionnez le calendrier standard ou un groupe de calendriers d’entreprise ou fiscal.
    4. Si vous avez sélectionné un calendrier professionnel ou fiscal, sélectionnez la fréquence du calendrier.
      Au moins un indicateur dans la formule doit correspondre à la fréquence calendaire spécifiée. Le choix des fréquences de calendrier dépend du paramétrage des entrées du calendrier professionnel ou des calendriers fiscaux.
      Par exemple, le calendrier grégorien a des fréquences de trimestre, mois, semaine et année. Si vous utilisez le calendrier grégorien, vous devez choisir l’une de ces fréquences.
      Options de fréquence du calendrier pour le calendrier grégorien
    5. Si vous préférez que le score de cet indicateur augmente ou diminue avec le temps, sélectionnez Agrandir ou Réduire dans le champ Direction .
      Les outils d’analyse et les affichages graphiques utilisent cette direction avec cet indicateur.
      Conseil :
      Définissez une direction chaque fois que vous le pouvez. Tous les indicateurs clés doivent être définis sur Maximiser ou Minimiser.
      ValeurCas d'utilisation
      Agrandir Sélectionnez si une augmentation de ce score d’indicateur est souhaitée. Par exemple, envisagez de sélectionner Maximiser pour un indicateur qui indique le chiffre d’affaires. Les outils d’analyse et les éléments graphiques montrent qu’une augmentation de ce score d’indicateur est bonne et qu’une diminution est mauvaise.
      Réduire Sélectionnez si une diminution de ce score d’indicateur est souhaitée. Par exemple, envisagez de sélectionner Minimiser pour un indicateur qui affiche les coûts. Les outils d’analyse et les éléments graphiques montrent qu’une diminution de ce score d’indicateur est bonne et qu’une augmentation est mauvaise.
      Aucun Sélectionnez si la direction du changement de ce score n’a pas d’importance pour votre entreprise.
    6. Définissez la formule pour cet indicateur.
      1. Pour utiliser une valeur calculée dans la formule, cliquez sur Parcourir pour rechercher une méthode (répétable).
        Une boîte de dialogue s’ouvre pour vous permettre d’insérer une méthode de PAFormulaUtils() dans la formule. Cette API renvoie la valeur calculée pour un indicateur. Pour plus d’informations sur l’utilisation de cette API, reportez-vous à la section Obtenir les méthodes d’analyse dans les formules.
        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.
      2. Pour mettre le score d’un indicateur dans la formule, cliquez sur le lien Parcourir pour trouver un indicateur et remplissez la boîte de dialogue (Répétable).
        Tableau 1. Boîte de dialogue de sélection d’indicateur
        Champ Description
        Indicateur L’indicateur que vous insérez comme indicateur de contribution dans la formule.

        Si vous utilisez un calendrier professionnel ou fiscal pour cet indicateur, au moins un indicateur de la formule doit utiliser le calendrier et la fréquence de calendrier correspondants.
        Répartition, élément, répartition de deuxième niveau, élément de deuxième niveau Jusqu’à deux niveaux de répartition et d’élément pour filtrer les scores sur l’indicateur. Si vous spécifiez une répartition, vous devez spécifier un élément de cette répartition. Ces répartitions et éléments s’appliquent uniquement à cet indicateur de contribution et non à l’indicateur de formule dans son ensemble.
        Séries chronologiques Fonction analytique prédéfinie, telle qu’une moyenne glissante sur 7 jours, à appliquer à l’indicateur au lieu d’afficher les scores bruts de l’indicateur. Cette série chronologique ne s’applique qu’à cet indicateur de contribution et non à l’indicateur de formule dans son ensemble.
        Autoriser les répartitions Applique les répartitions qui s’appliquent à l’indicateur de formule entier, par opposition aux indicateurs individuels de la formule, à appliquer à cet indicateur de contribution. Activé par défaut. Pour plus d'informations, consultez Empêcher un indicateur de contribution dans une formule de suivre les répartitions.

        Les répartitions sont ajoutées à l’ensemble de la formule via la boîte de dialogue Gérer les répartitions , disponible une fois l’indicateur enregistré. Voir Étape 11.
        Utiliser dans la méthode Renvoie un identificateur unique au lieu du score de cet indicateur. Cochez cette case lorsque vous spécifiez un indicateur pour une méthode dans la formule. Ces méthodes permettent d’obtenir les valeurs calculées pour l’indicateur à partir du Centre d'analyse. Pour plus d’informations sur l’utilisation de ces méthodes, reportez-vous à la section Obtenir les méthodes d’analyse dans les formules.

        Vous pouvez ajouter des indicateurs manuellement. Toutefois, en utilisant la fonction Parcourir pour rechercher un indicateur , vous vous assurez de disposer de la notation appropriée pour les indicateurs et les éléments de répartition.

        Une fois l’indicateur de formule enregistré, les indicateurs de la formule apparaissent dans la liste connexe Indicateurs de contribution . Si vous avez inclus des indicateurs de formule, leurs indicateurs de contribution sont également répertoriés.
      3. Ajoutez des opérateurs mathématiques et des symboles à la formule selon vos besoins.

        Entrez les opérateurs ou les nombres à inclure dans la formule. Utilisez des symboles d’opérateur valides, tels que +, -, /, %, > <. Vous pouvez également ajouter d’autres indicateurs à la formule. Par exemple, pour calculer l’âge moyen des incidents ouverts sur la base de l’âge cumulé des incidents ouverts et du nombre d’incidents ouverts, utilisez la formule suivante : [[Âge cumulé des incidents ouverts]] / [[Incidents ouverts]] / 24

        Pour spécifier une période de collecte de données dans la formule, vous pouvez utiliser les variables score_start et score_end pour désigner respectivement le début et la fin de la période de collecte de données. Cependant, voir les mises en garde dans Changements apportés à l’score_start/à la fin en raison de fuseaux horaires utilisateur différents.
        Avertissement :
        Essayez de ne pas utiliser GlideRecords ou GlideAggregates dans les scripts Analyse des performances ou les indicateurs de formule. Bien que vous deviez parfois utiliser ces opérations pour obtenir les informations dont vous avez besoin, elles sont coûteuses et risquent de s'exécuter des centaines de milliers de fois. Assurez-vous qu'il n'existe aucune alternative avant de les utiliser.
    7. Dans l’onglet Contrôle d’accès , indiquez s’il faut enregistrer cet indicateur dans la bibliothèque et s’il faut limiter la visibilité de l’indicateur par utilisateur, groupe ou rôle.
    8. Dans l’onglet Other (Autre ), définissez Miscellaneous properties (Propriétés diverses).
      Ces propriétés s’appliquent à l’ensemble de l’indicateur de formule.
      Tableau 2. Champs de l’onglet « Autre »
      Champ Description
      Séries chronologiques par défaut Fonction analytique prédéfinie, telle qu’une moyenne cumulée sur 7 jours. Selon que l’option Appliquer les séries chronologiques au résultat est activée, cette série chronologique peut s’appliquer soit à chaque indicateur de composant avant le calcul du résultat, soit au résultat.
      Profil de groupe actif

      Enregistrement de profil de groupe actif [live_group_profile] pour un groupe Flux en direct. Spécifiez un profil de groupe pour que ce groupe reçoive des notifications sur cet indicateur.

      Pour en savoir plus sur cette application sociale, consultez la ServiceNow AI Platform rubrique Flux en direct.
      Ordre

      Nombre indiquant l’ordre dans lequel les indicateurs sont affichés dans le Centre d'analyse. Les indicateurs avec la valeur la plus faible sont affichés en haut de la liste. Si aucune valeur n’est fournie dans le champ Commande , les indicateurs s’affichent de a à z dans le champ Nom . Pour utiliser le champ Commande, vous devez saisir des numéros de commande pour tous les indicateurs. Si vous entrez des chiffres pour seulement quelques indicateurs, l’ordre dans lequel les indicateurs sont affichés revient de a à z.

      Non utilisé dans l’expérience Platform Analytics .
      Afficher des lignes continues

      Lorsque cette option est sélectionnée, le Centre d'analyse et Détails des KPI affiche des lignes de données ininterrompues pour cet indicateur, même en l’absence de données pour une date spécifique. Ce comportement peut être utile lors de l’affichage d’ensembles de données avec des dates de début variables ou pour des données qui ne sont pas régulièrement mises à jour, telles que les informations de stock.

      Les lignes continues ne sont pas rendues lorsqu’une série chronologique est définie sur l’indicateur ou sur le Centre d'analyse ou Détails des KPI.
      Appliquer les séries chronologiques au résultat Applique une agrégation de série chronologique au résultat du calcul de la formule plutôt qu’à chaque indicateur de composant avant le calcul. Cette option s’applique à une série temporelle sélectionnée pour l’indicateur sur un widget ou sur le Centre d'analyse. Si une série chronologique par défaut est spécifiée pour l’indicateur, cette option s’applique également à cette série chronologique. Pour plus d'informations, consultez Application de séries chronologiques au résultat ou aux indicateurs de contribution.
      Autoriser une valeur NULL pour le composant de formule La formule est calculée même si le score est nul. Utile pour le dépannage. Pour plus d'informations, consultez Indicateurs de détection sans score dans une formule.
      Autoriser l'agrégation de plusieurs scores d'éléments de répartition Active les widgets pour afficher le score cumulé de plusieurs éléments de répartition sur cet indicateur. Si ce champ est sélectionné, vous pouvez sélectionner des valeurs agrégées ou séparées sur le formulaire pour un tableau de bord de répartition qui utilise cet indicateur. Les formules basées sur l’addition, la soustraction ou la multiplication sont généralement de bons candidats pour permettre l’agrégation. Les pourcentages sont également pris en charge, à condition que le total des pourcentages atteigne 100 %. Par contre, les résultats de l’agrégation d’éléments en moyennes, ou de pourcentages qui ne sont pas liés, ne sont généralement pas significatifs.
      Avertissement :
      La validité mathématique de ces agrégations n’est pas vérifiée.
    9. Facultatif : Dans l’onglet Prévision , définissez la méthode de prévision, le nombre de périodes de collecte de données à prévoir, la quantité de données historiques sur laquelle baser la prévision et les limites supérieure et inférieure des valeurs de prévision.
      Pour plus d'informations, consultez Prévisions des scores d’Analyse des performances.
    10. Développez le menu contextuel et cliquez sur Enregistrer.

      Option Enregistrer dans le menu contextuel
    11. Pour appliquer une répartition à l’indicateur de formule complet, cliquez sur Gérer les répartitions en haut de la page.
      Par défaut, vous pouvez appliquer uniquement les répartitions configurées pour chaque indicateur de contribution dans la formule.
      Remarque :
      La propriété com.snc.pa.formula_indicator_valid_breakdown système contrôle ce comportement. Par défaut, la valeur est vrai. Le remplacer par faux vous permet d’appliquer une répartition à un indicateur de formule lorsqu’au moins un indicateur de contribution utilise cette répartition. Tente d’afficher les scores des répartitions non prises en charge dans un widget, le Centre d'analyse ou Détails des KPI entraîne un message d’avertissement au lieu d’une valeur.

      Vous ne pouvez pas sélectionner un élément de répartition dans l’enregistrement de l’indicateur de formule. Vous pouvez sélectionner la répartition La répartition ne peut être utilisée qu’de manière interactive, c’est-à-dire sur le , Détails des KPI, les widgets configurés de manière appropriée et les Centre d'analyse tableaux de bord de répartition. Pour plus d’informations sur l’utilisation de l’outil Gérer les répartitions, reportez-vous à la section Affecter et mapper les répartitions.

    Croissance du backlog des incidents

    En tant que gestionnaire d’incidents, vous souhaitez améliorer l’efficacité de la résolution des incidents. Vous suivez déjà les incidents nouveaux et résolus en tant qu’indicateurs Nombre de nouveaux incidents et Nombre d’incidents résolus. Toutefois, ces indicateurs ne vous indiquent pas si vous atteignez votre objectif d’amélioration de la résolution des incidents.

    Vous avez besoin d’un nouveau KPI de croissance du backlog pour mesurer le volume d’incidents en suspens. Pour implémenter ce KPI, vous créez un indicateur de formule nommé Croissance du backlog d’incidents, avec la formule suivante : 
    [[Number of new incident]] - [[Number of resolved incidents]]

    Enregistrement d’indicateur de croissance du backlog de sprint des incidents.
    En activant l’option Afficher dans la bibliothèque, vous rendez l’indicateur visible dans Détails des KPI. Dans le panneau d’informations sur Détails des KPI, vous pouvez voir la formule utilisée dans l’indicateur.
    Indicateur de croissance du backlog d’incidents dans Détails des KPI