Créer une option de filtre dynamique

Les options de filtre dynamique améliorent le filtrage en permettant aux utilisateurs d’exécuter des script includes existants ou JavaScript sur un champ de référence dans les créateurs de condition 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 option de filtre dynamique et un script include associé.

Les options de filtre dynamique « objectivent » les script includes/JavaScript, ce qui leur permet d’être réutilisés dans plusieurs créateurs de condition 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 s’appliquent 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 (dynamique) existante (créateur de condition 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 des créateur 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 créateur de conditions préexistantes disponibles, 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 dans les conditions de politique d’interface utilisateur.

Figure 1. Opérandes dynamiques

Procédure

1. Créez un filtre scripté en tant que script include 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. Cliquez sur Nouveau.
4. Complétez 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 script include 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.
   Ordre	Entrez 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 le script include client-pouvant être appelé ou la règle métier que vous avez créé pour le filtre scripté. Si le champ Script contient JavaScript, une requête codée ou l’intégralité de la référence au script include/règle métier, ce champ peut être vide.
   Disponible pour le filtre	Sélectionnez cette option pour afficher l’option de filtre dynamique sous forme de 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 en tant que qualificatif de référence dynamique.

   Remarque :

   Les filtres dynamiques utilisant les méthodes GET de l’API de table dans les scripts ne fonctionnent que lorsque le même utilisateur est configuré dans le profil d’authentification de base est utilisé. 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