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 e o Cronapp possui suporte aos principais bancos de dados do mercado: MySQL, SQL Server, PostgreSQL, Oracle, DB2, Derby e Firebird.

Gerenciar banco

A funcionalidade banco de dados (Endereço: config/context.xml) é responsável por vincular um ou mais bancos de dados ao seu sistema. Então, clique no menu Projeto > Banco de dados ou no ícone Banco de dados (destaques 1 da Figura 1).

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

1. Abrir ferramenta: é possível abrir a ferramenta através do menu Projeto > Banco de dados ou pelo ícone Banco de dados.
2. Editar banco: abre a área de edição do banco de dados selecionado (Figura 1.1).
3. Remover banco: remove o banco de dados selecionado.
4. Manipular dados: abre o gerenciador de SQL do banco de dados selecionado.
5. Importar arquivo Excel: permite importar uma ou mais planilhas do excel.
6. Exportar arquivo de populate: permite exportar em JSON os dados do banco selecionado.
7. Perfis: abre a área de edição de perfis.
8. Novo: abre a área para adição de novo banco de dados (Figura 1.1).

Novo banco de dados

Tanto ao editar um banco quanto adicionar um novo, ele abrirá a área de edição (Figura 1.1).

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 com os serviços de cloud.
• Nome: nome da conexão do banco, identifica o banco dentro da IDE;
• Perfil: escolha do perfil do banco de dados: 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;
  • MariaDB e
  • MongoDB (não relacional).
• Usuário: usuário para o banco de dados.
• Senha: senha do usuário para o banco de dados.
• Nome Banco: selecione um dos bancos existentes ou informe um novo.
  No fabricante MySQL, esse campo muda seu nome para Esquema.
  
  1. Atualizar lista de Bancos (schemas): atualiza as opções da caixa de seleção;
  2. Criar database: cria um novo banco (schema).
• Servidor: endereço do servidor.
• Porta: porta usada pelo banco de dados.
• Nome Instância / Esquema: lista de instâncias/esquemas obtidos do banco de dados. Utilize vírgula "," para separar as instâncias/esquemas: "esquema1,esquema2,esquemaN".
  Os esquemas informados nesse campo serão utilizados para exibir e filtrar as tabelas durante a engenharia reversa.
  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, 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: salva a configuração do banco de dados.
• Cancelar: volta para a tela inicial do banco de dados.
• Testar Conexão: verifica se a conexão do banco está funcionando corretamente.
• 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.1.1).

Atributos da conexão

Normalmente não é necessário alterar as configurações da janela atributos de conexão ao adicionar um novo banco de dados, pois o Cronapp configura automaticamente os campos necessários.

Figura 1.1.1 - Janela com os atributos da conexão do banco

Instância / Esquema

O conceito da estrutura do banco de dados e suas instâncias ou esquemas variam conforme o 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) da figura 1.1.2 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.1.2 - Criação de um esquema (banco) no SQL Server

Perfis

O Cronapp permite que sejam criados perfis que serão vinculados a diferentes bancos de dados cadastrados no projeto. No momento em que for rodar o projeto, é possível selecionar um dos perfis/banco de dados clicando na seta ao lado do botão Play (debug) da aplicação.

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

Novo perfil

Por padrão, ao criar um projeto, os perfis desenvolvimento e produção já são criados. Então, para adicionar um perfil, clique no botão Perfis para abrir sua aba de configuração (Figura 1.2.1).

Figura 1.2.1 - Aba de edição de perfil

• Novo: adiciona um campo na coluna Perfil para informar um novo perfil, que deve ter nome único;
  1. Ao adicionar um campo, o ícone de lixeira é adicionado para aquele campo com o intuito de remover o campo.
• OK: salva as configurações que foram modificadas no perfil e volta para a aba principal do banco;
• Cancelar: cancela as configurações que foram modificadas no perfil e volta para a aba principal do banco.

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 1.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 2 - 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 (destaque 4 da figura 1). Faça uma consulta simples e observe o resultado. No exemplo da figura 2.1 estamos verificando que a tabela importada, Alunos, consta no nosso banco de dados.

Figura 2.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 3.

Figura 3 - Exportando arquivo de populate

1. Clique no ícone para exportar o arquivo de populate.
2. Selecione o diagrama.
3. Selecione a tabela com os dados que deseja exportar.

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 em modo 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 4).

Então, na árvore do projeto, Configurações > Banco de dados e clique com o botão direito sobre o arquivo e selecione Abrir com > Editor de texto.

Figura 4 - Abrir banco de dados como texto