Abrir transação

Inicia uma transação; as mudanças subsequentes no registro são mantidas na transação até que uma etapa de script Confirmar transação ou Reverter transação seja realizada.

Nota  As transações são tratadas dentro da janela de origem. As ações realizadas em janelas diferentes da janela da transação de origem serão confirmadas automaticamente fora das transações existentes.

Opções

• Ignorar validação de entrada de dados substitui qualquer conjunto de opções de validação de entrada de dados dos campos e confirma o registro mesmo assim. Esta opção ignora somente a validação para campos definidos com a opção de validação Somente durante a entrada de dados na caixa de diálogo Opções de campo; os campos definidos para Sempre validar ainda serão validados, mesmo se a opção Ignorar validação de entrada de dados for selecionada. Consulte Definição de validação do campo.

• Substituir conflitos de bloqueio de ESS permite que clientes de fontes de dados ODBC forcem a confirmação das alterações quando o bloqueio otimista impedir a ação de confirmação. As fontes de dados de ODBC são também conhecidas como fontes SQL externas (ESS).

Originada na versão

19.6.1

Descrição

Uma transação consiste em alterações em um ou mais registros na janela atual. As mudanças em uma transação podem afetar várias tabelas em vários arquivos de banco de dados. Todas as mudanças em uma transação são confirmadas juntas ou, se um erro ocorre, revertidas juntas. Uma transação começa com uma etapa de script Abrir transação. Depois de iniciar uma transação, as mudanças subsequentes no registro são mantidas na transação até que uma etapa de script Confirmar transação ou Reverter transação seja realizada. As etapas abaixo podem mudar registros armazenados no esquema do banco de dados e podem ser usadas como etapas de script de transação.

• Novo registro/solicitação

• Duplicar registro/solicitação

• Excluir registro/solicitação

• Excluir linha de portal

• Excluir todos os registros

• Importar registros

  Se o destino de importação for uma nova tabela, a tabela, a ocorrência da tabela e o layout serão excluídos caso a transação não seja confirmada. Uma transação não será confirmada se a etapa de script Confirmar transação retornar um erro ou a etapa de script Reverter transação for realizada.

• Substituir conteúdo do campo

• Pesquisar conteúdo de campo novamente

• Definir campo, Definir campo por nome

• Etapas do script de edição: Limpar, Recortar, Colar, Realizar localizar/substituir, Desfazer/refazer

• Etapas do script de inserção: Inserir áudio/vídeo, Inserir resultado calculado, Inserir data atual, Inserir hora atual, Inserir nome de usuário atual, Inserir arquivo, Inserir a partir do dispositivo, Inserir do índice, Inserir do último visitado, Inserir do URL, Inserir PDF, Inserir imagem, Inserir texto

Quando você adiciona uma etapa de script Abrir transação a um script, a etapa de script Confirmar transação é automaticamente combinada com ela.

Transações:

• Combine uma ou mais modificações de campo ou tabela como um único conjunto de mudanças

• Confirmar ou reverter um conjunto inteiro de mudanças

• Agrupar modificações de campo ou tabela entre as etapas de script Abrir transação e Confirmar transação

• Permitir que você crie um conjunto mais confiável de mudanças

• Pode ser revertido automaticamente com a etapa de script Reverter transação

• Sucesso (confirmar) ou falha (reverter) como um grupo

• Sucesso quando regras de esquema forem atendidas

• Reverter automaticamente quando regras de esquema não forem atendidas

• Como alternativa, pode ignorar as configurações de validação e substituir reversões automáticas quando as regras do esquema não forem atendidas. Ignorar regras de esquema pode violar a integridade das transações.

• São modificados em um arquivo temporário local antes que a etapa de script Confirmar transação salve as alterações no arquivo principal

As transações são automaticamente confirmadas e encerradas quando:

• As seguintes etapas do script alteram a janela de layout: Nova janela, Fechar janela ou Selecionar janela

• As seguintes caixas de diálogo são usadas: Gerenciar banco de dados, Gerenciar contêiner ou Gerenciar fonte de dados

• As seguintes ações ou etapas do script são executadas: Salvar uma cópia como ou Fazer login novamente.

• O arquivo está fechado

As transações são revertidas automaticamente quando:

• Existe um erro de esquema não resolvido antes do início de uma transação. As transações são ignoradas automaticamente quando isso ocorre

• Uma mudança em um campo, que está configurado para sempre validar, não corresponde às opções de validação do campo

• A etapa de script Reverter transação é usada

• Um script é cancelado

• A etapa de script Parar script é usada em uma transação

• Um script é cancelado usando o Depurador de scripts

• Há erros de privilégios, como: sem acesso a campo, sem acesso a registro e sem acesso a tabela

Notas

• Não é possível usar a etapa de script Abrir transação para iniciar uma transação dentro de outra transação.

• Transações aninhadas usando a etapa de script Realizar script unem transações de origem, mas ignoram as etapas de script Reverter transação e Confirmar transação aninhadas nos subscripts.

• A ação Excluir registro, quando usada dentro das transações, exclui um só registro por vez.

• A ação Truncar tabela não pode ser revertida.

• A ação Importar registros não mostra um resumo quando usado dentro das transações.

• A etapa de script Reverter transação não reverte o valor Incremento de série de inserção automática.

• A opção Salvar mudanças de registro automaticamente na Configuração de layout é ignorada durante as transações.

• As alterações feitas pela etapa de script Executar API de dados do FileMaker não são incluídas na transação do script. Todas as operações realizadas nesta etapa de script, mesmo que incluídas em uma transação, não serão revertidas.

Exemplo 1

Abre e confirma uma transação.

Abrir transação [] Abrir registro/solicitação Definir campo [ Ativos::Descrição ; "texto descritivo" ] Confirmar transação

Exemplo 2

Abre e confirma uma transação sem uma validação de entrada de dados.

Abrir transação [ Ignorar validação de entrada de dados ] Abrir registro/solicitação Definir campo [ Ativos::Descrição ; "texto descritivo" ] Confirmar transação

Exemplo 3

Abre e confirma uma transação sem proteção de bloqueio de ESS.

Abrir transação [ Substituir conflitos de bloqueio de ESS ] Abrir registro/solicitação Definir campo [ Ativos::Descrição ; "texto descritivo" ] Confirmar transação

Tópicos relacionados

• Referência de etapas de script

• Confirmar transação

• Reverter transação