4D v14.3

TRIER

Accueil

 
4D v14.3
TRIER

TRIER 


 

TRIER ( {laTable ;}{ leChamp }{; > ou < }{; leChamp2 ; > ou <2 ; ... ; leChampN ; > ou <N}{; *} ) 
Paramètre Type   Description
laTable  Table in Table de laquelle réordonner la sélection courante ou Table par défaut si ce paramètre est omis
leChamp  Champ in Champ sur lequel effectuer le tri pour chaque niveau
> ou <  Opérateur in Sens du tri pour chaque niveau : > demander un tri croissant ou < demander un tri décroissant
Opérateur in Attente d'exécution du tri

TRIER trie (réordonne) les enregistrements de la sélection courante de laTable pour le process courant. Une fois le tri effectué, le premier enregistrement de la sélection courante devient le nouvel enregistrement courant.

Si vous omettez le paramètre laTable, la commande s'applique à la table par défaut, si elle a été définie. Sinon, 4D utilise la table du premier champ passé en paramètre. Si vous ne passez pas de paramètre et si aucune table par défaut n'a été définie, une erreur est retournée.

Si vous ne passez ni le paramètre leChamp, ni les paramètres >, < ou *, TRIER affiche la boîte de dialogue de l'Editeur de tri de 4D pour laTable. Cet éditeur est présenté ci-dessous :

Pour plus d'informations sur l'utilisation de cet éditeur, reportez-vous au manuel Mode Développement de 4D.
L'utilisateur construit le tri puis clique sur le bouton Trier. Si le tri est correctement effectué, la variable système OK prend la valeur 1. Si l'utilisateur clique sur Annuler, aucun tri n'est effectué et la variable OK prend la valeur 0 (zéro).

L'exemple suivant affiche la boîte de dialogue de Tri pour la table [Produits] :

 TRIER([Produits])

L'exemple suivant affiche la boîte de dialogue de Tri pour la table par défaut (si elle a été définie) :

 TRIER

Si vous spécifiez les paramètres champ et > ou <, la boîte de dialogue standard de Tri ne s'affiche pas et le tri est entièrement défini par programmation. Vous pouvez trier la sélection courante sur un plusieurs niveaux. Pour chaque niveau de tri, vous passez un champ dans le paramètre champ et un ordre de tri dans > ou <. Si vous passez le paramètre “supérieur à ” (>), l'ordre est croissant. Si vous passez le paramètre “inférieur à ” (<), l'ordre est décroissant.

L'exemple suivant trie la sélection courante de [Produits] par nom dans un ordre croissant :

 TRIER([Produits];[Produits]Nom;>)

L'exemple suivant trie la sélection courante de [Produits] par nom dans un ordre décroissant :

 TRIER([Produits];[Produits]Nom;<)

L'exemple suivant trie la sélection courante de [Produits] par type et par prix dans un ordre croissant à chaque niveau :

 TRIER([Produits];[Produits]Type;>;[Produits]Prix;>)

L'exemple suivant trie la sélection courante de [Produits] par type et par prix dans un ordre décroissant à chaque niveau :

 TRIER([Produits];[Produits]Type;<;[Produits]Prix;<)

L'exemple suivant trie la sélection courante de [Produits] par type dans un ordre croissant et par prix dans un ordre décroissant :

 TRIER([Produits];[Produits]Type;>;[Produits]Prix;<)

L'exemple suivant trie la sélection courante de [Produits] par type dans un ordre décroissant et par prix dans un ordre croissant :

 TRIER([Produits];[Produits]Type;<;[Produits]Prix;>)

Si vous omettez le paramètre d'ordre > ou <, le tri est croissant par défaut.

L'exemple suivant trie la sélection courante de [Produits] par nom dans un ordre croissant :

 TRIER([Produits];[Produits]Nom)

Si un seul champ est spécifié (tri sur un niveau) et s'il est indexé, le tri tire parti de l'index. Si le champ n'est pas indexé ou si plus d'un champ est utilisé, le tri est effectué de manière séquentielle (hors index composites). Le champ peut appartenir à la table de la sélection que vous triez ou à une table 1 liée à table par un lien automatique ou manuel. Dans ce cas, le tri est toujours séquentiel.
Si les champs triés sont inclus dans un index composite, TRIER tire parti de l'index.

