Criação da estrutura de um componente

A criação da estrutura de um componente requer que esse componente já esteja, ao menos, definido. Ou seja, que sua definição esteja criada (mesmo que essa venha a ser alterada no futuro) e que o componente já tenha sido implantado no ambiente no qual sua estrutura será criada.

Os passos do exemplo a seguir são feitos em um ambiente de desenvolvimento utilizando a IDE Eclipse. Como exemplo, suponha o seguinte projeto:

Nota-se que esse projeto contém um módulo, definido em sua raiz, e quatro componentes:

• br.com.minhaempresa.intranet,
• br.com.minhaempresa.intranet.noticias,
• br.com.minhaempresa.intranet.noticias.economia e
• br.com.minhaempresa.intranet.noticias.esportes.

Como exemplo, vamos supor que o workspace desse projeto esteja localizado em C:\Lumis\LumisPortalProjects\projeto-intranet\workspace, como mostra a figura abaixo:

Para que a estrutura do componente seja exportada para o local correto, é necessário configurar a pasta de código-fonte do servidor¹. Para isso, basta acessar Configurações > Informações > Configurações do Portal > Configurações de Ambiente , como é mostrado na figura abaixo:

Após isso, basta editar as configurações do servidor² e inserir o caminho base de códigos do servidor apontando para a pasta de workspace do ambiente, como na figura abaixo:

Também é necessário definir o caminho de source dos componentes. Esse caminho é o caminho relativo ao caminho base de códigos do servidor necessário para chegar à pasta do componente. Nesse exemplo, a pasta para todos os componentes e é intranet\src. Esse caminho (quando necessário) vai depender do layout adotado no projeto. Nesse exemplo, todos os arquivos componentdefinition.xml foram alterados adicionando o trecho de código destacado na imagem a seguir:

Após a implantação desses componentes no portal, eles serão exibidos no Gerenciador de Componentes da seguinte forma:

Uma vez que os componentes estejam implantados, a estrutura dos mesmos pode ser criada. Suponha que a seguinte estrutura seja criada:

Nesse caso, foi decidido que cada componente terá sua própria estrutura:

• Componente br.com.minhaempresa.intranet => canal /Portal/Intranet
• Componente br.com.minhaempresa.intranet.notícias => canal /Portal/Intranet/Notícias
• Componente br.com.minhaempresa.intranet.notícias.economia => canal /Portal/Intranet/Economia
• Componente br.com.minhaempresa.intranet.notícias.esportes => canal /Portal/Intranet/Esportes

É necessário associar os componentes aos seus respectivos canais. Para isso, basta ir em Configurações > Deployment e Performance Tuning > Implantação > Componentes e acionar a opção "Associar canal" em cada componente, como na figura abaixo:

Isso fará com que o portal abra a tela de associação de componente com canal, como na figura abaixo:

Basta associar cada componente a seu respectivo canal. Após isso, já pode-se exportar a estrutura do portal. Para isso, basta, no Portal Studio, clicar com o botão direito sobre o canal que deseja-se exportar, no exemplo iremos exportar o portal inteiro, e em seguida clicar em "Exportar", como na figura abaixo:

É importante validar que o tipo de exportação selecionado seja "Estrutura", como mostrado abaixo:

A exportação de estrutura levará em conta cada componente para que sua estrutura seja exportada para o local adequado (desde que o mesmo já esteja associado ao devido canal). Após a exportação ser concluída, pode-se ir na IDE de desenvolvimento e dar um refreshno projeto. Isso fará com que as estruturas de cada componente seja revelada no Project Navigator, como na figura abaixo:

Com isso, cada componente já possui a sua estrutura exportada no local adequado. No exemplo, a estrutura do componente br.com.minhaempresa.intranet ficaria em C:\Lumis\LumisPortalProjects\projeto-intranet\workspace\intranet\src\br\com\minhaempresa\intranet\componentfiles\structure.

Onde:

• C:\Lumis\LumisPortalProjects\projeto-intranet\workspace é a pasta base de código-fonte do servidor
• intranet\src é o caminho de código-fonte do componente
• br\com\minhaempresa\intranet é o caminho do componente
• componentfiles\structure é a subpasta da estrutura, dentro do componente

Genericamente, a estrutura de um componente será exportada em:

<pasta de código-fonte do servidor>[/<caminho de código-fonte do componente>]/<caminho do componente>/componentfiles/structure

Onde:

• pasta de código-fonte do servidor: é a pasta configurada nas Configurações de Ambiente ou, caso não esteja configurada, <portal install>/lumisdata/source
• caminho de código-fonte do componente: é o caminho definido no componente, caso haja.
• caminho do componente: é o caminho equivalente ao identificador do componente (ex.: componente br.com.minhaempresa.intranet tem um caminho de componente br/com/minhaempresa/intranet).