Apri transazione

Avvia una transazione; le modifiche dei record successive vengono mantenute nella transazione fino a che viene eseguita un'istruzione di script Salva transazione o Annulla transazione.

Nota  Le transazioni sono gestite nella finestra di origine. Le azioni effettuate in finestre diverse da quella della transazione di origine verranno salvate automaticamente al di fuori delle transazioni esistenti.

Opzioni 

• Non eseguire verifica dati inseriti ignora tutte le opzioni di verifica dei dati inseriti impostate per i campi e il record viene comunque salvato. Questa opzione salta solo la convalida di campi impostati con l'opzione Solo durante l'immissione dei dati nella finestra di dialogo Opzioni per il campo; i campi impostati su Convalida sempre continueranno a convalidare, anche se l'opzione Non eseguire verifica dati inseriti è selezionata. Vedere Definizione della verifica dei campi.

• Ignora conflitti di protezione ESS consente ai client di origini dati ODBC di forzare il salvataggio delle modifiche se il blocco ottimistico impedisce di salvare i dati. Le origini dati ODBC vengono anche chiamate origini SQL esterne (ESS).

Creata nella versione 

19.6.1

Descrizione 

Una transazione consiste in modifiche a uno o più record nella finestra corrente. Le modifiche in una transazione possono influire su più tabelle in più file di database. Tutte le modifiche in una transazione vengono salvate insieme o, se si verifica un errore, annullate insieme. Una transazione inizia con un'istruzione di script Apri transazione. Dopo aver avviato una transazione, le modifiche dei record successive vengono mantenute nella transazione fino a che viene eseguita un'istruzione di script Salva transazione o Annulla transazione. Le istruzioni qui di seguito possono modificare i record memorizzati nello schema dei database ed essere utilizzate come istruzioni di script transazionali.

• Nuovo record/richiesta

• Duplica il record/richiesta

• Elimina il record/richiesta

• Elimina riga del portale

• Elimina tutti i record

• Importa record

  Se la destinazione dell'importazione è una nuova tabella, la tabella, la ricorrenza di tabella e il formato vengono eliminati se la transazione non viene salvata. Una transazione non viene salvata se l'istruzione di script Salva transazione restituisce un errore o se viene eseguita l'istruzione di script Annulla transazione.

• Sostituisci contenuto campo

• Nuovo riferimento contenuto campo

• Imposta campo, Imposta campo per nome

• Istruzioni di script di modifica: Cancella, Taglia, Incolla, Esegui Trova/Sostituisci, Annulla/Ripristina

• Istruzioni di script di inserimento: Inserisci audio/video, Inserisci risultato calcolato, Inserisci data corrente, Inserisci ora corrente, Inserisci nome utente corr., Inserisci file, Inserisci da dispositivo, Inserisci dall'indice, Inserisci dall'ultimo campo visitato, Inserisci da URL, Inserisci PDF, Inserisci immagine, Inserisci testo

Quando si aggiunge un'istruzione di script Apri transazione a uno script, viene automaticamente accoppiata l'istruzione di script Salva transazione.

Le transazioni:

• Combinano le modifiche a uno o più campi o tabelle come un unico set di modifiche

• Salvano o annullano un intero set di modifiche

• Raggruppano le modifiche a campi o tabelle tra le istruzioni di script Apri transazione e Salva transazione

• Consentono di creare un set di modifiche più affidabile

• Possono essere annullate automaticamente utilizzando l'istruzione di script Annulla transazione

• Vanno a buon fine (salvataggio) o falliscono (annullamento) come gruppo

• Vanno a buon fine quando sono state rispettate le regole dello schema

• Vengono annullate automaticamente quando non sono state rispettate le regole dello schema

• Opzionalmente possono saltare le impostazioni di verifica e ignorare gli annullamenti automatici se le regole dello schema non sono state rispettate. Ignorare le regole dello schema può compromettere l'integrità della transazione.

• Sono modificate in un file temporaneo locale prima che l'istruzione di script Salva transazione salvi le modifiche al file principale

Le transazioni eseguono automaticamente il salvataggio e terminano quando:

• Le seguenti istruzioni di script modificano la finestra del formato: Nuova finestra, Chiudi finestra o Seleziona finestra

• Vengono utilizzate le seguenti finestre di dialogo: Gestisci database, Gestisci Contenitore o Gestisci origine dati

• Vengono eseguite le seguenti azioni o istruzioni di script: Salva copia con nome o Nuovo accesso

• Il file viene chiuso

Le transazioni vengono annullate automaticamente quando:

• Sono presenti errori dello schema irrisolti prima di avviare una transazione. In questo caso le transazioni sono saltate automaticamente

• Un modifica a un campo, impostato per eseguire sempre la verifica, non corrisponde alle opzioni di verifica del campo

• Viene utilizzata l'istruzione di script Annulla transazione

• Viene annullato uno script

• L'istruzione di script Arresta Script è utilizzata in una transazione

• Viene annullato uno script utilizzando lo Script Debugger

• Sono presenti errori a livello dei privilegi come nessun accesso a campi, record e tabelle

Note 

• Non è possibile utilizzare l'istruzione di script Apri transazione per avviare una transazione all'interno di un'altra.

• Le transazioni nidificate che utilizzano l'istruzione di script Esegui script uniscono le transazioni di origine, ma ignorano le istruzioni di script Annulla transazione e Salva transazione all'interno dei subscript.

• L'azione Elimina il record, quando utilizzata all'interno di transazioni, elimina un record alla volta.

• L'azione Vuota tabella non può essere annullata.

• L'azione Importa record non mostra un riassunto quando utilizzata all'interno di transazioni.

• L'istruzione di script Annulla transazione non annulla il valore di immissione automatica Incremento Seriale.

• L'opzione Salva le modifiche ai record automaticamente in Impostazione formato viene ignorata durante le transazioni.

• Le modifiche effettuate dall'istruzione di script Esegui FileMaker Data API non sono incluse nella transazione dello script. Qualsiasi operazione completata all'interno di questa istruzione di script, anche se integrata in una transazione, non sarà annullata.

Esempio 1 

Apre e salva una transazione.

Apri transazione [] Apri record/richiesta Imposta campo [ Beni::Descrizione ; "testo descrittivo" ] Salva transazione

Esempio 2 

Apre e salva una transazione senza verificare i dati inseriti.

Apri transazione [ Non eseguire verifica dati inseriti ] Apri record/richiesta Imposta campo [ Beni::Descrizione ; "testo descrittivo" ] Salva transazione

Esempio 3 

Apre e salva una transazione senza protezione ESS.

Apri transazione [ Ignora conflitti di protezione ESS ] Apri record/richiesta Imposta campo [ Beni::Descrizione ; "testo descrittivo" ] Salva transazione

Argomenti correlati 

• Istruzioni di script

• Salva transazione

• Annulla transazione