As aplicações desenvolvidas no Cronapp não possuem lock-in e podem ser exportadas para serem desenvolvidas em outras plataformas, pois o conteúdo é extraído em código padrão, sem componentes proprietários, de forma organizada, otimizada e atualizada em linguagem padrão de mercado.

Veremos abaixo como importar e exportar os projetos desenvolvidos no Cronapp.

Importar projeto

Para importar um projeto, clique com o botão direito do mouse sobre o nome do projeto na árvore de arquivos e selecione a opção Importar (Figura 1). Na nova janela, selecione as opções: Soap ou Zip.

Figura 1 - Opções para importar projetos

• Soap: o web service SOAP (Simple Object Access Protocol) é utilizado para disponibilizar serviços interativos e possibilitar a comunicação entre diferentes aplicações através do protocolo SOAP.

• Zip: permite importar um projeto compactado em um arquivo *.zip.

Soap

Abra a opção Importar, conforme a Figura 1. Na nova janela (Figura 1.1), selecione a opção Soap e clique em Finalizar. Preencha as informações na janela Importar SOAP e clique em Importar ao final.

Figura 1.1 - Importar web service SOAP

Zip

Abra a opção Importar, conforme a Figura 1. Na nova janela (Figura 1.2), selecione a opção Zip e clique em Finalizar. Clique em Selecionar na próxima janela para escolher o arquivo em seu Sistema Operacional, espere carregar e clique em OK.

Figura 1.2 - Importar arquivo .zip

Exportar projeto

Clique com o botão direito do mouse sobre o nome do projeto na árvore de arquivos e selecione a opção Exportar (Figura 2). Na nova janela, abrirão as opções: War, Exportar para repositório Git, Biblioteca e Zip.

Figura 2 - Opções para exportar projetos

• War: o WAR (Web application ARchive) é um arquivo com o conteúdo da aplicação compactado em uma estrutura pronta para ser executada em um servidor Java web, como o Apache Tomcat.
• Exportar para repositório Git: o repositório Git é um sistema de controle de versões distribuído. Versionar um projeto com o Git é uma boa prática no desenvolvimento de software, principalmente no desenvolvimento colaborativo.
• Biblioteca: a funcionalidade de biblioteca permite fazer uma cópia de alguns recursos selecionados de um projeto Cronapp e utilizá-lo, de forma totalmente independente, em outro projeto, dentro ou fora da plataforma Cronapp.
• Zip: essa opção compacta todo o conteúdo do projeto em um único arquivo *.zip, mantendo a mesma estrutura de arquivos.

Exportar para repositório Git

Abra opção Exportar, conforme a Figura 2. Na nova janela (Figura 2.1), selecione a opção Exportar para repositório git e clique em Avançar. Preencha as informações da janela Versionar o projeto para um repositório Git e clique em Finalizar. Aguarde o progresso e verifique no seu repositório se o projeto foi exportado.

Figura 2.1 - Exportar para repositório Git

Biblioteca

Abra opção Exportar, conforme a Figura 2. Na nova janela (Figura 2.2), selecione a opção Biblioteca e clique em Finalizar. 

Figura 2.2 - Exportar Biblioteca

Na janela Informações de Geração de Biblioteca, confira os dados apresentados e clique em OK para iniciar a compilação da biblioteca e, depois de algum tempo, iniciará automaticamente o download do arquivo *.jar. Acesse a documentação Importar e exportar bibliotecas para mais detalhes.

1. Id do Contrato: identificador do seu contrato dentro do Cronapp. 
2. Recursos: exibe a lista de Fontes de dados e Blocos de programação servidor marcados com a opção Exportar Biblioteca.

Zip

Abra a opção Exportar e na nova janela (Figura 2.3), selecione a opção Zip (destaque 1 da figura 2.3) e clique em Finalizar. O download será feito automaticamente.

Figura 2.3 - Exportar para repositório Zip

War

Abra a opção Exportar, conforme a Figura 2. Na nova janela (Figura 2.4), selecione a opção War e clique em Finalizar. Na janela Opções da Geração de War, configure suas propriedades e clique em OK. O download será feito automaticamente.

Figura 2.4 - Exportar o arquivo .war do projeto

Opções de Geração de war:

• Perfil: perfis dos bancos de dados usados no desenvolvimento do projeto: Desenvolvimento, Produção ou outro criado no context.xml.
• Tipo de Geração: define as ações que serão tomadas com o banco de dados.
  
  • Manter como configurado: mantém as mesmas configurações aplicadas no momento da geração da persistência no Diagrama de Classe;
  • Criar ou Atualizar Tabelas: use essa opção para gerar as tabelas do banco de dados pela primeira vez ou caso tenha adicionado novas classes e não tenha feito alterações nas que já existem. Essa opção não apaga os dados do banco de dados;
  • Apagar e Recriar Tabelas: apaga todas as tabelas, incluindo seus dados, do banco de dados e recria tudo novamente com as novas alterações feitas;
  • Utilizar Tabelas Existentes: não realiza alterações no banco de dados;
• Auto Popular Dados: após criar as tabelas do banco de dados, os dados contidos no arquivo populate.json serão inseridos automaticamente.
• Dados de Conexão Embutidos: ao desmarcar, tanto os dados de conexão com o banco de dados quanto os parâmetros do sistema configurados não serão incluídos no arquivo *.war,  sendo necessário configurá-los posteriormente no servidor da aplicação.
• Exportar PWA ou Incluir Projeto Mobile: inclui no pacote *.war o diretório mobileapp/ com o conteúdo do projeto mobile. Esse recurso pode ser utilizado para o PWA. Mais detalhes na documentação Cronapp PWA.

Caso o Perfil selecionado contenha um banco de dados local (H2), mesmo que não utilizado, e a opção Dados de Conexão Embutidos esteja marcada, uma mensagem de alerta será exibida. (Figura 2.5)

Figura 2.5 -  Mensagem de confirmação de uso de banco de dados local

Exportando war via comando (High-code)

É possível parametrizar as propriedades da janela Opções de Geração de war no comando Maven "mvn package". Esses parâmetros são úteis para usuários que automatizam entregas/integração contínuas (CD/CI pipeline) através de ferramentas externas, como por exemplo, o Jenkins.

Os parâmetros extras do "mvn package" são:

• cronapp.profile: tipo de perfil (DEV, PROD etc - Padrão: DEV).
• cronapp.generationType: indica qual o tipo de geração de entidades (Para mais detalhes, acesse a documentação do eclipseLink):
  • create-tables: manter como configurado;
  • create-or-extend-tables: criar ou atualizar tabelas;
  • drop-and-create-tables: apagar e recriar tabelas;
  • none: manter como configurado (Padrão).
• cronapp.populate: indica se deve incluir o populate.json (true/false - Padrão: true);
• cronapp.useContext: indica se deve incluir o context.xml com dados de conexão (true/false - Padrão: true);
• cronapp.mobileapp: indica se deve incluir o projeto mobile (true/false - Padrão: false).

Cada parâmetro deve ser precedido com "-D", como no exemplo abaixo:

mvn package -Dcronapp.profile=DEV -Dcronapp.populate=true -Dcronapp.useContext=true -Dcronapp.generationType=create-tables -Dcronapp.mobileapp=true

Figura 2.6 - Exportar o arquivo .war do projeto por linha de comando

Os arquivos .war gerados são encaminhados para o diretório "~/project/target" e ficam acessíveis apenas via terminal.