As macros de dados no Access permitem adicionar lógica a eventos que ocorrem em tabelas, como adicionar, atualizar ou excluir dados. Eles são semelhantes a "gatilhos" no Microsoft SQL Server. Este artigo mostra como criar e depurar macros de dados.
Neste artigo
Sobre macros de dados
As macros de dados são gerenciadas na guia Tabela ao exibir uma tabela no modo de exibição Folha de dados e não aparecem em Macros no Painel de Navegação. Entre outras coisas, você pode usar macros de dados para validar e garantir a precisão dos dados em uma tabela. Há dois tipos main de macros de dados: aqueles que são disparados por eventos de tabela (também chamados de macros de dados "controlados por eventos") e aqueles que são executados em resposta a serem chamados pelo nome (também conhecidos como macros de dados "nomeadas").
Criar uma macro de dados orientada a eventos
Eventos de tabela ocorrem sempre que você adiciona, atualiza ou exclui dados em uma tabela. Você pode programar uma macro de dados para ser executada imediatamente após qualquer um desses três eventos ou imediatamente antes de um evento de exclusão ou alteração. Use o procedimento a seguir para anexar uma macro de dados a um evento de tabela:
-
No Painel de Navegação, clique duas vezes na tabela à qual você deseja adicionar a macro de dados.
-
Na guia Tabela , no grupo Antes de Eventos ou no grupo After Events , clique no evento ao qual você deseja adicionar a macro. Por exemplo, para criar uma macro de dados que é executada depois de excluir um registro da tabela, clique em Após Excluir.
Observação: Se um evento já tiver uma macro associada a ele, seu ícone será exibido realçado na faixa de opções.
O Access abre o Macro Builder. Se uma macro foi criada anteriormente para este evento, o Access exibirá a macro existente.
-
Adicione as ações que você deseja que a macro execute.
-
Salve e feche a macro.
Para obter mais informações sobre como criar macros, consulte o artigo Criar uma macro de interface do usuário (interface do usuário).
Criar uma macro de dados nomeada
Uma macro de dados nomeada ou "autônoma" está associada a uma tabela específica, mas não a um evento específico. Você pode chamar uma macro de dados nomeada de qualquer outra macro de dados ou macro padrão.
-
No Painel de Navegação, clique duas vezes na tabela à qual você deseja adicionar a macro de dados.
-
Na guia Tabela , no grupo Macros Nomeados , clique em Macro Nomeada e clique em Criar Macro Nomeada.
O Access abre o Macro Builder, no qual você pode começar a adicionar ações.
Para obter mais informações sobre como criar macros, consulte o artigo Criar uma macro de interface do usuário (interface do usuário).
Sobre parâmetros
Os parâmetros permitem que você passe valores para uma macro de dados nomeada para que eles possam ser usados em instruções condicionais ou em outros cálculos. Eles também permitem que você passe referências de objeto de macros padrão para a macro de dados.
Observação: Os parâmetros não estão disponíveis em macros de dados de unidade de evento.
Para adicionar um parâmetro a uma macro de dados:
-
Na parte superior da macro, clique em Criar Parâmetro.
-
Na caixa Nome , digite um nome exclusivo para o parâmetro. Este é o nome que você usa para se referir ao parâmetro em expressões.
-
Opcionalmente, digite uma descrição para o parâmetro na caixa Descrição . Recomendamos que você insira uma descrição porque, posteriormente, quando você usa o parâmetro, o texto de descrição que você digita aqui é exibido em uma dica de ferramenta. Isso ajuda você a lembrar a finalidade do parâmetro.
Para executar uma macro de dados nomeada de outra macro, use a ação RunDataMacro . A ação fornece uma caixa para cada parâmetro criado, para que você possa fornecer os valores necessários.
Gerenciar macros de dados
As macros de dados não aparecem no Painel de Navegação em Macros. Você deve usar os comandos de faixa de opções no modo de exibição Table Datasheet ou Design de Tabela para criar, editar, renomear e excluir macros de dados.
Editar uma macro de dados orientada a eventos
-
No Painel de Navegação, clique duas vezes na tabela que contém a macro de dados que você deseja editar.
-
Na guia Tabela , no grupo Antes de Eventos ou no grupo After Events , clique no evento para a macro que você deseja editar. Por exemplo, para editar a macro de dados que é executada depois de excluir um registro da tabela, clique em Após Excluir.
Observação: Se um evento não tiver uma macro associada a ele, seu ícone não será realçado no menu.
O Access abre o Macro Builder e você pode começar a editar a macro.
Editar uma macro de dados nomeada
-
No Painel de Navegação, clique duas vezes em qualquer tabela para abri-la na exibição Datasheet.
-
Na guia Tabela , no grupo Macros Nomeados , clique em Macro Nomeada e, em seguida, aponte para Editar Macro Nomeada.
-
No submenu, clique na macro de dados que você deseja editar.
O Access abre o Macro Builder e você pode começar a editar a macro.
Renomear uma macro de dados nomeada
-
No Painel de Navegação, clique duas vezes em qualquer tabela para abri-la na exibição Datasheet.
-
Na guia Tabela , no grupo Macros Nomeados , clique em Macro Nomeada e clique em Renomear/Excluir Macro.
-
Na caixa de diálogo Gerenciador de Macro de Dados , clique em Renomear ao lado da macro de dados que você deseja renomear.
O Access seleciona o nome da macro atual.
-
Digite o novo nome ou edite o nome existente e pressione ENTER.
Excluir uma macro de dados
Use este procedimento para excluir qualquer macro de dados nomeada ou controlada por eventos:
-
No Painel de Navegação, clique duas vezes em qualquer tabela para abri-la na exibição Datasheet.
-
Na guia Tabela , no grupo Macros Nomeados , clique em Macro Nomeada e clique em Renomear/Excluir Macro.
-
Na caixa de diálogo Gerenciador de Macro de Dados , clique em Excluir ao lado da macro de dados que você deseja renomear.
Observação: Você também pode excluir uma macro controlada por eventos excluindo todas as suas ações.
Depurar macros de dados
Algumas ferramentas comuns de depuração de macro, como o comando Etapa Única e a ação macro MessageBox, não estão disponíveis para macros de dados. No entanto, se você estiver enfrentando problemas com uma macro de dados, poderá usar a tabela Log de Aplicativos em combinação com as ações de macro OnError, RaiseError e LogEvent para ajudar a encontrar erros de macro de dados.
Exibir a tabela Log do Aplicativo
A tabela Log do Aplicativo é uma tabela do sistema (chamada USysApplicationLog) que, por padrão, não é exibida no Painel de Navegação. Se ocorrer um erro em uma macro de dados, você poderá saber o que aconteceu exibindo as informações na tabela Log do Aplicativo.
Use o procedimento a seguir para exibir a tabela Log do Aplicativo:
-
Clique em Arquivo para abrir a exibição de Bastidores da Microsoft.
-
Na guia Informações , clique em Exibir Tabela de Log do Aplicativo.
Observação: Se você não vir o botão Exibir Tabela de Log do Aplicativo , isso significa que uma tabela do Log de Aplicativos ainda não foi criada para este banco de dados. Depois que um evento for registrado, o botão aparecerá na guia Informações .
Você pode criar linhas na tabela Log de Aplicativos usando a ação LogEvent ou a ação RaiseError e controlar como o Access reage a erros usando a ação OnError.
