Esta tela centraliza a listagem e a manutenção de todas as conexões de servidores de banco de dados homologadas no sistema. É através deste painel que o administrador gerencia os caminhos de acesso que permitirão, mais adiante, a extração de dados para a geração dos relatórios. 


Para acessar a tela usamos o caminho: Configurações->Provedores de Dados->Conexões de Bancos de Dados:


Fig. 01

Visão Geral da Tabela

A grade exibe um resumo das credenciais e endereços configurados, permitindo uma batida de olho rápida nos seguintes indicadores:

  • Nome do Servidor / Número da Porta: Indica o endereço lógico ou IP e a porta de rede do servidor onde o banco de dados está hospedado.
  • Usuário: O login de autenticação utilizado pelo sistema para se conectar ao servidor.
  • Apelido / Descrição: Identificações amigáveis criadas para facilitar o reconhecimento daquela conexão dentro do sistema (ex: SERVER_01, AdventureWorks).
  • Data de Criação: Registra o momento exato em que a conexão foi cadastrada.
  • Tipo de Banco: Identifica a tecnologia do banco de dados relacional que está sendo acessada (ex: SQLServer, PostgreSQL).

Ações Disponíveis

  • Botão Adicionar: Localizado no topo superior direito, abre o formulário para o cadastramento e parametrização de uma nova conexão do zero.
  • Ícone Lápis (Editar): Abre a tela de alteração dos parâmetros daquela linha específica para ajustes de credenciais ou servidores.
  • Ícone Lixeira (Remover): Exclui a definição de conexão do sistema.


Adicionar Conexão

Esta tela permite configurar e estruturar o acesso a um novo banco de dados. O sistema oferece duas abordagens para o cadastro: o preenchimento assistido através de campos individuais ou a digitação direta de uma linha de conexão customizada.


Fig. 02


Campos de Preenchimento Padrão

  • Tipo de Banco de Dados: Menu de seleção que lista todas as tecnologias de banco de dados homologadas e suportadas pelo sistema (ex: SQL Server, PostgreSQL).
  • Nome do Servidor: O endereço lógico do servidor de banco de dados na rede (pode ser o nome DNS da máquina ou o seu endereço IP).
  • Usuário / Senha: As credenciais de autenticação que o sistema usará para obter permissão de leitura no banco de dados indicado.
  • Nome do Banco de Dados: O nome da base de dados específica que contém as tabelas que serão consultadas.
  • Número da Porta: A porta de comunicação de rede do servidor (se deixada em branco, o sistema assume a porta padrão da tecnologia selecionada).
  • Apelido: Um nome amigável e único que você deve atribuir a esta conexão. É através deste apelido que você identificará esta origem de dados em outras telas do sistema.


Configurações Avançadas e Customização

  • Opções extras para compor a string de conexão: Caixa de texto livre para o caso de você precisar informar parâmetros adicionais exigidos pelo seu ambiente de banco de dados (ex: chaves de criptografia, timeouts específicos ou configurações de SSL). O texto digitado aqui será automaticamente agregado e concatenado aos campos informados acima.
  • Caixa de Seleção (String de Conexão Completa): Ao marcar a caixa de seleção localizada ao lado do editor de texto inferior, o comportamento da tela muda completamente:
    • O sistema passará a ignorar totalmente todos os campos de entrada superiores (Servidor, Banco, Usuário, etc.).
    • O texto digitado nesta caixa será o ÚNICO dado utilizado para estabelecer o canal com o banco de dados.
    • Regra Obrigatória para a Senha: Mesmo usando o texto completo, o preenchimento do campo Senha superior continua sendo obrigatório por questões de segurança. Para que o sistema injete a senha digitada no local correto da sua linha de texto, você deve obrigatoriamente incluir o marcador {password} (com chaves) dentro da sua string.
    • Exemplo: Database=MeuBanco;Userid=Joao;Password={password}


Ações de Validação e Salvamento

  • Botão Testar Conexão: Antes de salvar, utilize este botão. O sistema tentará realizar um aperto de mão em tempo real com o servidor utilizando os parâmetros fornecidos, exibindo uma mensagem de sucesso ou o erro retornado pela rede. É a garantia de que o relatório não falhará por erro de digitação.
  • Botão Salvar: Grava a estrutura da nova conexão no banco de dados da aplicação.
  • Botão Cancelar: Aborta a operação e retorna para a listagem sem salvar as alterações.