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 :

Copier
{
  "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, Produits::NomProduit).

sortOrder

Ordre de tri de la rubrique. Une des valeurs suivantes :

  • Ascending

  • Descending

  • Le nom de la liste de valeurs, si spécifié par Tri selon liste de valeurs

overrideLanguage

Nom de la langue, si spécifié pour Ignorer la langue de la rubrique, par exemple Swedish. Pour les noms possibles, consultez la section Langues pour le tri et l'indexation.

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, "true" (vrai) ou "false" (faux), qui indique si Conserver l'ordre de tri est sélectionné.

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 :

Copier
{
  "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.

Copier
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).

Copier
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.