Configuração do Eclipse
A distribuição recomendada do Eclipse para o ambiente de desenvolvimento é a versão para Java EE, que pode ser obtida em http://www.eclipse.org/.
Ao se inicializar o Eclipse pela primeira vez, será solicitado o local do workspace a ser utilizado. No exemplo, foi utilizado C:\LumisPortalProjects\workspace .
Após a inicialização do Eclipse, pode-se perceber que não há projeto algum, como mostrado na imagem a seguir:
O primeiro passo para a montagem do ambiente de desenvolvimento é a importação do projeto do LumisPortal. O LumisPortal contém em sua instalação os arquivos necessários para a integração com o Eclipse.
Para importar o projeto, deve-se clicar com o botão direito no Project Explorer , depois selecionar a opção Import / Import ou através do menu File / Import .
Após isso, deve-se selecionar a opção Existing Projects into Workspace e clicar em Next .
Na próxima tela, deve-se selecionar a pasta raiz dos artefatos do ambiente de desenvolvimento ( C:\LumisPortalProjects, no exemplo ). Após isso, o projeto do LumisPortal deve ser exibido com o nome lumisportal . Deve-se selecioná-lo e clicar em Finish .
Após esse passo, o projeto do LumisPortal já deve ser exibido no Project Explorer .
Após isso, deve-se importar o XML catalog para facilitar o desenvolvimento. Esse arquivo contém as referências aos XSDs do portal. Para isso, deve-se, novamente, entrar na opção de Import .
Na tela de importação, deve-se selecionar a opção XML Catalog .
Quando solicitado, selecionar o arquivo lumisportal/development/eclipse/portal.xmlcatalog e clicar em Finish .
Para conferir se o XML catalog foi importado corretamente, pode-se ir na opção Window -> Preferences -> XML -> XML Catalog .
Em User Specified Entries devem existir as entradas dos XSDs do LumisPortal .
Após isso, será importado os templates de douidefinition e servicedefinition, basta importar na seguinte tela nas preferências do eclipse:
Após clicar no botão "Import...", selecione o arquivo xmltemplates.xml que se encontra no caminho "<instalação_do_lumisportal>/development/eclipse".
Ao finalizar a importação os seguintes itens deverão aparecer na listagem de itens:
Após isso, o servidor deve ser configurado, indicando-se o local de instalação do Apache Tomcat (no exemplo, /opt/apache-tomcat-9.0.14/ ):
É preciso modificar algumas configurações do servidor criado. Para isso, deve-se dar um duplo click na entrada do servidor para abrir a tela de edição.
Alem das opções marcadas na imagem acima, nas configurações de execução ("Open launch configuration") deve-se adicionar aos argumentos da VM: -Dlumis.portal.lumisDataPath=<instalação_do_lumisportal>/lumisdata/
.
Após esses passos, o LumisPortal pode ser iniciado e estará disponível para acesso.
Recomenda-se a utilização de módulos editáveis para desenvolvimento no LumisPortal. Para a criação do primeiro módulo editável, ver a próxima seção, Configuração do LumisPortal e Criação do primeiro Módulo Editável.