TransaçãoNaJanela

Executa um script e passa um objeto JSON como um parâmetro de script depois que uma ou mais alterações de registro são confirmadas com sucesso. O objeto JSON inclui o nome do arquivo, o nome da tabela de base, o ID do registro, a operação e o conteúdo de um campo de contexto para cada operação de registro confirmada.

As ações que ativam este gatilho de script são:

• um registro é confirmado depois de ser criado, modificado ou excluído

• uma transação aberta é confirmada com sucesso

Quando o script é executado

Depois que o evento é processado.

Modos em que o gatilho pode ser usado

Modos de navegação e de busca.

Resultado

Nenhuma.

Originada na versão

20.1

Descrição

Qualquer ação que comprometa um ou mais registros ativa esse gatilho de script, seja dentro de uma transação aberta (consulte a etapa de script Etapa de script Abrir transação) ou não. Este gatilho passa para o script um objeto JSON como um parâmetro de script contendo informações sobre as confirmações. Você pode usar esse gatilho com um script que registra todas as criações, modificações e exclusão de registros — por exemplo, em um registro de auditoria de alterações, quem as fez e quando.

Use a função Função Get(ScriptParameter) no script acionado para recuperar o objeto JSON. O objeto JSON tem a seguinte estrutura:

{
  "Nome de arquivo" : {
    "BaseTableName" : [
      [ "Operação", RecordID, FieldContent ],
      ...
    ]
  }
}

• "Nome de arquivo" é o nome do arquivo do banco de dados sem a extensão do arquivo.

• "BaseTableName" é o nome da tabela de base para os registros afetados.

• "Operação" é "Novo", "Modificado" ou "Excluído".

• RecordID é o número de identificação interno do registro.

• FieldContent é o conteúdo do campo de contexto para esse registro. Você pode usar esse campo para passar informações adicionais para o script (por exemplo, usuário atual, carimbo de data/hora e valores de campo). Se o campo contiver JSON válido, ele será incluído como um valor JSON em vez de uma string de texto. Se não existir um campo de contexto correspondente na tabela, uma string vazia será usada.

Quando uma confirmação afeta registros em várias tabelas de base, cada tabela tem sua própria matriz sob a chave "Nome de arquivo". Quando registros em tabelas relacionadas de outros arquivos são afetados, cada arquivo tem sua própria chave de nível superior.

O campo de contexto é especificado na opção Nome do campo ao configurar este gatilho. Se Nome do campo for deixado em branco, o gatilho procurará um campo chamado AoTransacionarJanela em cada tabela de base. Se nenhum campo correspondente for encontrado em uma tabela, FieldContent será uma string vazia para registros dessa tabela.

Notas

• Esse gatilho é configurado por arquivo. Se os registros forem modificados em uma tabela relacionada em outro arquivo, essas entradas de registro serão incluídas no parâmetro JSON, mesmo que esse outro arquivo não tenha o gatilho de script AoTransacionarJanela configurado.

• Para registros excluídos, os dados do campo de contexto são capturados antes que o registro seja excluído. Para registros novos e modificados, os dados do campo de contexto são capturados após os registros serem confirmados.

• Registros ou transações revertidos não ativam esse gatilho. Veja as etapas de script Reverter registro/solicitação e Reverter transação.

• O acesso direto ao banco de dados via FileMaker Data API ou OData API não ativa esse gatilho. No entanto, scripts executados através dessas APIs podem ativá-lo.

• Para um exemplo de script de registro de auditoria para usar com AoTransacionarJanela, consulte este post do Claris Engineering Blog.

Tópicos relacionados

• Definição de gatilhos de script para um arquivo

• Configuração de gatilhos de script

• Função Get(ScriptParameter)

• Etapa de script Abrir transação

• Etapa de script Confirmar transação