Ajouter un filtre JavaScript dynamique

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

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 créer 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.

Ce tableau répertorie les opérateurs pris en charge par chaque type de champ qui prend en charge les filtres JavaScript. Les types de champs qui ne figurent pas dans cette table ne prennent pas en charge les filtres JavaScript et le champ Valeur du générateur de conditions pour ces types de champs n’a pas la possibilité de coller vos propres instructions.

Type de champ	Opérateurs autorisés	Type de données 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 est », « 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 délimité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 totale 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 à inclure 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 à inclure.
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 « is one of », 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) être 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) être dans le champ Script.
Script (côté serveur)
Script
Nom court de la table	« est », « n’est pas »	Valeur textuelle (moins de 40 caractères). Pour l’opérateur « is one of », le type de retour attendu est soit une liste de valeurs textuelles délimité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 délimitées par des virgules, soit un tableau contenant chaque nom de champ à inclure dans les résultats.

Procédure

1. Accédez à la Tous > Platform Analytics > Bibliothèque > Visualisations des données.
2. Ouvrez la visualisation de données à laquelle vous souhaitez ajouter le filtre dynamique, puis sélectionnez Modifier.
3. Dans le panneau Configuration , sélectionnez la source de données que vous souhaitez filtrer.
4. Dans la section Filtres, créez 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 ».
   • Les champs de liste ne prennent pas en charge les filtres JavaScript dynamiques.
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 une inclusion 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’inclusion 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.