Créer une option de filtre dynamique

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • 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 include de script associé.

    Les options de filtre dynamique « objectivent » 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 existant (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 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 du générateur de conditions préexistantes disponibles, voir Opérateurs dynamiques.
    Remarque :
    Les filtres dynamiques sont pris en charge dans les applications incluses dans le périmètre, mais pas dans les conditions de politique d’interface utilisateur.
    Figure 1. Opérandes dynamiques
    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. Sélectionnez 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 (aucune inclusion de script nécessaire) ou l’appel complet de script include/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 Entrez un nombre pour désigner le placement 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.
      Actives 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 du JavaScript, une requête codée ou l’intégralité 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 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 la sélection de l’option de filtre dynamique comme 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 lorsqu’ils utilisent le 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. Sélectionnez Envoyer.