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

Waardengetal (0)

Lijst met waarden gescheiden door harde return

Kopiëren
1
5
21
22
23
7

JSONString (1)

JSON-matrix met waarden als tekenreeksen

Kopiëren
["1","5","21","22","23","7"]

JSONNumber (2)

JSON-matrix van waarden als getallen
Kopiëren
[1,5,21,22,23,7]

WaardengetalRanges (3)

Lijst met waarden met bereiken1

Kopiëren
1
5
21-23
7

JSONStringRanges (4)

JSON-array als tekenreeksen met bereiken1

Kopiëren
["1","5","21-23","7"]
  1. Voor ValueNumberRanges en JSONStringRanges 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.

Kopiëren
GetRecordIDsFromFoundSet ( ValueNumber )

Als de huidige gevonden reeks records bevat met de ID's 101, 102 en 105, wordt in dit voorbeeld het volgende geretourneerd:

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

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

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

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