Hole ( Sortierfolge )

Gibt die Sortierfolge als JSON-Objekt zurück.

Format 

Hole ( Sortierfolge )

Parameter 

Ohne

Zurückgegebener Datentyp 

Text

Ursprung in Version 

26.1

Beschreibung 

Diese Funktion gibt die Sortierfolge des aktiven Fensters als JSON-Objekt mit folgender Struktur zurück:

Kopieren
{
  "Sort" : 
  {
    "field" : 
    [
      {
        "fieldName" : "Tabelle::Feld",
        "overrideLanguage" : "Sprache",
        "sortOrder" : "Aufsteigend | Absteigend | Werteliste-Name",
        "summary" : "Statistikfeld"
      }
    ],
    "maintain" : "wahr | falsch"
  }
}

Die folgende Tabelle beschreibt die Elemente im zurückgegebenen JSON-Objekt.

JSON-Element Beschreibung
Sort

Objekt, das die Sortierfolge enthält.

field

Array, das für jedes Sortierfeld ein Objekt enthält, und zwar in der Reihenfolge, die im Dialogfeld „Datensätze sortieren“ angegeben wurde.

fieldName

Name des Sortierfelds, einschließlich seines Tabellenauftritts (zum Beispiel Produkte::Produktname).

sortOrder

Sortierfolge des Felds. Eines von:

  • Aufsteigend

  • Absteigend

  • Der Name der Werteliste, sofern durch Eigene Sortierfolge, basierend auf Werteliste angegeben

overrideLanguage

Sprachbezeichnung, sofern im Feld Sortiersprache für das Feld ändern angegeben, zum Beispiel Swedish. Mögliche Namen finden Sie unter Sprachbezeichnungen für Sortierung und Indizierung.

summary

Name des Statistikfelds, sofern für Neu ordnen, basierend auf Statistikfeld angegeben, ohne Tabellenauftreten.

maintain

Textwert, "wahr" oder "falsch", der angibt, ob Datensätze in bestehender Sortierfolge behalten ausgewählt ist.

Hinweise 

  • Jedes Fenster hat seine eigene Sortierfolge.

  • Die Funktion gibt die zuletzt verwendete Sortierfolge des Fensters zurück, auch wenn die Datensätze nicht mehr sortiert sind (beispielsweise nachdem Sie Datensätze > Unsortiert ausgewählt haben). Um zu überprüfen, ob die Datensätze derzeit sortiert sind, verwenden Sie die Statusfunktion Funktion „Hole ( Sortierstatus )“.

Beispiel 1 

Wenn die Datensätze nach „Produktname“ in aufsteigender Reihenfolge sortiert sind und die Option Datensätze in bestehender Sortierfolge behalten nicht ausgewählt ist, gibt die Funktion Folgendes zurück:

Kopieren
{
  "Sort" : 
  {
    "field" : 
    [
      {
        "fieldName" : "Produkte::Produktname",
        "sortOrder" : "Aufsteigend"
      }
    ],
    "maintain" : "falsch"
  }
}

Beispiel 2 

Speichert die Sortierfolge des aktiven Fensters im Feld Berichte::LetzteSortierfolge, bevor ein Script die Ergebnismenge ändert. Wenn die Datensätze nicht sortiert sind, wird das Feld auf einen leeren Wert gesetzt.

Kopieren
Feldwert setzen [ Berichte::LetzteSortierfolge ;
    Wenn ( Hole ( Sortierstatus ) = 0 ; "" ; Hole ( Sortierfolge ) )
]

Beispiel 3 

In einem Layout in der Listenansicht zeigt ein Zwischenergebnis-Bereich „Kategorie“ eine Überschrift an, wenn die Datensätze nach Kategorie sortiert sind. Das Feld „Kategorie“ im Hauptbereich wiederholt dann die Überschrift in jeder Zeile. Um das Feld „Kategorie“ im Hauptbereich in diesem Fall auszublenden, geben Sie diese Formel als Bedingung für Objekt ausblenden, wenn ein – (siehe Aus- und Einblenden von Layoutobjekten).

Kopieren
Hole ( Sortierstatus ) ≠ 0 und
JSONGetElement ( Hole ( Sortierfolge ) ; "Sortierfeld[0].Feldname" ) = "Produkte::Kategorie"

Die Formel gibt nur dann 1 zurück (und das Feld wird ausgeblendet), wenn die Datensätze sortiert sind und „Kategorie“ das erste Sortierfeld ist. Andernfalls wird 0 zurückgegeben. Der Test „Hole ( Sortierstatus )“ ist erforderlich, da die Funktion nach der Auswahl von Datensätze → Unsortiert weiterhin die letzte Sortierfolge zurückgibt.