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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 selon 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 du dictionnaire isOrder .
    • Le champ Ordre , s’il y en a un dans la table.
    • Le champ Nombre , s’il y en a un dans la table.
    • Le champ Nom s’il y en a un dans la table.
    • Champ spécifié comme 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 utilisateur <table>.db.order et <table>.db.order.direction déterminent le champ et le sens de tri vus 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é. Pour ce faire, ajoutez un attribut appelé isOrder avec la valeur 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 selon cette colonne, cette action est mémorisée. La prochaine fois que cette liste s’affichera, le même champ sera utilisé pour trier la liste.

    Ce champ de tri mémorisé peut être remplacé par l’ajout d’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 selon plusieurs champs, supprimez tous les éléments du champ de filtre et placez-les dans le champ Arguments. Par exemple, si le filtre spécifie [Active] [is] [true] et que vous souhaitez trier 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.