A funcionalidade Banco de Dados é responsável por vincular um ou mais bancos de dados ao seu sistema, além de definir os perfis (ambientes) que cada banco terá acesso.

Ao criar um projeto no Cronapp, o banco de desenvolvimento H2 já vem configurado por padrão. Porém, quando é preciso testar a conexão com banco de dados ou no momento da publicação deve-se substituir esse banco. O Cronapp possui suporte aos principais bancos de dados do mercado: MySQL, SQL Server, PostgreSQL, Oracle, DB2, Derby e Firebird.

Gerenciar banco

A figura abaixo apresenta os elementos da janela principal da funcionalidade de Banco de dados.

Figura 1 - Ferramenta de configuração com o banco de dados

1. Banco de dados: essa funcionalidade pode ser aberta por diferentes locais.
   • Ícone do menu do sistema (destaque 1 da figura 1).
   • Caminho Projeto > Banco de dados do menu do sistema.
   • Arquivo context.xml, quando o Modo Avançado estiver habilitado.
2. Coluna Nome: lista de conexões de banco de dados.
3. Coluna Perfil: lista de perfis associados a cada conexão de banco de dados.
4. Editar banco: abre a área de edição do banco de dados selecionado (Figura 1.1).
5. Remover banco: remove o banco de dados selecionado.
6. Manipular dados: abre o gerenciador de SQL do banco de dados selecionado.
7. Importar arquivo Excel: permite importar uma ou mais planilhas do Excel.
8. Exportar arquivo de populate: permite exportar em JSON os dados do banco selecionado.
9. Perfis: abre a área de edição de perfis.
10. Novo: abre a área para adição de novo banco de dados (Figura 1.1).

Novo banco de dados

Os campos abaixo serão exibidos ao editar (destaque 4 da figura 1) ou ao adicionar um novo banco de dados (destaque 10 da figura 1). Os campos e seus nomes irão variar com base no Fabricante de banco de dados selecionado.

Figura 1.1 - Adicionando novo banco

Campos

• Banco de dados na nuvem: caso tenha um banco no serviço de cloud do Cronapp, selecione-o aqui para preencher automaticamente todos os outros campos abaixo. (acesse o tópico "Banco de dados" em Serviços de Cloud para mais detalhes).
  • Novo banco de dados na nuvem: abre uma nova aba na janela dos serviços de cloud para criar um banco de dados.

• Nome: nome da conexão do banco, identifica o banco dentro da IDE.
  

  Após criada a conexão, não é possível editar o campo Nome da conexão.

  Ao criar uma conexão, informe o nome de uma conexão existente para atribuir um perfil diferente a conexão. Veja mais detalhes no tópico Perfis.

• Perfil: escolha um perfil de banco de dados para associar a conexão. Ex.: Desenvolvimento, Produção ou outro criado. 
  • Remover perfil: esse botão exclui o perfil selecionado.
• Fabricante: escolha do fabricante do banco de dados, que podem ser:
  • MySQL;
  • H2;
  • PostgreSQL;
  • DB2;
  • SQL Server;
  • Oracle;
  • Derby;
  • Firebird.
• Usuário: usuário do banco de dados.
• Senha: senha do usuário do banco de dados.
• Nome Banco: (destaque 1 da figura 1.1) selecione um dos bancos (esquemas) existentes ou informe manualmente para criar.
  No fabricante MySQL, esse campo muda seu nome para Esquema.
  
  • Atualizar lista de Bancos (schemas): (destaque a da figura 1.1) atualiza as opções da caixa de seleção.
  • Criar database: (destaque b da figura 1.1) cria um novo banco (schema).
• Servidor: endereço do servidor.
• Porta: porta usada pelo banco de dados.
• Nome Instância / Esquema: (destaque 2 da figura 1.1) lista de instâncias/esquemas obtidos do banco de dados. Utilize vírgula "," para separar as instâncias/esquemas: "esquema1,esquema2,esquemaN".
  A depender do fabricante selecionado, esse campo altera seu nome/título ou não é exibido:
  • Esquema: PostgreSQL e Oracle.
  • Nome Instância: SQL Server.
  • Não é exibido: MySQL, H2, DB2, Derby e Firebird.
• Tipo: esse campo será exibido apenas ao selecionar o fabricante "Oracle", nele é possível selecionar como será montado a conexão com o banco de dados, via "SID" ou "Service name".  

Botões

• OK: retorna para a janela principal. Essa opção não salva as alterações, utilize o ícone Salvar dos botões de atalho (CTRL + S). 
• Cancelar: volta para a tela inicial do banco de dados.

