Créer une option de filtre dynamique

Les options de filtre dynamique améliorent le filtrage en permettant aux utilisateurs d’exécuter des includes de script existants ou JavaScript sur un champ de référence dans les générateurs de conditions et les qualificatifs de référence dynamiques.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Cette tâche décrit comment créer une nouvelle option de filtre dynamique et un script include associé.

Les options de filtre dynamique « objectent » les includes de script/JavaScript, ce qui leur permet d’être réutilisées dans plusieurs générateurs de conditions et qualificatifs de référence dynamiques. Ce type de filtre vous permet de modifier un script une seule fois et de faire en sorte que les modifications prennent effet automatiquement partout où l’option de filtre dynamique est utilisée.

Lors de la définition d’un filtre dynamique, vous pouvez :

• Utiliser une option de filtre dynamique IS existante (dynamique) (générateur de conditions uniquement)
• utiliser une option de filtre dynamique existante (OOB ou personnalisé)
• créer une nouvelle option de filtre dynamique et un script include/JavaScript

Tous les filtres dynamiques de générateur de conditions utilisent l’opérateur is (dynamique) et appellent une option de filtre dynamique. Dans l’exemple suivant, l’option de filtre dynamique préexistante Me est utilisée. Pour obtenir la liste des options de filtre dynamique de générateur de conditions préexistantes disponibles, consultez Opérateurs dynamiques.

Remarque :

Les filtres dynamiques sont pris en charge dans les applications incluses dans le périmètre, mais ils ne le sont pas dans les conditions de politique d’interface utilisateur.

Figure 1. Opérandes dynamiques

Procédure

1. Créez un filtre scripté en tant qu’include de script ou règle métier pouvant être appelé par un client.
2. Accédez à la Définition du système > Options de filtre dynamique.
3. Sélectionnez Nouveau.
4. Renseignez le formulaire.

   Tableau 1. Options de filtre dynamique

   Champ	Description
   Étiquette	Entrez un nom descriptif pour l’option de filtre dynamique.
   Script	Entrez le nom de la fonction que vous avez créée, JavaScript (aucun include de script nécessaire) ou l’appel de script include/règle métier complet, tel que new GlobalCanvasUtil().refQualPaTabs().
   Type de champ	Sélectionnez Référence.
   Table référencée	Sélectionnez la table à laquelle cette option de filtre dynamique s’applique.
   Commande	Entrez un nombre pour désigner l’emplacement de cette option de filtre dynamique dans la liste de choix d’options de filtre.
   Rôles	Sélectionnez le rôle qu’un utilisateur doit avoir pour voir cette option.
   Actif	Activez ou désactivez l’option.
   Script de référence	Facultatif. Sélectionnez l’include de script ou la règle métier appelable par le client que vous avez créé pour le filtre scripté. Si le champ Script contient JavaScript, une requête codée ou la totalité de la référence à l’include de script/à la règle métier, ce champ peut être vide.
   Disponible pour le filtre	Sélectionnez cette option pour afficher l’option de filtre dynamique comme fil d’Ariane de filtre.
   Disponible pour la valeur par défaut	Sélectionnez cette option pour permettre à l’option de filtre dynamique d’être une option par défaut dans une entrée de dictionnaire.
   Disponible pour la qualif. de réf.	Sélectionnez cette option pour permettre à l’option de filtre dynamique d’être sélectionnée comme qualificatif de référence dynamique.

   Remarque :

   Filtres dynamiques utilisant l’API de table Les méthodes GET dans les scripts fonctionnent uniquement lors de l’utilisation du même utilisateur configuré dans le profil d’authentification de base. Pour permettre à plusieurs utilisateurs d’accéder aux filtres dynamiques, utilisez plutôt les API JavaScript globales telles que les API GlideRecord et GlideQuery.
5. Sélectionnez Soumettre.

Tâches associées

• Créer et modifier des filtres
• Supprimer les filtres
• Créer des filtres par script