Scripting dans Analyse des performances

  • Rversion finale: Xanadu
  • Mis à jour 1 août 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 à mapper des répartitions ou à calculer 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 le 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 améliorer les performances.
    • Essayez d’utiliser des includes de script pour les fonctions courantes. Pour plus d’informations, consultez Includes de script.
    • Si les données ne sont pas structurées comme vous en avez besoin pour le reporting, essayez d’ajouter des « champs de reporting » 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, sauf si vous disposez 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’indicateur

    Un script de mappage de répartition renvoie généralement un sys_id d’un élément de répartition ou un entier pour placer le score dans une catégorie. Les scripts d’indicateur 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 l’exemple du 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 de 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 des tables, vous devez également disposer du rôle administrateur approprié pour cette application.

    Procédure

    1. Accédez à la Tout > Analyse des performances > Scripts et cliquez sur Nouveau.
    2. Donnez un nom descriptif au script.
    3. Sélectionnez la table de faits à laquelle le script s’applique.
      Seuls les indicateurs qui utilisent la même table des faits peuvent utiliser ce script.
    4. Sélectionnez les champs de 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 sur les variables Performance Analytics.
      • Lorsque vous utilisez un champ dans le script, vous utilisez le nom de colonne. Si nécessaire, rechercher le nom de colonne dans la table de faits.
      • Lorsque vous utilisez un champ à partir 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 inclut 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 sous la forme 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 mappage de répartition ou un formulaire d’indicateur en cliquant sur Nouveau dans l’onglet du mappage de répartition ou de l’indicateur. Les mappages de répartitions 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 des scores de l’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 des scores de l’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 la 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 la 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 de début et de fin sont liées à la période collectée. 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.