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 par rapport à 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 : administrateur

Pourquoi et quand exécuter cette tâche

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

Les options de filtre dynamique « objectivent » les includes de script/JavaScript, ce qui leur permet d’être réutilisés 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 d’appliquer automatiquement les modifications 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 (dynamique) existante (Créateur 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 du 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 préexistantes du générateur de conditions, reportez-vous à la section Opérateurs dynamiques.

Remarque :

Les filtres dynamiques ne sont pas pris en charge dans les applications incluses dans le périmètre ou 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 le client.
2. Accédez à la Définition du système > Options de filtre dynamique.
3. Cliquez sur Nouveau.
4. Renseignez le formulaire.

   Tableau 1. Options de filtre dynamique

   Champ	Description
   Étiquette	Saisissez 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 complet d’include de script/règle métier, 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.
   Ordre	Saisissez un nombre pour désigner l’emplacement de cette option de filtre dynamique dans la liste de choix des 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 pouvant être appelé par le client ou la règle métier que vous avez créée pour le filtre scripté. Si le champ Script contient JavaScript, une requête codée ou l’intégralité de l’include de script/de la référence à 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 autoriser l’option de filtre dynamique à ê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 en tant que qualificatif de référence dynamique.

   Remarque :

   Les filtres dynamiques utilisant l’API de table Les méthodes GET dans les scripts ne fonctionnent que 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 des API JavaScript globales telles que les API GlideRecord et GlideQuery.
5. Cliquez sur Envoyer.

Tâches associées

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