Créer un filtre interactif de champ de référence

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Un filtre interactif de champ de référence permet aux utilisateurs de filtrer les widgets de rapports en fonction de la valeur d’un champ de référence.

    Avant de commencer

    Rôle requis : hp_publisher_admin et report_admin. Le rôle hp_publisher_admin existe uniquement pour la gestion des filtres interactifs. Par défaut, il ne contient aucun autre rôle et n’est contenu dans aucun autre rôle.

    Lorsqu’un utilisateur sélectionne Tout, il ne voit pas un rapport avec toutes les options de filtre appliquées, il voit le rapport non filtré. Cet exemple de filtre de référence fournit des options de filtre à partir du champ Groupe d’affectation de la table Groupe [sys_user_group].
    Exemple de filtre de liste de référence avec l’option Tous sélectionnée
    Remarque :
    Si le filtre interactif a une valeur par défaut ou spécifie la dernière valeur sélectionnée, les tableaux de bord non réactifs n’appliquent pas automatiquement cette valeur. Cette fonctionnalité n’est disponible que sur les tableaux de bord réactifs.

    Procédure

    1. Facultatif : Vérifiez les filtres interactifs existants sur la même table.
      1. Accédez à la Tout > Rapports > Administration > Filtres interactifs et sélectionnez un filtre interactif basé sur la table que celle que vous souhaitez filtrer.
      2. Sous Liens connexes, sélectionnez Autres filtres dans la table.
      3. Passez en revue les autres filtres disponibles sur la même table pour voir si le filtre souhaité existe déjà.
    2. Accédez à la Tout > Rapports > Administration > Filtres interactifs.
    3. Cliquez sur Nouveau.
    4. Dans la liste Filtre basé sur , sélectionnez Référence.
      Filtre basé sur la liste avec référence sélectionnée
    5. Dans la liste Table de référence , sélectionnez la table qui stocke les enregistrements référencés que vous souhaitez filtrer.
    6. Facultatif : Sélectionnez une valeur par défaut pour le filtre.
      Cette valeur par défaut est appliquée automatiquement pour tous les utilisateurs. Les valeurs qu’un utilisateur sélectionne remplacent la valeur par défaut globale pour cet utilisateur. Vous pouvez spécifier plus d’une valeur par défaut lors de l’utilisation d’un type de contrôle d’interface utilisateur qui active plusieurs sélections, telles que Sélectionner plusieurs entrées.
      Remarque :
      Pour transmettre plus de 50 valeurs par défaut, ou si l’erreur Ceci dépasse la limite d’appel GET, créez plusieurs filtres interactifs.
    7. Définissez les champs suivants :
      Nom Description
      Nom Attribuez un nom au filtre. Ce nom apparaît sur le widget de tableau de bord du filtre.
      Rechercher un nom Entrez un nom de recherche pour le filtre. Ce nom apparaît dans le menu Ajouter du contenu pour les utilisateurs qui ajoutent un filtre à un tableau de bord. Utilisez ce nom pour organiser vos filtres. Si vous ne spécifiez pas de nom de recherche, la valeur Nom est utilisée à la place.
      Description Saisissez une description du filtre.
      Type de contrôle d'interface utilisateur Sélectionnez la façon dont les options de filtrage disponibles pour ce filtre s’affichent sur le widget de tableau de bord. Consultez Types de contrôles d’interface utilisateur de filtre interactif disponibles.

      Afficher uniquement les résultats de recherche commençant par le mot clé

      Lorsque cette option est sélectionnée, les recherches renvoient uniquement les résultats commençant par le terme recherché. Dans le cas contraire, les recherches renvoient des résultats qui contiennent le terme recherché n’importe où. Envisagez cette option lorsque vous configurez un filtre de référence sur une très grande table, par exemple une table contenant des millions d’enregistrements. Une recherche sur un terme courant peut renvoyer trop d’enregistrements à gérer.
    8. Facultatif : Sélectionnez Appliquer un filtre aux vues et aux tables de base de données pour appliquer le filtre aux widgets en fonction des vues et des tables de base de données.
      Remarque :
      Il n’est pas possible d’appliquer des filtres aux tables qui étendent les tables de la vue de base de données. Pour plus d'informations, consultez Filtres interactifs sur les vues de base de données et les hiérarchies de tables.
    9. Cliquez avec le bouton droit de la souris sur l'en-tête du formulaire, puis sélectionnez Enregistrer.
    10. Facultatif : Si le type de contrôle d’interface utilisateur est Sélectionner une entrée unique, sélectionnez l’option Supprimer tout pour configurer le filtre interactif sans l’option Tout.
      Lorsqu’un utilisateur sélectionne Tout, il ne voit pas un rapport avec toutes les options de filtre appliquées, il voit le rapport non filtré.
    11. Dans la liste connexe des références de filtres interactifs , sélectionnez Nouveau.
      Cette liste connexe n’apparaît pas tant que vous n’avez pas enregistré le filtre.
    12. Dans le champ Table de référence , sélectionnez une table contenant des rapports que vous souhaitez filtrer.
    13. Sélectionnez le champ de référence sur lequel filtrer.

      Le champ doit référencer la table spécifiée dans le champ de table de référence du filtre parent.

      Vous pouvez remonter pas à pas à partir des champs qui référencent d’autres tables. Par exemple, si la table de référence du filtre parent est Département [cmn_department], vous pouvez sélectionner Incident comme table de référence de référence, puis sélectionner Département de l’appelant comme champ de référence.

      Remarque :
      Les filtres interactifs de référence ne prennent pas en charge les champs de chaîne.
    14. Facultatif : Ajouter une condition de liste connexe.
      Vous pouvez ajouter une condition à votre filtre en fonction des enregistrements d’une table connexe.
      1. Cliquez sur le lien intitulé Supérieur ou égal à 1.
        Dans la liste, sélectionnez le nombre d’enregistrements de la table source qui doivent être liés à un enregistrement de la table cible.
        Les options sont les suivantes :
        • Supérieur ou égal à
        • Supérieur à
        • Inférieur ou égal à
        • Inférieur à
        • Égal à
        • Aucun
        • Entre
        Liste connexe des valeurs de condition
      2. Choisissez la table connexe.
      3. Spécifiez les conditions de cette table qui doivent être remplies pour que le filtre soit valide.
    15. Cliquez sur Envoyer.

    Que faire ensuite

    Répétez les étapes 10 à 13 au besoin pour chaque champ de référence sur lequel vous souhaitez filtrer. Une fois le filtre créé, ajoutez-le à un tableau de bord.
    Remarque :
    Un filtre peut être converti du type de contrôle Case à cocher au type de contrôle Sélectionner plusieurs entrées pour des raisons de performance.
    1. Une fois le filtre créé, ajoutez-le à un tableau de bord.
    2. Dans le tableau de bord, sélectionnez l’icône Modifier le widget (Icône Modifier les colonnes) sur chaque visualisation du tableau de bord qui doit suivre le filtre, puis sélectionnez Suivre le filtre interactif.