• Testar Conexão: verifica se a conexão do banco está funcionando corretamente.
  

  Se o nome/esquema informado no campo Nome Banco (ou Esquema, dependendo do fabricante) não estiver presente na lista, uma caixa de diálogo será exibida para confirmar a criação do novo banco/esquema.

  
  

• Manipular dados: abre uma janela para fazer manipulação do banco de dados através da ferramenta de gerenciamento de banco de dados.
  
• Avançado: abre a janela de configuração dos atributos da conexão (Figura 1.2).

Atributos da conexão

A janela de Atributos de conexão é acessível a partir do botão Avançado (Figura 1.2) e possui diversos campos para a personalização avançada da conexão com o banco de dados. Normalmente não é necessário alterar essas configurações ao adicionar um novo banco de dados, pois o Cronapp configura automaticamente todos os campos necessários e o seu uso é destinado a usuários experientes em banco de dados.

A partir dessa janela é possível obter o driver utilizado para a conexão com o banco (campo driverClassName) e a string de conexão JDBC (campo url).

Figura 1.2 - Janela com os atributos da conexão do banco de dados

Instância / Esquema

O conceito da estrutura do banco de dados e suas instâncias ou esquemas variam conforme o fabricante do banco de dados. Em geral, os esquemas (schema) ou bancos são estruturas lógicas usadas para armazenar os dados em um banco de dados. Para cada banco de dados criado, existirão estruturas (a depender do fabricante terá o nome de banco ou schema) com suas tabelas, views, relacionamentos e outros objetos particulares, e para o usuário que os acessa, serão na prática como bancos de dados separados.

O campo Novo Banco (possui esse nome ao selecionar o banco SQL Server, por exemplo) da figura 1.3 lista os bancos existentes (master) e permite criar outro ao informar um novo nome e clicar no botão Criar Database (destaque 1).

Para os bancos de dados SQL Server, PostgreSQL e Oracle será exibido mais um campo de texto, Nome Instância (SQL Server) ou Esquema (PostgreSQL e Oracle). Esse campo permite informar uma instância/esquema ou várias, separando-as por vírgula, exemplo: "esquema1,esquema2,esquemaN".

Figura 1.3 - Criação de um esquema (banco) no SQL Server

Perfis

Você pode criar perfis para representar diferentes ambientes de execução, como produção, homologação e teste. Cada conexão de banco de dados pode estar vinculada a vários perfis diferentes e cada perfil dessa conexão apontará para um banco de dados físico específico, como H2, MySQL ou PostgreSQL (Figura 1.4).

Normalmente, banco de dados vinculados a perfis de uma mesma conexão possuem a mesma estrutura de tabelas, colunas e relacionamentos, mudando apenas os dados contidos nela.

A representação na figura abaixo mostra uma conexão vinculada a três perfis. Dois desses perfis se conectam ao banco de dados "MySQL 1", enquanto o perfil "Produção" está conectado a um banco de dados separado, o "MySQL 2".

Figura 1.4 - Exemplo de relação entre conexão, perfis e bancos de dados

Os perfis são selecionáveis a partir de diversas ferramentas do Cronapp, dessa forma, é possível garantir quais bancos serão executados a partir da ação a ser executada. 

Exemplo de recursos que utilizam os perfis de conexão:

• Publicação no Serviços de cloud do Cronapp.
• Exportação do projeto para o formato *.war.
• Criação de parâmetros do sistema.
• Utilização de VPN.
• Execução do projeto em modo Debug, ao clicar na seta ao lado do botão Rodar (play), uma caixa de seleção exibirá os perfis do projeto (Figura 1.5).

Figura 1.5 - Selecionando perfil antes de executar o projeto na IDE

Novo perfil

Para criar um perfil, clique no botão Perfis na janela do Banco de Dados (destaque 9 da Figura 1). 

Os perfis "DEV" e "PROD" já existem em todos os projetos e serão representados pelos termos "Desenvolvimento" e "Produção" respectivamente. Para criar um perfil, clique no botão Novo (destaque 3 da figura 1.6) e informe um nome no novo campo.

Figura 1.6 - Aba de edição de perfil

1. Perfil: coluna com campos editáveis dos nomes dos perfis. Campos recém inseridos exibirão o texto em amarelo.
2. Remover perfil: só é possível remover perfis que não estão associados a nenhuma conexão de banco de dados.
3. Novo: inclui um campo na coluna de perfis.

• OK: retorna para a janela principal. Essa opção não salva as alterações, utilize o ícone Salvar dos botões de atalho (CTRL + S). 
• Cancelar: retorna para a janela principal e ignora a edição atual dos perfis.

Vincular perfil a conexão

Para incluir outro perfil em uma conexão de banco de dados é necessário que tanto a conexão quanto o novo perfil já tenham sido criados.

