Groupware Workbench Tutorial de instalação da Aplicação-Exemplo no Eclipse Neste tutorial foram utilizadas as seguintes ferramentas: Eclipse versão 3.4.1 disponível em http://www.eclipse.org o Obs: Esta versão do eclipse é a eclipse-jee-ganymede-sr1-macosx-carbon. Apache-Tomcat versão 6.0 disponível em http://tomcat.apache.org/ mysql-5.1.30-osx10.5-x86_64 disponível em http://dev.mysql.com/downloads/mysql/5.1.html Presume se que o leitor tenha instalado estes softwares ou similares. A bancada funciona também em outros sistemas operacionais e no Microsoft Access. 1º Configuração da bancada Faça o download dos arquivos em http://code.google.com/p/groupware-workbench/downloads/list e descompacte-os numa pasta de fácil acesso. Serão descompactados os seguintes arquivos: GW Application Gerenciador de projetos GW CollabComponents GW Commons GW Component Frameworks GW Tools GW Widgets commons
Abra a IDE Eclipse, importe os arquivos clicando em: File > Import > General -> Existing Projects into Workspace Clique em next -> Browse e selecione a pasta onde foi feita a descompactação dos arquivos. Figura 1 Importando os módulos para Workspace Marque os módulos que serão importados, marque a opção Copy projects into workspace, e clique em finish. O eclipse indicará que existem erros nas pastas do projeto, a solução destes problemas serão feitas a seguir. Obs: O passo seguinte é necessário caso o Apache Tomcat ainda não esteja configurado no eclipse. Selecione o GW- Application Gerenciador de projetos, em seguida clique em Run -> Run As -> Run on Server Selecione Apache -> Tomcat v6.0 Server -> next.
Figura 2 Configurando o Tomcat no eclipse Na nova janela clique em browse..., selecione a pasta onde está instalado o Apache Tomcat e clique em finish. Aplique as dependências clicando na pasta do projeto, como por exemplo GW- Application Gerenciador de projetos, clique em File -> properties. Na nova janela clique em Java Build Path, clique na aba Projects e adicione os módulos dependentes como na figura abaixo: Figura 3 Inserindo dependências nos módulos Clique na aba Libraries e verifique se estão adicionadas as bibliotecas como mostrada na figura abaixo.
Figura 4 Adição de bibliotecas Repita o procedimento com os módulos que apresentarem este problema. Obs: Após inserir as dependências nos módulos, persistindo o problema, provavelmente é a codificação do workspace. Clique em Eclipse -> Preferences. Na nova janela clicar em General -> Workspace, mude o campo Text file enconding alterando para others e selecione (ISO-8859-1), clique em apply. Figura 5 Alterando codificação do Workspace
2º Configuração do banco de dados Para usar o banco de dados MySQL, abra o arquivo frameworkdescriptor.xml dentro de WEB-INF -> Components -> tools-deployment. Coloque o nome do banco logo após localhost como no exemplo, que é projetos, preencha os campos de usuário do banco e senha caso o banco possua uma senha. <database> <dialect> MYSQL </dialect> <driver> com.mysql.jdbc.driver </driver> <connectionurl> jdbc:mysql://localhost/projetos?user=root&password= </connectionurl> </database> <specificcomponentframeworkconfiguration> <maintool> environment/environmentmgr </maintool> </specificcomponentframeworkconfiguration> </frameworkdescriptor> Para utilizar o banco MSAccess comente o banco MySQL e retire os comentários do MSAccess. <!-- <database> <dialect> MSAccess </dialect> <driver> sun.jdbc.odbc.jdbcodbcdriver </driver> <connectionurl> jdbc:odbc:projetos </connectionurl> </database> --> Repita o processo com o frameworkdescriptor.xml dentro do collabcomponent-deployment. Certifique que o banco de dados foi criado no MySQL com o mesmo nome descrito no frameworkdescriptor.xml. 3º Testando a aplicação Selecione a aplicação GW- Application Gerenciador de projetos e clique em Run -> Run As -> Run on Server. Na nova janela selecione o Tomcat e clique em finish.
Figura 6 Iniciando a aplicação Se não houver imprevistos a tela que aparecerá será: Digite no Login : admin e Senha: 123. Figura 7 Tela inicial
4º Instalação de componentes Para instalar um componente, copie a pasta do componente para o grupo desejado. Por exemplo, copie o FAQ para participant-tools, dentro do diretório WEB-INF/Components/tools-deployment/participant-tools, como mostrado na figura: Figura 8 instalação de um componente Neste momento o componente estará instalado. Na página do projeto o componente estará disponível com o nome de FAQ colaborativo, como pode ser visto na figura abaixo. Figura 9 Componente instalado em Ferramentas
É Possível copiar um mesmo componente para mais de um contexto, como pode ser visto na figura acima, há duas instâncias do mesmo componente FAQ. Também é possível criar instâncias subordinadas do componente, como no exemplo abaixo, onde é acrescentado ao tooldescriptor.xml, dentro de WEB-INF/Components/tools-deployment/ProjectMgr, o grupo que está inserido o componente como mostra o exemplo abaixo: <subordinate-tools> <tool-group>participant-tools</tool-group> </subordinate-tools> Verifique se a instância subordinada foi inserida, criando um novo projeto, clicando em Criar novo projeto, como mostra a figura abaixo. Figura 10 Criação de novo projeto Clicando no projeto em questão poderemos ver o componente instalado com o nome de FAQ colaborativo, como mostra a figura.
5º Desinstalação do Componentes Figura 11 Ferramenta subordinada Para desinstalar o componente, delete-o do diretório e todas as configurações serão removidas automaticamente, inclusive as estruturas do banco de dados. 6º Alterações do Componente Algumas alterações podem ser feitas, no tooldescriptor.xml do componente, alterando e/ou acrescentando algo ao componente. Como exemplo é modificado o nome do componente, de FAQ colaborativo para FAQ teste na seção: <tool-name> FAQ colaborativo </tool-name> As modificações podem ser vistas nas figuras abaixo. Antes:
Figura 12 Nome do FAQ antes da modificação Depois: Figura 13 Nome do FAQ depois da modificação 7º Dúvidas? Caso tenha ficado alguma dúvida ou problema. Envie um email para Lucas Santos em lucasso@ime.usp.br ou para Marco Aurélio em gerosa@ime.usp.br.