La commande ORDER BY ATTRIBUTE trie (réorganise) les enregistrements de la sélection courante de laTable pour le process courant, basé sur les contenus des cheminAttribut des champObjet. Après réorganisation des enregistrements, le nouveau premier enregistrement de la sélection courante devient l'enregistrement courant.

Si vous omettez le paramètre laTable, la commande s'applique à la table par défaut, si celle-ci a été spécifiée. Sinon 4D utilise la table du premier champ passé en paramètre.

Dans champObjet, passez le champ Objet dont vous voulez utiliser l'attribut pour le tri. Ce champ peut appartenir laTable ou à une table en lien Aller à partir de laTable, avec un lien automatique ou manuel. Dans ce cas, le tri est toujours séquentiel.

Dans le paramètre cheminAttribut, indiquez le chemin d'accès de l'attribut dont vous souhaitez utiliser les valeurs pour trier les enregistrements, par exemple "children.girls.age".

Notes  :

• Seuls les attributs contenant des valeurs scalaires (nombres, textes, booléens, date) peuvent être triés. Les autres types de valeurs (objet, image...) sont considérés comme des valeurs null.
• Vous ne pouvez pas passer un élément de tableau dans cheminAttribut (dans ce cas, une erreur est retournée).
• N'oubliez pas que les noms des attributs sont sensibles à la casse : "MonAtt" et "monAtt" sont des noms d'attributs différents dans le même enregistrement.
• Vous ne pouvez pas rechercher des attributs dont le nom contient des caractères spéciaux tels que "." ou "[ ]", car ils seront incorrectement interprétés comme des tokens dans la chaîne de tri. Pour plus d'informations, veuillez consulter le paragraphe Identifiants de propriétés d'objets.

Si l'attribut du champ contient des valeurs de types différents (c'est-à-dire nombres, textes, booléens...), elles sont d'abord regroupées par type, puis par valeur.

Si la valeur d'un attribut de champ est null pour des enregistrements (c'est-à-dire la valeur de l'attribut est null ou cheminAttribut n'existe pas dans le champ) :

• Si l'ordre est ascendant (>), les enregistrements avec valeur null  seront placés au début de la sélection.
• Si l'ordre est descendant (<), les enregistrements avec valeur null seront placés à la fin de la sélection.

Vous pouvez trier la sélection sur un ou plusieurs niveaux. Pour chaque niveau de tri, vous précisez un champObjet, un cheminAttribut et un ordre de tri > ou <. Si vous passez le symbole "plus grand que" (>), le tri sera ascendant. Si vous passez le symble "plus petit que" (<), le tri sera descendant. Si vous ne spécifiez pas d'ordre de tri, le tri sera ascendant par défaut.
Si un seul champ est précisé (un niveau de tri) et que celui-ci est indexé, l'index est utilisé pour le tri. Si le champ n'est pas indexé ou que vous utilisez plus d'un champ, le tri est exécuté séquentiellement.

Pour les tris multiples (tris sur plusieurs champs), vous pouvez appeler la commande ORDER BY ATTRIBUTE autant de fois que nécessaire et utiliser le paramètre optionnel *, excepté pour le dernier appel de ORDER BY ATTRIBUTE, qui lance l'opération de tri. Cette fonctionnalité est utile pour la gestion du multi-tri dans des interfaces utilisateurs personnalisées. Notez que vous pouvez combiner les appels à la commande ORDER BY ATTRIBUTE avec les appels à la commande ORDER BY.

Note : Avec cette syntaxe, vous ne pouvez passer qu'un seul niveau de tri (champ) pour l'appel à ORDER BY ATTRIBUTE.

Quelle que soit la façon dont le tri a été défini, si l'opération de tri doit prendre du temps, 4D affiche automatiquement un message avec thermomètre de progression. L'affichage de ce message peut être contrôlé grâce aux commandes MESSAGES ON et MESSAGES OFF. Si le thermomètre de progression est affiché, l'utilisateur peut cliquer sur le bouton Stop pour interrompre le tri. Si le tri n'est pas interrompu, la variable OK passe à 1. Sinon, si le tri est interrompu, la variable OK passe à 0 (zéro).

Vous souhaitez trier la sélection courante par âge (descendant) puis par nom (ascendant). L'ordre par défaut est :

// [Customer]OB_Info contient un export partiel
{"LastName":"Giorgio","age":33,"client":true},
{"LastName":"Sarah","age":42,"client":true},
{"LastName":"Mikken","age":"Forty-six","client":true},
{"LastName":"Wesson","age":44,"client":true},
{"LastName":"Johnson","age":44,"client":false},
{"LastName":"Hamp","age":"Sixty","client":true},
{"LastName":"Smeldorf","age":33,"client":true},
{"LastName":"Martin","client":true],
{"LastName":"Evan","age":36,"client":true},
{"LastName":"Collins","age":33,"client":true,"Sex":"female"},
{"LastName":"Garbando","age":60,"client":false,"Sex":"male"},
{"LastName":"Smeldorf","age":54,"client":true},
{"LastName":"Smith","age":42,"client":true},
{"LastName":"Jones","age":52,"client":true},
{"LastName":"Kerrey","age":44,"client":true},
{"LastName":"Gordini","client":true},
{"LastName":"Delaferme","age":54,"client":true},
{"LastName":"Belami","age":"Forty-six","client":true},
{"LastName":"Smeldorf","age":22,"client":true},
{"LastName":"Smeldorf","age":70,"client":true}

Après exécution du tri :

Les enregistrements sont dans l'ordre suivant :

{"LastName":"Smeldorf","age":70,"client":true}
{"LastName":"Garbando","age":60,"client":false,"Sex":"male"},
{"LastName":"Delaferme","age":54,"client":true}, 
{"LastName":"Smeldorf","age":54,"client":true},
{"LastName":"Jones","age":52,"client":true},
{"LastName":"Johnson","age":44,"client":false},
{"LastName":"Kerrey","age":44,"client":true},
{"LastName":"Wesson","age":44,"client":true},
{"LastName":"Sarah","age":42,"client":true},
{"LastName":"Smith","age":42,"client":true},
{"LastName":"Evan","age":36,"client":true},
{"LastName":"Collins","age":33,"client":true,"Sex":"female"},
{"LastName":"Giorgio","age":33,"client":true},
{"LastName":"Smeldorf","age":33,"client":true},
{"LastName":"Smeldorf","age":22,"client":true},
{"LastName":"Hamp","age":"Sixty","client":true}, //les valeurs de type chaîne dans age
{"LastName":"Belami","age":"Forty-six","client":true}, //sont gérés séparément
{"LastName":"Mikken","age":"Forty-six","client":true}
{"LastName":"Gordini","client":true}, //en fin car
{"LastName":"Martin","client":true} //age est null (manquant)