Obtenir ( OrdreTri )
Renvoie l'ordre de tri sous forme d'objet JSON.
Format
Obtenir ( OrdreTri )
Paramètres
Aucun
Résultat
Texte
Provient de la version
26.1
Description
Cette fonction renvoie l'ordre de tri de la fenêtre active en tant qu'objet JSON avec la structure suivante :
{
"Sort" :
{
"field" :
[
{
"fieldName" : "Table::Rubrique",
"overrideLanguage" : "Langue",
"sortOrder" : "Ascending | Descending | Nom de la liste de valeurs",
"summary" : "Rubrique Statistique"
}
],
"maintain" : "true | false"
}
}
Le tableau suivant répertorie les éléments figurant dans l'objet JSON renvoyé.
| Élément JSON | Description |
|---|---|
Sort
|
Objet qui contient l'ordre de tri. |
field
|
Tableau contenant un objet pour chaque rubrique de tri, dans l'ordre spécifié dans la boîte de dialogue Trier les enregistrements. |
fieldName
|
Nom de la rubrique de tri, y compris son occurrence de table (par exemple, |
sortOrder
|
Ordre de tri de la rubrique. Une des valeurs suivantes :
|
overrideLanguage
|
Nom de la langue, si spécifié pour Ignorer la langue de la rubrique, par exemple |
summary
|
Nom de la rubrique de récapitulatif, si spécifié pour Retrier selon rubrique de type Statistique, sans occurrence de table. |
maintain
|
Valeur de texte, |
Remarques
-
Chaque fenêtre possède son propre ordre de tri.
-
La fonction renvoie l'ordre de tri le plus récent de la fenêtre, même si les enregistrements ne sont plus triés (par exemple, après avoir choisi Enregistrements > Annuler tri). Pour vérifier si les enregistrements sont actuellement triés, utilisez la fonction Obtenir ( EtatTri ).
Exemple 1
Si les enregistrements sont triés par NomProduit dans l'ordre croissant et que Conserver l'ordre de tri n'est pas sélectionné, la fonction renvoie :
{
"Sort" :
{
"field" :
[
{
"fieldName" : "Produits::NomProduit",
"sortOrder" : "Ascending"
}
],
"maintain" : "false"
}
}
Exemple 2
Enregistre l'ordre de tri de la fenêtre active dans la rubrique Rapports::DernierOrdreDeTri avant qu'un script ne modifie le jeu trouvé. Si les enregistrements ne sont pas triés, la rubrique est définie sur une valeur vide.
Définir rubrique [ Rapports::DernierOrdreDeTri ;
Si ( Obtenir ( EtatTri ) = 0 ; "" ; Obtenir ( OrdreTri ) )
]
Exemple 3
Dans un modèle de la vue Liste, un sous-récapitulatif de catégorie affiche un titre lorsque les enregistrements sont triés par catégorie. La rubrique Catégorie dans le corps répète ensuite le titre sur chaque ligne. Pour masquer la rubrique Catégorie du corps dans ce cas, entrez cette formule comme condition Masquer objet quand (consultez la section Masquage ou affichage des objets de modèle).
Obtenir ( EtatTri ) ≠ 0 and
JSONGetElement ( Obtenir ( OrdreTri ) ; "Sort.field[0].fieldName" ) = "Produits::Categorie"
Le calcul renvoie 1 (et la rubrique est cachée) uniquement si les enregistrements sont triés et Catégorie est la première rubrique de tri. Sinon, il renvoie 0. Le test Obtenir ( EtatTri ) est nécessaire car après avoir choisi Enregistrements > Annuler tri, la fonction renvoie toujours le dernier ordre de tri.