GetIDRecordDaGruppoTrovato

Restituisce gli ID dei record del gruppo trovato corrente come lista o come array JSON. Per ottenere gli ID dei record correlati, specificare il nome di una ricorrenza di tabella o di un portale.

Formato 

GetIDRecordDaGruppoTrovato ( tipo { ; ricorrenzaTabellaOPortale } )

Parametri 

tipo - un'espressione numerica che specifica il formato degli ID dei record restituiti. Vedere Descrizione.

ricorrenzaTabellaOPortale - un'espressione di testo che specifica il nome di una ricorrenza di tabella correlata o il nome dell'oggetto di un portale sul formato corrente.

I parametri racchiusi tra parentesi graffe { } sono opzionali.

Tipo di dati riportato 

Testo

Creata nella versione 

22.0

Descrizione 

Questa funzione restituisce gli ID record di tutti i record del gruppo trovato corrente nell'ordine attuale oppure gli ID record di tutti i record correlati al record corrente in base alla ricorrenza di tabella o al portale specificati. Gli ID dei record sono identificativi univoci che un client FileMaker assegna a ciascun record di una tabella quando viene creato il record e non possono essere modificati.

Il parametro tipo determina il formato dei dati restituiti. Utilizzare il nome della costante o il valore numerico per specificare tipo.

Parametro tipo Restituisce gli ID dei record come Esempi

NumeroValore (0)

Elenco di valori separati da ritorni a capo
Copia 
1
5
21
22
23
7

JSONString (1)

Array JSON di valori come stringhe
Copia 
["1","5","21","22","23","7"]

JSONNumber (2)

 Array JSON di valori come numeri
Copia 
[1,5,21,22,23,7]

IntervalliNumeroValore (3)

Elenco di valori con intervalli1
Copia 
1
5
21-23
7

IntervalliJSONString (4)

Array JSON come stringhe con intervalli1
Copia 
["1","5","21-23","7"]

  1. Per IntervalliNumeroValore e IntervalliJSONString, gli ID di record consecutivi vengono compressi in intervalli per aiutare a ridurre le dimensioni dei dati restituiti.

Per ottenere gli ID dei record correlati in una ricorrenza di tabella, utilizzare il parametro ricorrenzaTabellaOPortale per specificare il nome di una ricorrenza di tabella correlata. Gli ID dei record correlati vengono restituiti in base al criterio di ordinamento specificato dalla relazione. Vedere Creazione e modifica delle relazioni.

Per ottenere gli ID dei record correlati in un portale del formato corrente, utilizzare il parametro ricorrenzaTabellaOPortale per specificare il nome dell'oggetto del portale (vedere Assegnazione di nomi a oggetti). Gli ID dei record restituiti vengono filtrati e ordinati in base alle impostazioni del portale nella finestra di dialogo Impostazione portale. Vedere Creazione di portali per visualizzare i record correlati.

Note 

  • Gli ID dei record restituiti possono essere utilizzati con l'istruzione di script Vai a Lista dei record per ricreare lo stesso gruppo trovato quando si specifica un formato basato sulla stessa tabella.

  • Se non vengono trovati record, questa funzione restituisce un risultato vuoto nel formato specificato. Per un elenco di valori vuoto, restituisce una stringa vuota (""). Per un array JSON vuoto, restituisce "[]".

  • Se viene specificato il parametro ricorrenzaTabellaOPortale, per prima cosa questa funzione cerca di far corrispondere il suo valore al nome di una ricorrenza di tabella. Se non riesce, cerca di far corrispondere il valore al nome dell'oggetto di un portale. Se non viene trovata alcuna corrispondenza, questa funzione restituisce "?".

Esempio 1 - Ottenere gli ID dei record come elenco di valori

Restituisce gli ID dei record come elenco separato da ritorni a capo.

Copia 
GetIDRecordDaGruppoTrovato ( NumeroValore )

Se il gruppo trovato corrente contiene record con gli ID 101, 102 e 105, questo esempio restituisce:

Copia 
101
102
105

Esempio 2 - Ottenere gli ID dei record correlati di un portale come array JSON di numeri

Restituisce gli ID dei record correlati come un array JSON di numeri dall'oggetto del portale denominato PortaleContatti.

Copia 
GetIDRecordDaGruppoTrovato (JSONNumber ; "PortaleContatti" )

Se il portale del record corrente ha tre record correlati che il portale ordina e filtra per avere gli ID 1101, 702 e 1015, questo esempio restituisce:

Copia 
[1101,702,1015]

Esempio 3 - Salvare il gruppo trovato da ricreare più tardi

Salva in un campo globale un oggetto JSON contenente gli ID dei record del gruppo trovato corrente e il nome del formato corrente.

Copia 
Imposta variabile [ $IDrecord ; Valore: GetIDRecordDaGruppoTrovato ( IntervalliJSONString ) ]
Imposta variabile [ $formatoCorrente ; Valore: Get ( NomeFormato ) ]

Imposta variabile [ $infoGruppotrovato ; Valore: 
  JSONSetElement ( "{}" ; 
    [ "IDrecord" ; $IDrecord ; JSONArray ] ; 
    [ "formato" ; $formatoCorrente ; JSONString ] 
  )
]

Imposta campo [ Globale::UltimaRicerca ; $infoGruppoTrovato ]

Per un gruppo trovato sul formato Contatti, l'oggetto JSON salvato in Globale::UltimaRicerca potrebbe apparire come segue:

Copia 
{
  "IDrecord": ["1-3", "5", "7-9"],
  "formato": "Contatti"
}

Successivamente, un altro script può passare allo stesso formato e gruppo trovato utilizzando l'istruzione di script Vai a Lista dei record.

Copia 
Imposta variabile [ $infoGruppoTrovato ; Valore: Globale::UltimaRicerca ]
Imposta variabile [ $IDrecord ; Valore: JSONGetElement ( $infoGruppoTrovato ; "IDrecord" ) ]
Imposta variabile [ $nomeFormato ; Valore: JSONGetElement ( $infoGruppoTrovato ; "formato" ) ]

Vai a Lista dei record [ Elenco degli ID dei record: $IDrecord ; Con il formato: $nomeFormato ; Animazione: Nessuna ]

Argomenti correlati