Filtres JavaScript dynamiques

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 7 minutes de lecture

    • Créez des conditions dynamiques en JavaScript que vous pouvez configurer dans le cadre des critères d’une visualisation de rapport au lieu des valeurs spécifiées.

    Pour créer un rapport à l’aide d’une instruction conditionnelle dynamique, vous placez une URL JavaScript dans l’instruction de valeur conditionnelle du filtre. Vous pouvez entrer une commande JavaScript directement dans le champ, mais pour un script plus long qu’une instruction, le script doit être placé dans son propre enregistrement. Vous appelez ensuite une fonction à partir de cet enregistrement dans le champ de valeur de la condition de rapport.

    Ajouter un filtre JavaScript dynamique

    Ajoutez une instruction JavaScript dynamique pour l’évaluation dans le cadre des critères de filtre d’une visualisation de rapport.

    Avant de commencer

    Rôle requis : itil, report_user, report_group, report_global, report_admin ou admin. Pour créer un rapport significatif, vous devez avoir le droit d’accéder aux données sur lesquelles vous souhaitez générer un rapport.

    Pourquoi et quand exécuter cette tâche

    Les filtres JavaScript peuvent être des instructions sur une seule ligne ou des scripts plus longs. Pour les instructions JavaScript plus longues, créez un include de script qui renvoie le format et le type de données corrects, qui est conforme aux données spécifiques que le rapport doit filtrer et qui peut être appelé par le client. Pour plus d’informations, consultez Includes de script.

    Procédure

    1. Effectuez l’une des actions suivantes :
      • Sur une instance mise à niveau qui n’a pas été entièrement migrée vers , accédez à Platform Analytics Tout > Rapports > Afficher/Exécuter.
      • Sur une nouvelle instance ou une instance qui a été entièrement migrée vers , accédez à Platform Analytics Tout > Administration de Platform Analytics > Utilisation et gouvernance > Rapports.
    2. Ouvrez la visualisation du rapport à laquelle vous souhaitez ajouter le filtre dynamique.
    3. Sélectionnez l’icône de filtre () pour développer le générateur de conditions.
    4. Construisez votre condition de filtre.
      Ces combinaisons de types de champs et d’opérateurs vous permettent de spécifier une instruction JavaScript dynamique.
      Remarque :
      • L’opérateur « between » fournit deux champs qui peuvent prendre en charge des URL JavaScript identiques ou différentes.
      • L’opérateur « is » peut renvoyer un tableau d’éléments de données du type attendu. Dans ce cas, l’opérateur est traité comme l’opérateur « est l’un des ».
      Type de champ Opérateurs autorisés Type de données de retour attendu
      ID système (GUID) « est », « n’est pas », « est l’un des », « commence par », « se termine par », « contient », « ne contient pas », « entre », « supérieur ou égal à », « inférieur ou égal à ». Représentation textuelle d’une valeur sys_id totale ou partielle.

      Pour l’opérateur « est l’un des », le type de retour attendu serait soit une liste de valeurs de sys_id séparées par des virgules, soit un tableau contenant chaque sys_id qui doit être inclus dans les résultats.
      Chaîne de texte libre « est », « n’est pas », « est l’un des », « commence par », « se termine par », « contient », « ne contient pas », « entre », « supérieur ou égal à », « inférieur ou égal à » Un ou plusieurs caractères textuels. Pour l’opérateur « est l’un des », le résultat attendu serait soit une liste de valeurs de chaîne séparées par des virgules, soit un tableau contenant chacune des valeurs à inclure dans le champ de valeur de recherche « est l’un des ».
      Référence « commence par », « se termine par », « contient », « ne contient pas » Un ou plusieurs caractères textuels qui peuvent représenter une valeur ou une partie d’une valeur trouvée dans ce champ de la table ou de la source de données.
      Chaîne (faisant référence à une autre table) « contient », « commence par », « se termine par », « ne contient pas » Un ou plusieurs caractères textuels qui peuvent représenter une valeur ou une partie d’une valeur trouvée dans ce champ de la table ou de la source de données.
      Entrée de l'utilisateur « est », « n’est pas » Caractères textuels qui pourraient représenter la valeur complète d’un enregistrement de ce champ dans la table ou la source de données.
      Nom de la table « est », « n’est pas », « est l’un des », « commence par », « se termine par », « contient », « ne contient pas », « entre », « supérieur ou égal à », « inférieur ou égal à » Représentation textuelle d’un nom de table complet ou partiel dans le système. Pour l’opérateur « est l’un des », le type de retour attendu serait soit une liste de valeurs de nom de table séparées par des virgules, soit un tableau contenant chaque nom de table qui doit être inclus dans les résultats.
      Valeur de modèle « est », « n’est pas » Caractères textuels qui rempliront la valeur selon un modèle trouvé sur l’instance.
      ID de domaine « commence par », « se termine par », « contient », « ne contient pas » Un ou plusieurs caractères textuels qui peuvent représenter une valeur ou une partie d’une valeur trouvée dans le champ Domaine de la table ou de la source de données.
      Rôles d'utilisateur « est », « n’est pas » Représentation textuelle d’une valeur de chaîne de rôle d’utilisateur.
      Chemin de domaine « commence par », « se termine par », « contient », « ne contient pas », « est », « n’est pas », « est l’un des », « inférieur ou égal à », « supérieur ou égal à », « entre » Un ou plusieurs caractères textuels qui peuvent représenter une valeur ou une partie d’une valeur trouvée dans ce champ de la table ou de la source de données. Pour l’opérateur « est l’un des », il s’agit soit d’une liste de valeurs textuelles séparées par des virgules, soit d’un tableau d’objets contenant chaque valeur qui doit être incluse.
      Texte traduit « est », « n’est pas », « est l’un des », « commence par », « se termine par », « contient », « ne contient pas », « entre », « supérieur ou égal à », « inférieur ou égal à » Valeur textuelle.

      Pour l’opérateur « est l’un des », le type de retour attendu serait soit une liste de valeurs textuelles séparées par des virgules, soit un tableau de valeurs textuelles.
      Champ traduit
      HTML « contient », « ne contient pas » Valeur textuelle qui pourrait correspondre aux données du champ sélectionné dans ce critère de rapport.
      Modèle HTML
      Envoyer le script par e-mail « contient », « ne contient pas » Valeur textuelle représentant une valeur qui doit (ou ne doit pas) se trouver dans le champ Script d’e-mail.
      Script (brut) « contient », « ne contient pas » Valeur textuelle représentant une valeur qui doit (ou ne doit pas) se trouver dans le champ Script.
      Script (côté serveur)
      Script
      Nom de table court « est », « n’est pas » Valeur textuelle (moins de 40 caractères).

      Pour l’opérateur « est l’un des », le type de retour attendu est soit une liste de valeurs textuelles séparées par des virgules, soit un tableau contenant chaque caractère textuel qui représenterait un nom de table court.
      Nom de champ « est », « n’est pas », « est l’un des », « commence par », « se termine par », « contient », « ne contient pas », « entre », « supérieur ou égal à », « inférieur ou égal à » Représentation textuelle d’une valeur de nom de champ complète ou partielle.

      Pour l’opérateur « est l’un des », le type de retour attendu serait soit une liste de valeurs de nom de champ séparées par des virgules, soit un tableau contenant chaque nom de champ qui doit être inclus dans les résultats.
    5. Choisissez un type de champ et un opérateur, puis entrez une instruction JavaScript.
      • Pour une instruction JavaScript d’une ligne, utilisez le format javascript :<JavaScript_Statement> ;.
      • Pour une instruction JavaScript qui appelle un include de script, utilisez le format javascript :new <Record_Name>().<Function_Name>() ; dans lequel Record_Name correspond au nom d’enregistrement de l’include de script et Function_Name est la fonction de l’include de script qui renvoie la valeur comparée dans le filtre.
      Remarque :
      L’URL Javascript peut également inclure un ou plusieurs paramètres passés à la fonction qui effectue le calcul et renvoie un résultat. Par exemple, une fonction JavaScript qui transmet deux paramètres à l’enregistrement d’include de script pourrait être écrite comme javascript :new TextJSFilter().getGroupIDs(« Professional Services »,"Sales ») ;.

    Que faire ensuite

    Une fois que vous avez ajouté les instructions et conditions JavaScript nécessaires et configuré le reste du rapport, testez le rapport pour vous assurer qu’il renvoie et affiche les résultats attendus.