Get(SortOrder)
Retourneert de sorteervolgorde als een JSON-object.
Opmaak
( SortOrder ) ophalen
Parameters
Geen
Resulterend gegevenstype
tekst
Afkomstig uit versie
26.1
Beschrijving
Met deze functie wordt de sorteervolgorde van het actieve venster geretourneerd als een JSON-object met de volgende structuur:
{
"Sort" :
{
"field" :
[
{
"fieldName" : "Table::Field",
"overrideLanguage" : "Language",
"sortOrder" : "Ascending | Descending | Value list name",
"summary" : "Summary field"
}
],
"maintain" : "true | false"
}
}
In de volgende tabel worden de elementen in het geretourneerde JSON-object beschreven.
| JSON-element | Beschrijving |
|---|---|
Sorteren
|
Object dat de sorteervolgorde bevat. |
veld
|
Matrix die een object bevat voor elk sorteerveld, in de volgorde die is opgegeven in het dialoogvenster Records sorteren. |
veldnaam
|
Naam van het sorteerveld, inclusief de bijbehorende tabelvermelding (bijvoorbeeld |
sortOrder
|
Sorteervolgorde van het veld. Een van de volgende:
|
overrideLanguage
|
Taalnaam, indien opgegeven voor Taal van het veld negeren voor sorteren, bijvoorbeeld |
summary
|
Naam van het samenvattingsveld, indien opgegeven voor Opnieuw ordenen op basis van samenvattingsveld, zonder een tabelvermelding. |
maintain
|
Tekstwaaarde ( |
Opmerkingen
-
Elk venster heeft een eigen sorteervolgorde.
-
De functie retourneert de meest recente sorteervolgorde van het venster, zelfs als de records niet meer worden gesorteerd (bijvoorbeeld nadat u Records > Sorteren opheffen hebt gekozen). Gebruik de Get (StatusSorteren) functie om te controleren of de records momenteel worden gesorteerd.
Voorbeeld 1
Als de records worden gesorteerd op ProductName in oplopende volgorde en Records in gesorteerde volgorde houden niet is geselecteerd, retourneert de functie:
{
"Sort" :
{
"field" :
[
{
"fieldName" : "Products::ProductName",
"sortOrder" : "Ascending"
}
],
"maintain" : "false"
}
}
Voorbeeld 2
Hiermee wordt de sorteervolgorde van het actieve venster opgeslagen in het veld Reports::LastSortOrder voordat een script de gevonden set wijzigt. Als de records niet zijn gesorteerd, wordt het veld ingesteld op een lege waarde.
Set Field [ Reports::LastSortOrder ;
If ( Get ( SortState ) = 0 ; "" ; Get ( SortOrder ) )
]
Voorbeeld 3
In een lay-out in Lijstweergave wordt in een onderliggend overzicht van de categorieën een kop weergegeven wanneer de records op categorie zijn gesorteerd. Het veld Categorie in het hoofdgedeelte herhaalt vervolgens de kop in elke rij. Als u in dat geval het veld Categorie in het hoofdgedeelte wilt verbergen, voert u deze formule in als de voorwaarde voor Object verbergen wanneer (zie Lay-outobjecten verbergen of tonen).
Get ( SortState ) ≠ 0 and
JSONGetElement ( Get ( SortOrder ) ; "Sort.field[0].fieldName" ) = "Products::Category"
De berekening retourneert 1 (en verbergt het veld) alleen als de records zijn gesorteerd en Categorie het eerste sorteerveld is. Anders wordt 0 geretourneerd. De test Get ( StatusSorteren ) is nodig omdat na het kiezen van Records > Sorteren opheffen de functie nog steeds de laatste sorteervolgorde retourneert.