Criar uma macro de dados

As macros de dados no Access permitem-lhe adicionar lógica a eventos que ocorrem em tabelas, tais como adicionar, atualizar ou eliminar dados. São semelhantes aos "gatilhos" no Microsoft SQL Server. Este artigo mostra-lhe como criar e depurar macros de dados.

Neste artigo

• Acerca de macros de dados
• Criar uma macro de dados condicionada por eventos
• Criar uma macro de dados com nome
• Gerir macros de dados
• Depurar macros de dados

Acerca de macros de dados

As macros de dados são geridas a partir do separador Tabela durante a visualização de uma tabela na vista de Folha de Dados e não aparecem em Macros no Painel de Navegação. Entre outras coisas, pode utilizar macros de dados para validar e garantir a exatidão dos dados numa tabela. Existem dois tipos principais de macros de dados: as que são acionadas por eventos de tabela (também denominadas macros de dados "orientadas por eventos") e as que são executadas em resposta a serem chamadas pelo nome (também conhecidas como macros de dados "com nome").

Início da Página

Criar uma macro de dados condicionada por eventos

Os eventos de tabela ocorrem sempre que adiciona, atualiza ou elimina dados numa tabela. Pode programar uma macro de dados para ser executada imediatamente após qualquer um destes três eventos ou imediatamente antes de um evento delete ou change. Utilize o seguinte procedimento para anexar uma macro de dados a um evento de tabela:

1. No Painel de Navegação, faça duplo clique na tabela à qual pretende adicionar a macro de dados.

2. No separador Tabela , no grupo Antes de Eventos ou Depois de Eventos , clique no evento ao qual pretende adicionar a macro. Por exemplo, para criar uma macro de dados que é executada após eliminar um registo da tabela, clique em Após Eliminar.

   Nota

   Se um evento já tiver uma macro associada, o respetivo ícone aparece realçado no friso.

   O Access abre o Construtor de Macros. Se tiver criado anteriormente uma macro para este evento, o Access apresenta a macro existente.

3. Adicione as ações que pretende que a macro execute.

4. Guarde e feche a macro.

Para mais informações sobre como criar macros, consulte o artigo Criar uma macro de interface de utilizador (IU).

Início da Página

Criar uma macro de dados com nome

Uma macro de dados com nome ou "autónoma" está associada a uma tabela específica, mas não a um evento específico. Pode chamar macros de dados com nome a partir de qualquer outra macro de dados ou macro padrão.

1. No Painel de Navegação, faça duplo clique na tabela à qual pretende adicionar a macro de dados.
2. No separador Tabela , no grupo Macros com Nome , clique em Macro Com Nome e, em seguida, clique em Criar Macro Com Nome.
   O Access abre o Construtor de Macros, onde pode começar a adicionar ações.

Para mais informações sobre como criar macros, consulte o artigo Criar uma macro de interface de utilizador (IU).

Acerca dos parâmetros

Os parâmetros permitem-lhe transferir valores para uma macro de dados com nome para que possam ser utilizados em instruções condicionais ou outros cálculos. Também lhe permitem transferir referências de objetos de macros padrão para a macro de dados.

Para adicionar um parâmetro a uma macro de dados:

1. Na parte superior da macro, clique em Criar parâmetro.
2. 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.
3. Opcionalmente, digite uma descrição para o parâmetro na caixa Descrição . Recomendamos que introduza uma descrição porque, posteriormente, quando utilizar o parâmetro, o texto de descrição que escrever aqui será apresentado numa descrição. Isto ajuda-o a lembrar-se do objetivo do parâmetro.

Para executar uma macro de dados com nome a partir de outra macro, utilize a ação ExecutarMacroDeDados. A ação fornece uma caixa para cada parâmetro criado, para que você possa fornecer os valores necessários.

Início da Página

Gerir macros de dados

As macros de dados não são apresentadas no Painel de Navegação em Macros. Tem de utilizar os comandos do friso na Vista de Folha de Dados de Tabela ou na Vista de Estrutura da Tabela para criar, editar, mudar o nome e eliminar macros de dados.

Editar uma macro de dados condicionada por eventos

1. No Painel de Navegação, faça duplo clique na tabela que contém a macro de dados que pretende editar.

2. No separador Tabela , no grupo Antes de Eventos ou Depois de Eventos , clique no evento da macro que pretende editar. Por exemplo, para editar a macro de dados que é executada após eliminar um registo da tabela, clique em Após Eliminar.

   Nota

   Se um evento não tiver uma macro associada, o respetivo ícone não será realçado no menu.

   O Access abre o Construtor de Macros e pode começar a editar a macro.

Editar uma macro de dados com nome

1. No Painel de Navegação, faça duplo clique em qualquer tabela para abri-la na vista de Folha de Dados.
2. No separador Tabela , no grupo Macros com Nome , clique em Macro com Nome e, em seguida, aponte para Editar Macro Com Nome.
3. No submenu, clique na macro de dados que pretende editar.
   O Access abre o Construtor de Macros e pode começar a editar a macro.

Mudar o nome de uma macro de dados com nome

1. No Painel de Navegação, faça duplo clique em qualquer tabela para abri-la na vista de Folha de Dados.
2. No separador Tabela , no grupo Macros com Nome , clique em Macro com Nome e, em seguida, clique em Mudar o Nome/Eliminar Macro.
3. Na caixa de diálogo Gestor de Macros de Dados , clique em Mudar o Nome junto à macro de dados cujo nome pretende mudar.
   O Access seleciona o nome da macro atual.
4. Escreva o novo nome ou edite o nome existente e, em seguida, prima ENTER.

Eliminar uma macro de dados

Utilize este procedimento para eliminar qualquer macro de dados com nome ou condicionada por eventos:

1. No Painel de Navegação, faça duplo clique em qualquer tabela para abri-la na vista de Folha de Dados.
2. No separador Tabela , no grupo Macros com Nome , clique em Macro com Nome e, em seguida, clique em Mudar o Nome/Eliminar Macro.
3. Na caixa de diálogo Gestor de Macros de Dados , clique em Eliminar junto à macro de dados cujo nome pretende mudar.

Início da Página

Depurar macros de dados

Algumas ferramentas de depuração de macro comuns, como o comando Passo a Passo e a ação de macro CaixaDeMensagem, não estão disponíveis para macros de dados. No entanto, se estiver a ter problemas com uma macro de dados, pode utilizar a tabela Registo da Aplicação em combinação com as ações de macro AoOcorrerErro, RaiseError e LogEvent para ajudar a localizar erros de macro de dados.

Apresentar a tabela Application Log

A tabela Application Log é uma tabela do sistema (chamada USysApplicationLog) que, por padrão, não é exibida no Painel de Navegação. Se ocorrer um erro numa macro de dados, poderá saber o que aconteceu ao ver as informações na tabela Registo de Aplicações.

Use o seguinte procedimento para exibir a tabela de log do aplicativo:

1. Clique em Ficheiro para abrir a vista Microsoft Backstage.

2. Na guia Informações , clique em Exibir Tabela de Log do Aplicativo.

   Nota

   Se não vir o botão Ver Tabela de Registo de Aplicações , isto significa que ainda não foi criada uma tabela de Registo de Aplicações para esta base de dados. Assim que um evento for registado, o botão será apresentado no separador Informações .

Pode criar linhas na tabela Registo de Aplicações ao utilizar a ação AoOcorrerEvento ou a ação AoOcorrerErro, e pode controlar a forma como o Access reage aos erros através da ação AoOcorrerErro.