Open the menu

    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:

    creation_of_the_structure_of_a_component_000

    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:

    creation_of_the_structure_of_a_component_001

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

    creation_of_the_structure_of_a_component_002

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

    creation_of_the_structure_of_a_component_003

    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:

    creation_of_the_structure_of_a_component_004

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

    creation_of_the_structure_of_a_component_005

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

    creation_of_the_structure_of_a_component_006

    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:

    creation_of_the_structure_of_a_component_007

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

    creation_of_the_structure_of_a_component_008

    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:

    creation_of_the_structure_of_a_component_009

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

    creation_of_the_structure_of_a_component_010

    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:

    creation_of_the_structure_of_a_component_011

    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).