GetRecordIDsFromFoundSet

Returnerar post-ID:n från det aktuella sökresultatet som en lista eller en JSON-matris. Ange namnet på en tabellförekomst eller en portal om du vill hämta ID:n för relaterade poster.

Format 

GetRecordIDsFromFoundSet ( typ { ; tabellförekomstEllerPortal } )

Parametrar 

typ – ett numeriskt uttryck som anger formatet för returnerade post-ID:n. Läs mer under Beskrivning.

tabellförekomstEllerPortal – ett textuttryck som anger namnet på en relaterad tabellförekomst eller objektnamnet på en portal i den aktuella layouten.

Parametrar inom klamrar {} är valfria.

Returnerad datatyp 

text

Ursprungsversion 

22.0

Beskrivning 

Den här funktionen returnerar post-ID:n för alla poster i aktuella hittade poster i deras aktuella ordning, eller post-ID:n för alla poster som är relaterade till den aktuella posten av den angivna tabellförekomsten eller portalen. Post-ID:n är unika identifierare som en FileMaker-klient tilldelar varje post i en tabell när posten skapas. Post-ID:n kan inte ändras.

Parametern typ bestämmer formatet för returnerade data. Använd antingen konstantnamnet eller det numeriska värdet för att ange typ.

typ-parameter Returnerar post-ID som Exempel

VärdeTal (0)

Lista med värden som avgränsas av returtecken
Kopiera 
1
5
21
22
23
7

JSONString (1)

JSON-matris med värden som strängar
Kopiera 
["1","5","21","22","23","7"]

JSONNumber (2)

 JSON-matris med värden som tal
Kopiera 
[1,5,21,22,23,7]

VärdeTalintervall (3)

Lista med värdeintervall1
Kopiera 
1
5
21-23
7

JSONSträngintervall (4)

JSON-matris som strängar med intervall1
Kopiera 
["1","5","21-23","7"]

  1. För VärdeTalintervall och JSONSträngintervall komprimeras post-ID:n i följd i intervall så att storleken på returnerade data blir mindre.

Om du vill hämta ID:n för relaterade poster i en tabellförekomst använder du parametern tabellförekomstEllerPortal för att ange namnet på en relaterad tabellförekomst. Relaterade post-ID:n returneras i den sorteringsordning som anges av relationen. Mer information finns i Skapa och ändra relationer.

Om du vill hämta ID:n för relaterade poster i en portal på den aktuella layouten använder du parametern tabellförekomstEllerPortal för att ange portalens objektnamn (mer information finns i Namnge objekt). Returnerade post-ID:n filtreras och sorteras enligt portalens inställningar i dialogrutan Portalkonfiguration. Mer information finns i Skapa portaler för att visa relaterade poster.

Kommentarer 

  • Returnerade post-ID:n kan användas med Scriptsteget Gå till Postlista för att återskapa samma uppsättning med hittade poster när du anger en layout baserad på samma tabell.

  • Om inga poster hittas returnerar den här funktionen ett tomt resultat i det angivna formatet. För en tom värdelista returneras en tom sträng (""). För en tom JSON-matris returneras "[]".

  • Om parametern tabellförekomstEllerPortal anges försöker den här funktionen först matcha värdet med ett tabellförekomstnamn. Om det misslyckas försöker den matcha värdet med ett objektnamn för en portal. Om ingen matchning hittas returneras ”?”.

Exempel 1 - Få post-ID:n som en lista med värden

Returnerar post-ID:n som en returseparerad lista.

Kopiera 
GetRecordIDsFromFoundSet ( VärdeTal )

Om de aktuella hittade posterna innehåller poster med ID:n 101, 102 och 105 returneras följande i det här exemplet:

Kopiera 
101
102
105

Exempel 2 - Få relaterade post-ID:n från en portal som en JSON-matris av tal

Returnerar relaterade post-ID:n som en JSON-matris med tal från portalobjektet med namnet Kontaktportal.

Kopiera 
GetRecordIDsFromFoundSet ( JSONNumber ; "Kontaktportal" )

Om portalen i den aktuella posten har tre relaterade poster som portalen sorterar och filtrerar med ID 1101, 702 och 1015 returneras följande i det här exemplet:

Kopiera 
[1101,702,1015]

Exempel 3 - Spara hittade poster för att återskapa senare

Sparar i ett fält som använder global lagring ett JSON-objekt som innehåller post-ID:n för de aktuella hittade posterna och det aktuella layoutnamnet.

Kopiera 
Ange variabel [ $postID:n ; Värde: GetRecordIDsFromFoundSet ( JSONSträngintervall ) ]
Ange variabel [ $aktuellLayout ; Värde: Get ( Layoutnamn ) ]

Ange variabel [ $hittadePosterInfo ; Värde: 
  JSONSetElement ( "{}" ; 
    [ "postID:n" ; $postID:n ; JSONArray ] ; 
    [ "layout" ; $aktuellLayout ; JSONString ] 
  )
]

Tilldela fält [ Global::SenasteSökning ; $hittadePosterInfo ]

För hittade poster i layouten Kontakter kan JSON-objektet som sparats i Global::SenasteSökning se ut så här:

Kopiera 
{
  "postID:n": ["1-3", "5", "7-9"],
  "layout": "Kontakter"
}

Senare kan ett annat script gå till samma layout och samma hittade poster med hjälp av Scriptsteget Gå till Postlista.

Kopiera 
Ange variabel [ $hittadePosterInfo ; Värde: Global::SenasteSökning ]
Ange variabel [ $postID:n ; Värde: JSONGetElement ( $hittadePosterInfo ; "postID:n" ) ]
Ange variabel [ $layoutnamn ; Värde: JSONGetElement ( $hittadePosterInfo ; "layout" ) ]

Gå till postlista [ Lista med post-ID:n: $postID:n ; Med layout: $layoutnamn ; Animering: Ingen ]

Relaterade avsnitt