Usaremos de exemplo a configuração apresentada na Figura 1.5, nela, a conexão "testeAB" possui um perfil "Produção" que está conectado a um banco de dados MySQL. Incluiremos outro perfil ("Desenvolvimento") também conectado a um banco MySQL.

Crie uma nova conexão de Banco de dados a partir do botão Novo (destaque 10 da figura 1) e configure como na imagem abaixo.

Figura 1.7 - O vínculo do perfil a uma conexão é feito a partir de uma nova conexão com o mesmo nome

1. Nome: informe o nome exato da conexão que deseja incluir o perfil.

2. Perfil: selecione o novo perfil para a conexão.
   

   Atenção ao selecionar um perfil já vinculado, pois os novos dados serão atualizados para o perfil selecionado.

   
   

3. Fabricante: selecione o fabricante de banco de dados relacionado ao perfil.
4. Dados de conexão: informe os dados de acesso ao banco de dados. Para detalhes sobre os campos, acesse o tópico Novo banco de dados.

Clique em OK (figura 1.7) para retornar a lista de conexões e visualizar o perfil vinculado a conexão (destaque 1 da figura 1.8). Nesse momento, as configurações da ferramenta Banco de Dados ainda não estão salvas, clique em Salvar (2 da figura 1.8). 

Figura 1.8 - Resultado da inclusão do novo perfil

Manipular dados

O Sistema de Gerenciamento de Banco de Dados (SGBD) online do Cronapp permite que adicione dados, consulte, crie tabelas virtuais e procedures e entre outros. Ao abrir pela primeira vez, suas tabelas só serão mostradas após rodar ou executar o projeto.

Figura 3 - Sistema de gerenciamento de banco de dados

Importar arquivo Excel

A funcionalidade Banco de dados (context.xml) do Cronapp nos permite adicionar arquivos do Excel e converter em tabelas do banco de dados. Ele se comporta exatamente como uma tabela criada diretamente no Diagrama de dados. É importante salientar que as abas (sheets) das planilhas vão gerar os nomes das tabelas e cada linha será um registro (tupla) da tabela. A coluna Id é gerada automaticamente pelo Cronapp, portanto, não se faz necessário inserir uma coluna id no arquivo excel. 

Figura 4 - Importando arquivo do Excel para o banco de dados.

1. Clique no ícone Importar arquivo Excel;
2. Selecione o arquivo do seu computador, ou clique e arraste para a tela de Envio de arquivo;
3. Finalize a operação de importação do arquivo clicando em OK.

Para verificar se sua tabela foi importada para o banco de dados, clique na opção Manipular dados (Figura 1). Faça uma consulta simples e observe o resultado. No exemplo da figura abaixo estamos verificando que a tabela ALUNOS foi importada no arquivo Aluxos.xlsx (Figura 4).

Figura 4.1 - Verificando se a tabela foi importada.

Exportar arquivo de populate

Há uma funcionalidade do Banco de Dados (context.xml) que permite exportar um JSON que poderá ser utilizado para alimentar o arquivo populate.json com os dados de uma ou mais tabelas do banco de dados selecionado, como mostrado na figura 5.

Figura 5 - Exportando arquivo de populate

1. Clique no ícone para exportar o arquivo de populate.
2. Selecione o namespace do Diagrama de dados.

3. Selecione a tabela com os dados que deseja exportar.

   Só serão exibidas as tabelas que possuem classes referenciadas no diagrama selecionado. 

Por fim, será baixado um arquivo JSON onde poderá incluir no populte.json, acesse a documentação Arquivo populate json para mais detalhes sobre como trabalhar com o arquivo populate.json.

Context.xml

Ao abrir o arquivo do banco de dados, context.xml (Endereço: config/context.xml), com o editor de texto é possível ver o xml que exibe todas as informações dos bancos de dados configurados em seu projeto no Cronapp (Figura 6).

Ao selecionar um perfil que não exista para uma conexão, o Cronapp utilizará o primeiro perfil listado para aquela conexão no arquivo context.xml. No exemplo da figura abaixo existem 3 perfis ("DEV", "PROD" e "QA"). Caso uma conexão esteja vinculada a apenas dois desses perfis (ex.: "DEV" e "PROD"), e o perfil selecionado durante a execução do projeto seja "QA", o Cronapp executará o primeiro perfil dessa lista para aquela conexão.

Figura 6 - Abrir banco de dados como texto

Elementos:

• <Profile>: lista de perfis do projeto.
• <Resource>: lista de conexões vinculada a perfis. Uma conexão com dois perfis vão gerar dois elementos <Resource> no arquivo context.xml.