--- 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 --- # Scripting dans Analyse des performances # Scripting dans Analyse des performances {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#pa-scripts__section_ysl_gw2_nsb} * 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](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). * 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é](https://community.servicenow.com/community?id=community_blog&sys_id=2f99990fdbee5b00fece0b55ca9619fb). * 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. {#pa-scripts__ul_mcf_gws_yjb} 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 {#pa-scripts__section_bdq_kw2_nsb} 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 {#pa-scripts__section_krh_nw2_nsb} 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](https://servicenow-prod.fluidtopics.net/Xe4tL1BQuWUURGLDpBQh4g#pa-scripts "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.") 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 . **Tâches associées** * [Créer un mappage de répartition sur un enregistrement de répartition](https://servicenow-prod.fluidtopics.net/3gcZybtsARFKfxiTspwP2g "Spécifiez quel champ de la source d’indicateur fait référence à la source de répartition. Si aucun champ approprié n’est disponible, spécifiez un script pour interroger la source de l’indicateur.") **Information associée** * [Liste des API incluses dans le périmètre du serveur](https://developer.servicenow.com/dev.do#!/reference/api/tokyo/server) ## Créer un script dans Performance Analytics {#ariaid-title2} 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 ToutAnalyse des performancesScripts 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. {#create-script-pa__ul_h32_xzl_sbb} ### 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 {#ariaid-title3} 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. {#r_ScriptsForAutomatedBreakdowns__ul_lkr_qk2_jp} 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. **Concepts associés** * [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** * [Obtenir des méthodes d'analyse dans des formules](https://servicenow-prod.fluidtopics.net/gekYfxEcesKcyDAXeSe38Q "Pour insérer une valeur calculée à partir de dans Centre d'analyse une formule, utilisez une méthode dans la formule.") **Information associée** * [GlideDateTime - Dans le champ d'application](https://developer.servicenow.com/app.do#!/api_doc?v=paris&id=c_GlideDateTimeScoped)