GetRecordIDsFromFoundSet
Retourneert record-ID's van de huidige gevonden set als een lijst of een JSON-array.
Opmaak
GetRecordIDsFromFoundSet ( type )
Parameters
Type
- een numerieke expressie die de indeling van de geretourneerde record-ID's specificeert. Zie Beschrijving.
Resulterend gegevenstype
tekst
Afkomstig uit versie
22.0
Beschrijving
Deze functie retourneert de record-ID's van alle records in de huidige gevonden reeks in de huidige volgorde. Record-ID's zijn unieke ID's die een FileMaker-client aan elke record in een tabel toewijst wanneer de record wordt gemaakt en deze kunnen niet worden gewijzigd.
De parameter type
bepaalt de indeling van de geretourneerde gegevens. Gebruik de constante naam of de numerieke waarde om type
op te geven.
type parameter |
Retourneert record-ID's als | Voorbeelden |
---|---|---|
|
Lijst met waarden gescheiden door harde return |
Kopiëren
|
|
JSON-matrix met waarden als tekenreeksen |
Kopiëren
|
|
JSON-matrix van waarden als getallen |
Kopiëren
|
|
Lijst met waarden met bereiken1 |
Kopiëren
|
|
JSON-array als tekenreeksen met bereiken1 |
Kopiëren
|
-
Voor
ValueNumberRanges
enJSONStringRanges
worden opeenvolgende record-ID's gecomprimeerd in bereiken om de grootte van de geretourneerde gegevens te verkleinen.
Opmerkingen
-
De geretourneerde record-ID's kunnen worden gebruikt met de Ga naar lijst met records scriptstap om dezelfde gevonden reeks opnieuw te maken wanneer u een lay-out opgeeft op basis van dezelfde tabel.
-
Als er geen records worden gevonden, retourneert deze functie een leeg resultaat in de opgegeven indeling. Voor een lege lijst met waarden wordt een lege tekenreeks ('') geretourneerd. Voor een lege JSON-array wordt "[]" geretourneerd.
Voorbeeld 1 - Ontvang record ID's als een lijst met waarden
Hiermee worden record-ID's geretourneerd als een gescheiden lijst met harde return.
GetRecordIDsFromFoundSet ( ValueNumber )
Als de huidige gevonden reeks records bevat met de ID's 101, 102 en 105, wordt in dit voorbeeld het volgende geretourneerd:
101
102
105
Voorbeeld 2 - Gevonden reeks opslaan om later opnieuw te maken
Slaat een JSON-object op in een globaalveld met de record-ID's van de huidige gevonden reeks en de huidige lay-outnaam.
Variabele instellen [ $recordIDs ; Waarde: GetRecordIDsFromFoundSet ( JSONStringRanges ) ]
Variabele instellen [ $currentLayout ; Waarde: Get ( LayoutName ) ]
Variabele instellen [ $foundSetInfo ; Waarde:
JSONSetElement ( "{}" ;
[ "recordIDs" ; $recordIDs ; JSONArray ] ;
[ "layout" ; $currentLayout ; JSONString ]
)
]
Veld instellen [ Global::LastFind ; $foundSetInfo ]
Voor een gevonden reeks in de lay-out Contactpersonen kan het JSON-object dat is opgeslagen in Global::LastFind er als volgt uitzien:
{
"recordIDs": ["1-3", "5", "7-9"],
"layout": "Contactpersonen"
}
Later kan een ander script naar dezelfde lay-out gaan en ingesteld worden gevonden met de Ga naar lijst met records scriptstap.
Variabele instellen [ $foundSetInfo ; Waarde: Global::LastFind ]
Variabele instellen [ $recordIDs ; Waarde: JSONGetElement ( $foundSetInfo ; "recordIDs" ) ]
Variabele instellen [ $layoutName ; Waarde: JSONGetElement ( $foundSetInfo ; "layout" ) ]
Ga naar lijst met records [ Lijst met record-ID's: $recordIDs ; Met lay-out: $layoutName ; Animatie: Geen ]