Créer une option de filtre dynamique

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 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
    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.