Scripting dans Analyse des performances

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture

    • Analyse des performances fournit plusieurs objets de script à utiliser dans les scripts et les API pour interroger des Analyse des performances données. Les scripts servent de mappages de répartition ou de calcul d’une valeur à partir d’un indicateur.

    Conseils sur les scripts

    • En général, utilisez des scripts uniquement pour prendre en charge des indicateurs tels que l’âge avec traitement de la date, à l’aide des variables score_start et score_end .
    • Limitez les champs inutiles. Chaque fois que vous incluez un champ de remontée pas à pas supplémentaire, vous ajoutez une jointure supplémentaire à la requête.
    • Essayez de remplacer les répartitions manuelles par des vues de base de données pour obtenir de meilleures performances.
    • Essayez d’utiliser des script includes pour les fonctions courantes. Pour plus d’informations, consultez Script includes.
    • Si les données ne sont pas structurées de la manière dont vous avez besoin pour la génération de rapports, essayez d’ajouter des « champs de génération de rapports » aux tables opérationnelles au lieu de créer des scripts. Pour plus d’informations, consultez cette publication de la communauté.
    • Si vous exécutez un script en arrière-plan qui interroge les Analyse des performances tables de scores ou d’instantanés, vous ne pouvez pas accéder aux données d’une application incluse dans le périmètre à moins de disposer d’un rôle approprié pour cette application.
    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.

    Mappage de répartition et scripts d’indicateurs

    Un script de mappage de répartition renvoie généralement une sys_id d’un élément de répartition ou un entier pour placer le score dans une catégorie. Les scripts d’indicateurs renvoient un score calculé à partir d’un ou de plusieurs champs. Le même script peut servir à la fois de script de mappage de répartition et de script d’indicateur.

    Script de répartition

    Prenons par exemple le script Incident.Age.Days fourni, qui utilise le champ opened_at de la table incident. Ce script sert de mappage de répartition pour la répartition par âge, qui utilise le sous-groupe Tranches d’âges d’incidents (jours) comme source de répartition.

    var diff=function(x,y){return y.dateNumericValue() - x.dateNumericValue();};
var days=function(x,y){return diff(x,y)/(24*60*60*1000);};
days(current.opened_at, score_end);

    Dans cet exemple, current.opened_at obtient l’horodatage de l’ouverture de l’enregistrement actuellement évalué. La variable de script score_end provient du collecteur de données et est liée à la période collectée. Par exemple, si un indicateur mensuel est collecté, le score_end est la fin du mois. Ici, l’horodatage de l’ouverture de l’incident est soustrait de l’horodatage de la fin de la période de collecte et le résultat est converti en jours.

    Cet exemple inclut le champ Incident.opened_at , qui est spécifié dans le champ Champs de ce script. Vous pouvez utiliser score_start et score_end sans les définir dans le champ Champs .

    Créer un script dans Performance Analytics

    Pour créer un script, sélectionnez d’abord la table des faits à laquelle le script s’applique et sélectionnez explicitement tous les champs.

    Avant de commencer

    Rôle requis : admin, pa_admin. Pour accéder aux données des applications incluses dans le périmètre dans Analyse des performances les tables, vous devez également disposer du rôle administrateur approprié pour cette application.

    Procédure

    1. Accédez à la Tous > Analyse des performances > Scripts et cliquez sur Nouveau.
    2. Donnez un nom descriptif au script.
    3. Sélectionnez la table des faits à laquelle le script s’applique.
      Seuls les indicateurs qui utilisent la même table de faits peuvent utiliser ce script.
    4. Sélectionnez les champs de la table de faits, le cas échéant, qui seront utilisés dans le script.
      Vous sélectionnez les champs à l’aide de leurs étiquettes.
    5. Écrivez le script.
      Le script doit respecter les relations et restrictions suivantes :
      • Vous ne pouvez inclure que les champs sélectionnés dans ces variables de formulaire et de script. Pour plus d’informations, consultez la section relative aux variables Performance Analytics.
      • Lorsqu’un champ est utilisé dans le script, le nom de colonne est utilisé. Si nécessaire, recherchez le nom de colonne dans la table de faits.
      • Lorsque vous utilisez un champ provenant d’une vue de base de données, vous devez inclure le préfixe. Par exemple, la vue de base de données incident_sla comprend la table task_sla, avec le préfixe taskslatable. Task_sla inclut la colonne business_duration. Pour utiliser le champ business_duration de la vue de base de données incident_sla, écrivez-le comme taskslatable_business_duration. Si vous n’avez pas accès à la vue de base de données, demandez à votre administrateur système de trouver le préfixe pour vous.

    Que faire ensuite

    Après avoir créé le script, créez un mappage de répartition ou un indicateur qui utilise le script. Vous pouvez ouvrir un formulaire de mappage de répartition ou d’indicateur en cliquant sur Nouveau dans l’onglet du mappage de répartition ou de l’indicateur. Les mappages de répartition et les indicateurs qui utilisent ce script sont répertoriés dans ces onglets.

    Analyse des performances variables

    Plusieurs variables peuvent être utilisées dans Analyse des performances les scripts et les indicateurs de formule.

    Vous pouvez utiliser les variables suivantes dans Analyse des performances les scripts et les formules.

    • score_start : première seconde du jour de la première collecte de score d’indicateur. Pour les scripts, l’heure est calculée en fonction de la différence entre le fuseau horaire de l’utilisateur Exécuter en tant que pour la tâche de collecte et le fuseau horaire de la base de données, qui est GMT. Pour les formules, l’heure est calculée en fonction de la différence entre le fuseau horaire de l’utilisateur qui exécute la formule et GMT. Un utilisateur exécute une formule en affichant l’indicateur de formule dans un widget de tableau de bord ou sur le Centre d'analyse.
    • score_end : dernière seconde du jour de la dernière collecte de score d’indicateur. Le temps est calculé de la même manière que pour score_start.
    • pa : variable de formule, non utilisable dans les scripts, qui fournit un ensemble d’attributs et de Centre d'analyse méthodes.

    Dans les scripts, les variables de début et de fin de collecte de scores sont des objets GlideElementGlideObject . Vous pouvez obtenir un objet GlideDateTime à partir de ces variables en appelant getGlideObject(), comme dans cet exemple : gs.log(« Score main = " + score_end.getGlideObject().getDayOfWeek()) ;

    Dans les formules, les variables de début et de fin de collecte de scores sont déjà des objets GlideDateTime . Par conséquent, vous pouvez utiliser les variables directement sans appeler getGlideObject(), comme dans cet exemple : gs.log(« Score main = " + score_end.getDayOfWeek()) ;

    Les valeurs des variables début et fin sont liées à la période en cours de collecte. Par exemple, si un indicateur mensuel est collecté, le score_end est la fin du mois.

    Les valeurs score_start et score_end sont calculées en fonction du fuseau horaire de l’utilisateur concerné. Pour Analyse des performances les scripts, il s’agit du fuseau horaire Exécuter en tant que pour la tâche de collecte. Pour les formules, il s’agit du fuseau horaire de l’utilisateur qui affiche l’indicateur de formule dans un widget de tableau de bord ou le Centre d'analyse. Les utilisateurs de fuseaux horaires différents peuvent donc avoir des dates différentes pour score_start et score_end dans une formule.