O objetivo da macro é efetivar uma série de transações na base de dados.

Nas aplicações de formulário, existem eventos que realizam transações com a base de dados (Ex: onAfterInsert, onAfterUpdate, onAfterDelete, onBeforeInsert, onBeforeUpdate, onBeforeDelete, etc...). Portanto, o controle de transações desses eventos é feito pelo próprio Scriptcase, desde que a conexão seja a mesma da aplicação.

Contudo, caso o usuário precise realizar qualquer tipo de redirecionamento nesses eventos, é necessário o uso da macro sc_commit_trans() antes da realização do mesmo, para garantir as transações efetuadas anteriormente. Ex:

onAfterUpdate - Usando redirecionamento após atualização de registro:

sc_commit_trans();
sc_redir('grid_main');

O parâmetro "conexão" é opcional, sendo necessário apenas se o comando for executado em uma base de dados diferente da especificada para a aplicação.