L'exemple suivant effectue un tri indexé si le champ [Produits]Nom est indexé :

 TRIER([Produits];[Produits]Nom;>)

L'exemple suivant effectue un tri séquentiel, que les champs soient ou non indexés :

 TRIER([Produits];[Produits]Type;>;[Produits]Prix;>)

L'exemple suivant effectue un tri séquentiel à l'aide d'un champ lié :

 TRIER([Factures];[Société]Nom;>) ` les factures sont triées par ordre alphabétique sur le champ Nom de la société

L'exemple suivant effectue un tri indexé sur deux niveaux si un index composite [Contacts]Nom + [Contacts]Prénom a été défini dans la base :

 TRIER([Contacts];[Contacts]Nom;>;[Contacts]Prénom;>)

Pour indiquer que le tri ne doit pas être immédiatement effectué, passez en dernier paramètre le symbole *. 4D attendra de rencontrer une nouvelle ligne de tri ne se terminant pas par * pour exécuter le tri. Cette possibilité est utile pour gérer les tris multicritères dans le cadre d'interfaces personnalisées.
Attention : lorsque vous utilisez cette syntaxe, vous ne pouvez passer qu'un seul niveau de tri (un seul champ) par ligne d'instruction.

Dans un formulaire sortie affiché en mode Application, vous souhaitez permettre aux utilisateurs de trier une colonne par ordre croissant en cliquant simplement sur son en-tête.
Si l'utilisateur maintient la touche Maj enfoncée et clique ensuite sur plusieurs autres colonnes, le tri est multicritères, c'est-à-dire que les colonnes sont triées sur autant de niveaux qu'il y a de clics :

Chaque en-tête de colonne contient un bouton inversé dont la méthode est du type suivant :

 MULTITRIS(->[CDs]Titre`Bouton de l'en-tête de la colonne Titre

Chaque bouton appelle la méthode projet MULTITRIS en passant un pointeur sur le champ de la colonne. Voici le contenu de la méthode projet MULTITRIS :

  ` Méthode projet MULTITRIS
  ` MULTITRIS (Pointeur)
  ` MULTITRIS (->[Table]Champ)
 
 C_POINTEUR($1)
 C_ENTIER LONG($nbCrit)
 
  `Construction des critères
 Si(Non(Majuscule enfoncee)) `Si le tri est simple
    TABLEAU POINTEUR(tPtrTriChp;1) `Créons un tableau à 1 élément
    tPtrTriChp{1}:=$1 `Champ sur lequel l'utilisateur a cliqué
 Sinon `Si la touche Maj était enfoncée (tri multicritère)
    $nbCrit:=Chercher dans tableau(tPtrTriChp;$1)   `Vérifions que le critère n'est pas déjà présent
    Si($nbCrit<0)   `Critère inexistant
       INSERER DANS TABLEAU(tPtrTriChp;Taille tableau(tPtrTriChp)+1;1) `Remplissons le tableau
       tPtrTriChp{Taille tableau(tPtrTriChp)}:=$1
    Fin de si
 Fin de si
  `Exécution du tri
 $nbCrit:=Taille tableau(tPtrTriChp)
 Si($nbCrit>0)   `S'il y a au moins un élément dans le tableau de pointeurs
    Boucle($i;1;$nbCrit`Pour chaque critère défini
       TRIER([CDs];(tPtrTriChp{$i})->;>;*)   `On construit le tri
    Fin de boucle
    TRIER([CDs])   `Pas de * : on effectue le tri
 Fin de si

Quelle que soit la manière dont le tri est défini, si l'opération risque de prendre un certain temps, 4D affiche automatiquement un message contenant un thermomètre de progression. Vous pouvez décider d'afficher ou de ne pas afficher ce message pour le process à l'aide des commandes SUPPRIMER MESSAGES et LAISSER MESSAGES. Si le thermomètre de progression est affiché, l'utilisateur peut cliquer sur le bouton Stop pour interrompre l'opération. Si le tri s'est correctement déroulé, la variable système OK prend la valeur 1. Sinon, si le tri est interrompu, OK prend la valeur 0 (zéro).

 
PROPRIÉTÉS 

Produit : 4D
Thème : Recherches et tris
Numéro : 49
Nom intl. : ORDER BY

Cette commande modifie la variable système OKCette commande change l'enregistrement courant

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
VOIR AUSSI  

TRIER PAR FORMULE

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)