VBA - Access - Ajuda sobre DoCmd.OutputTo
Aprenda a usar o método VBA DoCmd.OutputTo para exportar objetos no Access
Este tutorial prático do Microsoft Access explica como utilizar o método DoCmd.OutputTo e o método DoCmd.TransferSpreadSheet para exportar diferentes objetos para tipos específicos de arquivos, como exportar uma Consulta para o formato .xlsx. Essa técnica é essencial para automatizar processos de exportação e facilitar o manuseio de dados.
Entendendo a sintaxe do método DoCmd.OutputTo
A sintaxe básica do método DoCmd.OutputTo é a seguinte:
DoCmd.OutputTo (ObjectType, ObjectName, OutputFormat, OutputFile, AutoStart, TemplateFile, Encoding, OutputQuality)| Parâmetro | Obrigatório | Descrição |
|---|---|---|
| ObjectType | Sim | Tipo do objeto a ser exportado |
| ObjectName | Sim | Nome do objeto a exportar, como o nome da consulta ou relatório |
| OutputFormat | Sim | Formato do arquivo de saída, por exemplo, acFormatXLSX para Excel |
| OutputFile | Sim | Caminho completo do arquivo gerado, por exemplo: C:\teste\relatorio.xlsx |
| AutoStart | Opcional | True para abrir o arquivo após exportação, False para não abrir (padrão é False) |
| TemplateFile | Opcional | Caminho de um arquivo modelo para exportações HTML, HTX ou ASP |
| Encoding | Opcional | Tipo de codificação de caracteres para dados de texto ou HTML |
| OutputQuality | Opcional | Tipo de qualidade da saída (ex.: otimizado para impressão ou tela) |
Tipos de objeto suportados para exportação
- acOutputForm (2) – Formulário
- acOutputFunction (10) – Função definida pelo usuário
- acOutputModule (5) – Módulo
- acOutputQuery (1) – Consulta
- acOutputReport (3) – Relatório
- acOutputServerView (7) – Vista do servidor
- acOutputStoredProcedure (9) – Procedimento armazenado
- acOutputTable (0) – Tabela
Formatos de saída disponíveis para exportação
- acFormatHTML – Arquivo HTML
- acFormatPDF – Arquivo PDF
- acFormatRTF – Arquivo Rich Text Format
- acFormatSNP – Snapshot
- acFormatTXT – Arquivo texto
- acFormatXLS – Arquivo Excel (antigo)
- acFormatXLSB – Arquivo Excel binário
- acFormatXLSX – Arquivo Excel moderno
- acFormatPS – Arquivo PostScript
Qualidade da saída para exportação
- acExportQualityPrint (0) – Otimizado para impressão
- acExportQualityScreen (1) – Otimizado para exibição em tela
Exemplo prático de uso do método DoCmd.OutputTo
Para exportar uma consulta chamada RelatorioVendas para um arquivo Excel .xlsx e abrir o arquivo automaticamente após a exportação, você pode usar o código abaixo:
DoCmd.OutputTo acOutputQuery, "RelatorioVendas", acFormatXLSX, "C:\Exportados\RelatorioVendas.xlsx", TrueEsse comando gera o arquivo no caminho especificado e abre o Excel para visualização imediata.
Dicas para garantir exportações eficientes e seguras no Access
- Sempre valide o caminho do arquivo para evitar erros de exportação.
- Utilize nomes de arquivos dinâmicos para evitar sobrescrita de arquivos.
- Prefira o formato acFormatXLSX para compatibilidade com versões modernas do Excel.
- Teste os scripts em ambientes de desenvolvimento antes de aplicar em produção.
Considerações finais sobre o uso do DoCmd.OutputTo para automatização
O método DoCmd.OutputTo é uma ferramenta poderosa para exportar dados de forma automatizada no Access, economizando tempo em processos repetitivos e garantindo padronização na geração de relatórios e planilhas. Combine esse método com outros recursos do VBA para criar sistemas mais completos e eficientes.
Importante: Sempre analise cuidadosamente seus dados e verifique as permissões de acesso antes de exportar informações sensíveis. Automatizar exportações não elimina a responsabilidade pela segurança e integridade dos dados.
Para mais informações detalhadas, consulte a documentação oficial da Microsoft Access: Método DoCmd.OutputTo - Microsoft Docs.