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:

Kopiëren
{
  "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 Products::ProductName).

sortOrder

Sorteervolgorde van het veld. Een van de volgende:

  • Ascending

  • Descending

  • De naam van de invoerlijst, indien opgegeven met Aangepaste volgorde op basis van invoerlijst

overrideLanguage

Taalnaam, indien opgegeven voor Taal van het veld negeren voor sorteren, bijvoorbeeld Swedish. Zie Taalnamen voor sorteren en indexeren voor de mogelijke namen.

summary

Naam van het samenvattingsveld, indien opgegeven voor Opnieuw ordenen op basis van samenvattingsveld, zonder een tabelvermelding.

maintain

Tekstwaaarde ("true" of "false") die aangeeft of Records in gesorteerde volgorde houden is geselecteerd.

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:

Kopiëren
{
  "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.

Kopiëren
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).

Kopiëren
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.