Contrôle de la séquence de tri utilisée pour afficher les listes

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

    • Toutes les listes ont une séquence de tri par défaut basée sur le type de champs présents dans la liste.

    Lorsqu’un utilisateur affiche une liste pour la première fois, celle-ci est triée en fonction de l’un des éléments suivants.

    • Les arguments ORDERBY ont trouvé l’URL. (Reportez-vous à la section suivante sur le contrôle de l’ordre d’approvisionnement.)
    • Les préférences utilisateur <table>.db.order et <table>.db.order.direction .
    • L’attribut de dictionnaire isOrder .
    • Le champ Commande , s’il est présent dans la table.
    • Le champ Nombre , s’il est présent dans la table.
    • Le champ Nom , s’il est présent dans la table.
    • Champ spécifié en tant que champ d’affichage pour la table.
    Remarque :
    La table de tâches est une exception à la séquence précédente. La tâche et les tables étendues à partir de la tâche utilisent le champ Nombre lorsqu’aucun argument URL ou préférence utilisateur n’est trouvé.

    Définition de l’ordre par défaut avec les préférences utilisateur

    Les préférences <table>utilisateur .db.order et <table>.db.order.direction déterminent le champ et le sens de tri perçus par l’utilisateur. Un tri par défaut peut être créé en créant des enregistrements de préférences utilisateur sans valeur dans le champ Utilisateur et en cochant la case Système . Cette préférence s’applique à tous les utilisateurs qui n’ont pas leur propre préférence.

    Définition de l’ordre de tri par défaut dans le dictionnaire système

    Un administrateur peut définir l’ordre de tri des enregistrements affichés pour une table dans le dictionnaire système lorsqu’aucun autre tri n’est spécifié. Cela se fait en ajoutant un attribut appelé isOrder avec une valeur de true à l’entrée de dictionnaire du champ souhaité. Il s’agit de l’ordre de tri présenté initialement à tous les utilisateurs. Une fois qu’un utilisateur trie une liste, cette préférence utilisateur est enregistrée et la liste est toujours triée pour cet utilisateur en fonction de la préférence de tri précédente.

    Remarque :
    isOrder peut définir quel champ est utilisé pour le tri des listes, mais ne peut pas contrôler le sens de tri.

    Contrôle de l’ordre de tri

    Pour n’importe quelle liste, si l’utilisateur a cliqué sur un en-tête de colonne pour effectuer un tri en fonction de cette colonne, cette action est mémorisée. La prochaine fois que cette liste s’affichera, le même champ sera utilisé pour ordonner la liste.

    Vous pouvez remplacer ce champ de tri mémorisé en ajoutant une spécification sysparm_order à la définition du module. Par exemple, si vous souhaitez que les nouveaux éléments soient répertoriés par ordre d’importance à chaque fois que des actualités s’affichent, le module Actualités peut être mis à jour en conséquence.

    Figure 1. Définir l’ordre de tri du module sur la valeur du champ Importance
    Arguments de module pour définir l’ordre de tri en fonction du champ Importance

    L’ordre réel (croissant ou décroissant) peut être spécifié en ajoutant une spécification sysparm_order_direction . Voici deux exemples de tri d’une liste en fonction du champ sys_created_on , l’un croissant et l’autre décroissant :

    &sysparm_order=sys_created_on &sysparm_order_direction=desc
&sysparm_order=sys_created_on &sysparm_order_direction=asc

    Trier par champs multiples

    Pour trier une liste par plusieurs champs, supprimez tout ce qui se trouve dans le champ de filtre et placez-le dans le champ Arguments. Par exemple, si le filtre spécifie [Actif] [est] [vrai] et que vous souhaitez effectuer un tri par catégorie et sous-catégorie, supprimez la condition et placez ce qui suit dans les arguments du module :

    active=true^ORDERBYcategory^ORDERBYsubcategory

    Cet argument trie d’abord par catégorie, puis par sous-catégorie. Si vous souhaitez qu’un champ soit trié par ordre décroissant, remplacez ORDERBY par ORDERBYDESC.