Vai a Lista dei record
Va a un formato e restituisce il gruppo trovato specificato da un elenco di ID record.
Vedere anche
Opzioni
-
Elenco degli ID dei record è l'elenco degli identificativi dei record a cui andare. L'ordine degli ID dei record specifica il criterio di ordinamento da utilizzare per il gruppo trovato. Gli ID dei record devono essere identificativi di record validi nella tabella associata al formato specificato. Per i formati di elenco supportati, vedere Descrizione.
-
Mostra record usando il formato specifica il formato nel file corrente che verrà utilizzato per visualizzare i record dell'elenco. Se non viene specificato alcun formato, viene utilizzato quello corrente.
-
Mostra in una nuova finestra permette di visualizzare i record correlati in una nuova finestra e di specificare le impostazioni per la nuova finestra. Vedere istruzione di script Nuova finestra.
Suggerimento Per portare automaticamente la nuova finestra in primo piano, aggiungere l'istruzione di script Seleziona finestra.
-
Animazione specifica l'animazione da utilizzare quando si visualizzano i record (solo FileMaker Go).
Compatibilità
Prodotto | Supportata |
FileMaker Pro | In parte |
FileMaker Go | Sì |
FileMaker WebDirect | In parte |
FileMaker Server | In parte |
FileMaker Cloud | In parte |
FileMaker Data API | In parte |
Pubblicazione Web personalizzata | In parte |
Creata nella versione
22.0
Descrizione
Questa istruzione di script va al formato specificato nella finestra corrente (o in una nuova finestra). Quindi cambia il gruppo trovato di record e il suo criterio di ordinamento in quelli specificati da Elenco degli ID dei record e va al primo record di quel gruppo.
È possibile specificare l'opzione Elenco degli ID dei record in uno di questi formati:
Formato per Elenco degli ID dei record | Esempi | Note |
---|---|---|
Lista valori |
Copia
Copia
|
Vedere ConteggioValore per i caratteri separatori supportati. |
Array JSON di valori |
Copia
|
Gli ID dei record possono essere numeri o stringhe JSON. |
Array JSON di oggetti con una coppia chiave-valore |
Copia
|
Le richieste di ricerca eseguite dall'istruzione di script Esegui ricerca semantica e dall'istruzione di script Esegui FileMaker Data API restituiscono JSON in un formato compatibile. |
Gli ID di record consecutivi possono essere forniti come intervallo (due numeri separati da un trattino) in un elenco di valori (ad esempio, 21-23
) o in un array JSON di stringhe (ad esempio, ["21-23"]
). Un intervallo in un array JSON di numeri è un JSON non valido, che fa sì che questa istruzione di script restituisca un errore.
Se non è possibile trovare nessuno degli ID record specificati (ad esempio, se i record sono stati eliminati), tali ID vengono ignorati e il gruppo trovato conterrà solo i record che sono stati individuati con successo. I record del gruppo trovato risultante vengono visualizzati con un criterio di ordinamento che corrisponde alla sequenza degli ID record forniti. Nella finestra di dialogo Ordina i record, questo stato di ordinamento è indicato da <Ordine predefinito>.
Note
-
Gli ID record devono essere identificativi di record validi assegnati dal client FileMaker al momento della creazione del record. Questi sono gli stessi ID record utilizzati altrove, come quelli restituiti dalle funzioni Get ( IDRecord ) e GetIDRecordDaGruppoTrovato e dalle chiamate FileMaker Data API e OData API. I valori dei campi chiave primaria o altri identificativi personalizzati non sono supportati.
-
Se uno dei record specificati non può essere trovato, questa istruzione di script restituisce il codice di errore 101 ("Manca un record") o 401 ("Nessun record soddisfa la richiesta"), che può essere acquisito con la funzione Get ( UltimoErrore ).
-
Quando questa istruzione di script apre una nuova finestra, la nuova finestra non attiva il trigger di script SuAperturaPrimaFinestra o il trigger di script SuAperturaFinestra perché lo script attivato potrebbe non accedere al formato o alla visualizzazione desiderati. Se si desidera eseguire uno script dopo che questa istruzione di script ha aperto una nuova finestra, aggiungere Esegui script come istruzione di script successiva.
-
L'opzione Animazione è supportata solo in FileMaker Go:
-
È possibile utilizzare le animazioni solo per la finestra selezionata.
-
Non è possibile utilizzare le animazioni per navigare tra i record utilizzando il dispositivo di scorrimento o i pulsanti della barra degli strumenti.
-
Esempio 1 - Accedere ai record in un elenco di valori
Va al formato Contatti e visualizza i record specificati da un elenco di ID record delimitati da ritorni a capo.
Imposta variabile [ $listaRecord ; Valore: "15¶8¶23¶4¶12" ]
Vai a Lista dei record [ Elenco degli ID dei record: $listaRecord ; Con il formato: "Contatti" (Contatti) ]
Esempio 2 - Accedere ai record da una ricerca semantica salvata
La ricerca semantica eseguita nell'Esempio 2 di Esegui ricerca semantica salvava l'elenco dei record in $$risultato come un array JSON di oggetti con coppie chiave-valore recordId
(si noti che il formato JSON del risultato della ricerca salvato è compatibile con quello di Vai a Lista dei record). Più avanti nella stessa sessione client FileMaker, questo script apre una nuova finestra, va allo stesso formato (Dettagli riunioni) e visualizza lo stesso gruppo trovato. Se l'operazione non va a buon fine, lo script visualizza un messaggio di errore.
Vai a Lista dei record [ Elenco degli ID dei record: $$risultato ; Con il formato: "Dettagli riunioni" (Riunioni) ; Nuova finestra ]
If [ Get ( UltimoErrore ) ≠ 0 ]
Mostra finestra personalizz. [ "Errore" ; "Impossibile accedere ai record specificati. Errore: " & Get ( UltimoErrore ) ]
End If
Esempio 3 - Ricreare il gruppo trovato del client sull'host
Esegue una ricerca sul client FileMaker per i prodotti con un inventario ridotto (<50), quindi ottiene gli ID dei record del gruppo trovato utilizzando la funzione GetIDRecordDaGruppoTrovato. Lo script client quindi chiama uno script sull'host e gli passa l'elenco degli ID dei record.
Script del client
Vai al formato [ "Prodotti (Prodotti) ; Animazione: Nessuna ]
Passa al modo Trova [ Pausa: Disattivata ]
Imposta campo [ Prodotti::Inventario ; "<50" ]
Esegui ricerca [ ]
Imposta variabile [ $IDGruppoTrovato ; Valore: GetIDRecordDaGruppoTrovato ( IntervalliNumeroValore ) ]
Esegui script su server [ "Script host" ; Specificato: Da elenco ; Parametro: $IDGruppoTrovato ; Attendi il completamento: Attivato ]
Mostra finestra personalizz. [ "Risultato" ; Get ( RisultatoScript ) ]
Lo script dell'host va all'elenco dei record sul formato Prodotti, calcola il risultato, quindi ripassa il risultato allo script client.
Script host
Imposta variabile [ $IDrecord ; Get ( ParametroScript ) ]
Vai a Lista dei record [ Elenco degli ID dei record: $IDrecord ; Con il formato: "Prodotti" (Prodotti) ; Animazione: Nessuna ]
# Elabora i record del gruppo trovato e restituisci $risultato
Esci dallo script [Risultato testo: $risultato ]