HoleDatensatzIDsAusErgebnismenge

Gibt Datensatz-IDs aus der aktuellen Ergebnismenge als Liste oder JSON-Array zurück. Um IDs für Bezugsdatensätze zu erhalten, geben Sie den Namen eines Tabellenauftretens oder Ausschnitts an.

Format 

HoleDatensatzIDsAusErgebnismenge ( Typ { ; TabellenauftretenOderAusschnitt } )

Parameter 

Typ – ein numerischer Ausdruck, der das Format der zurückgegebenen Datensatz-IDs angibt. Siehe Beschreibung.

TabellenauftretenOderAusschnitt – ein Textausdruck, der den Namen einer zugehörigen Bezugstabelle oder den Objektnamen eines Ausschnitts im aktuellen Layout angibt.

Parameter in geschweiften Klammern { } sind optional.

Zurückgegebener Datentyp 

Text

Ursprung in Version 

22.0

Beschreibung 

Diese Funktion gibt die Datensatz-IDs aller Datensätze in der aktuellen Ergebnismenge in ihrer aktuellen Reihenfolge zurück oder die Datensatz-IDs aller Datensätze, die über das angegebene Tabellenauftreten oder den angegebenen Ausschnitt mit dem aktuellen Datensatz in Verbindung stehen. Datensatz-IDs sind eindeutige IDs, die ein FileMaker-Client jedem Datensatz in einer Tabelle beim Erstellen zuweist und die nicht geändert werden können.

Der Parameter Typ bestimmt das Format der zurückgegebenen Daten. Verwenden Sie entweder den Konstantenamen oder den numerischen Wert, um Typ anzugeben.

Parameter Typ Gibt Datensatz-IDs zurück als Beispiele

ValueNumber (0)

Liste von Werten, getrennt durch Absatzende-Zeichen
Kopieren 
1
5
21
22
23
7

JSONString (1)

JSON-Array von Werten als Strings
Kopieren 
["1","5","21","22","23","7"]

JSONNumber (2)

 JSON-Array von Werten als Zahlen
Kopieren 
[1,5,21,22,23,7]

ValueNumberRanges (3)

Liste der Werte mit Bereichen1
Kopieren 
1
5
21-23
7

JSONStringRanges (4)

JSON-Array als Strings mit Bereichen1
Kopieren 
["1","5","21-23","7"]

  1. Bei ValueNumberRanges und JSONStringRanges werden aufeinanderfolgende Datensatz-IDs zu Bereichen komprimiert, um die Größe der zurückgegebenen Daten zu reduzieren.

Um die IDs von Bezugsdatensätzen in einem Tabellenauftreten zu erhalten, verwenden Sie den Parameter TabellenauftretenOderAusschnitt zum Angeben des Namens eines Bezugstabellenauftretens. Die Bezugsdatensatz-IDs werden in der durch die Beziehung festgelegten Sortierfolge zurückgegeben. Weitere Informationen finden Sie unter Erstellen und Ändern von Beziehungen.

Um die IDs von Bezugsdatensätzen in einem Ausschnitt des aktuellen Layouts zu erhalten, verwenden Sie den Parameter TabellenauftretenOderAusschnitt und geben Sie den Objektnamen des Ausschnitts an (siehe Benennen von Objekten). Die zurückgegebenen Datensatz-IDs werden gemäß den Einstellungen des Ausschnitts im Dialogfeld „Ausschnitteinstellung“ gefiltert und sortiert. Weitere Informationen finden Sie unter Erstellen von Ausschnitten für Bezugsdatensätze.

Hinweise 

  • Die zurückgegebenen Datensatz-IDs können mit dem Scriptschritt „Gehe zu Liste der Datensätze“ verwendet werden, um dieselbe Ergebnismenge wiederherzustellen, wenn Sie ein Layout basierend auf derselben Tabelle angeben.

  • Wenn keine Datensätze gefunden werden, gibt diese Funktion ein leeres Ergebnis im angegebenen Format zurück. Bei einer leeren Werteliste wird ein leerer String („“) zurückgegeben. Für ein leeres JSON-Array wird „[]“ zurückgegeben.

  • Wenn der Parameter TabellenauftretenOderAusschnitt angegeben ist, versucht diese Funktion zunächst, ihren Wert mit dem Namen eines Tabellenauftretens abzugleichen. Wenn dies fehlschlägt, versucht sie, den Wert mit dem Objektnamen eines Ausschnitts abzugleichen. Wenn keine Übereinstimmung gefunden wird, gibt diese Funktion „?“ zurück.

Beispiel 1 - Datensatz-IDs als Liste von Werten abrufen

Gibt Datensatz-IDs als durch Absatzende-Zeichen getrennte Liste zurück.

Kopieren 
HoleDatensatzIDsAusErgebnismenge ( ValueNumber )

Wenn die aktuelle Ergebnismenge Datensätze mit den IDs 101, 102 und 105 enthält, gibt dieses Beispiel Folgendes zurück:

Kopieren 
101
102
105

Beispiel 2 - Bezugsdatensatz-IDs aus einem Ausschnitt als JSON-Array von Zahlen abrufen

Gibt Bezugsdatensatz-IDs als JSON-Array mit Zahlen aus dem Ausschnittobjekt „KontakteAusschnitt” zurück.

Kopieren 
HoleDatensatzIDsAusErgebnismenge ( JSONNumber ; "KontakteAusschnitt" )

Wenn der Ausschnitt im aktuellen Datensatz drei Bezugsdatensätze aufweist, die der Ausschnitt sortiert und filtert, sodass sie die IDs 1101, 702 und 1015 haben, gibt dieses Beispiel Folgendes zurück:

Kopieren 
[1101,702,1015]

Beispiel 3 - Ergebnismenge zur späteren Wiederherstellung speichern

Speichert in einem Variablenfeld ein JSON-Objekt, das die Datensatz-IDs der aktuellen Ergebnismenge und den Namen des aktuellen Layouts enthält.

Kopieren 
Variable setzen [ $DatensatzIDs ; Wert: HoleDatensatzIDsAusErgebnismenge ( JSONStringRanges ) ]
Variable setzen [ $aktuellesLayout ; Wert: Hole ( LayoutName ) ]

Variable setzen [ $ErgebnismengeInfo ; Wert: 
  JSONSetElement ( "{}" ; 
    [ "DatensatzIDs" ; $DatensatzIDs ; JSONArray ] ; 
    [ "Layout" ; $aktuellesLayout ; JSONString ] 
  )
]

Feldwert setzen [ Global::LetzteSuche ; $ErgebnismengeInfo ]

Für eine Ergebnismenge im Layout „Kontakte” könnte das in Global::LetzteSuche gespeicherte JSON-Objekt wie folgt aussehen:

Kopieren 
{
  "recordIDs": ["1-3", "5", "7-9"],
  "layout": "Kontakte"
}

Später kann ein anderes Script mit dem Scriptschritt „Gehe zu Liste der Datensätze“ zum gleichen Layout und zur gleichen Ergebnismenge springen.

Kopieren 
Variable setzen [ $ErgebnismengeInfo ; Wert: Global::LetzteSuche ]
Variable setzen [ $DatensatzIDs ; Wert: JSONGetElement ( $ErgebnismengeInfo ; "recordIDs" ) ]
Variable setzen [ $layoutName ; Wert: JSONGetElement ( $ErgebnismengeInfo ; "layout" ) ]

Gehe zu Liste der Datensätze [ Liste der Datensatz-IDs: $DatensatzIDs ; Mit Layout: $LayoutName ; Animation: Ohne ]

Weiterführende Themen