Índice

Objetivo

A Central de Componentes é um recurso do fluig que permite a desenvolvimento de componentes disponíveis na plataforma. Você pode efetuar o download do componente desejado, personalizá-lo da maneira que desejar e enviar ele novamente para o fluig. A opção de download está disponível somente para os componentes compatíveis para personalização.

Fazer download de um componente

Para personalizar um componente, primeiramente é necessário fazer o download do mesmo pela Central de Componentes.

TOTVS Fluig > Central de componentes > download_componente.gif

Customização de um componente

Após o download da widget, o desenvolvedor deve realizar os seguintes passos antes de iniciar a alteração da widget:

Descompactar o .zip
Importar o projeto Maven através do pom.xml no Eclipse ou sua IDE de preferência
No arquivo application.info alterar os seguintes parâmetros:
1. application.code=NOME_DA_SUA_WIDGET
2. locale.file.base.name=NOME_DA_SUA_WIDGET
3. Remover o parâmetro application.extendible=true
4. Adicionar o parâmetro application.origincode=NOME_DA_WIDGET_ORIGINAL. Exemplo: socialtimeline.
Alterar o nome dos arquivos de internacionalização do diretório src/main/resources, substuindo o nome da widget atual pelo nome de sua widget:
1. *.properties para NOME_DA_WIDGET.properties
2. *_en_US.properties para NOME_DA_WIDGET_en_US.properties
3. *_es.properties para NOME_DA_WIDGET_es.properties
4. *_pt_BR.properties para NOME_DA_WIDGET_pt_BR.properties
Alterar o contexto do projeto Web no arquivo jboss-web.xml localizado no diretório src/main/webapp/WEB-INF:
1. <context-root>/NOME_DA_WIDGET</context-root>

Pronto. A widget está pronta para ser customizada e compilada para poder ser feito o upload!

Adicionar um componente no fluig

Para adicionar um componente no fluig, deve-se fazer login como administrador e seguir os passos abaixo.

Acessar Painel de Controle → aba WCM → Central de Componentes.

TOTVS Fluig > Central de componentes > add_componente_1.gif

Acionar Escolher arquivo e selecionar o arquivo do componente para publicação no fluig.

Acionar Enviar para fazer a publicação.

TOTVS Fluig > Central de componentes > add_componente_2.gif

Após o envio, o componente será exibido na lista de componentes. É possível usar o campo Buscar, localizado no canto direito da página, para encontrá-lo.

TOTVS Fluig > Central de componentes > add_componente_3.png

O componente utilizado no exemplo acima, Notificações SMS, pode ser adquirido através da fluig Store.

Ativar/Desativar um componente

Por padrão, ao incluir um novo componente na plataforma, este componente virá desativado. Para ativá-lo, deve-se seguir os passos abaixo.

Pesquisar pelo componente que deseja-se ativar através do campo Busca localizado no canto direito da página.

Selecionar o componente na lista de componentes.

Acionar Ativar. Será exibida uma mensagem confirmando a ativação e o status do componente será alterado para Ativo.

TOTVS Fluig > Central de componentes > ativar_componente.gif

Pesquisar pelo componente que deseja-se desativar através do campo Busca localizado no canto direito da página.

Selecionar o componente na lista de componentes.

Acionar Desativar. Será exibida uma mensagem confirmando a desativação e o status do componente será alterado para Inativo.

TOTVS Fluig > Central de componentes > inativar_componente.gif

Redeploy de Componentes

Quando um componente é modificado, se ele possui o arquivo "pages.xml", é necessário clicar em Ativar novamente para criar as novas páginas.

A Central de Componentes agirá da seguinte maneira:

Para as páginas já existentes.
- Se a página possui rascunho, ele será liberado como uma versão nova e a página que está no componente será a próxima versão. Ex.:
  - página criada pela publicação de componente - v1;
  - usuário editou a página - criou um rascunho e não liberou;
  - novo componente é deployado e a página em questão faz parte desse componente: rascunho criado pelo usuário é liberado, criando a v2. Com a publicação do componente, a v3 da página é criada de acordo com o componente. Desta forma, o usuário não perde alterações realizadas - se ele desejar pode restaurar a v2 como nova versão da página - v4.
- Para páginas sem rascunhos será criada apenas uma nova versão e liberada. Ex.:
  - página criada pela publicação de componente - v1;
  - novo componente é deployado e a página em questão faz parte desse componente: com a publicação do componente, a v2 da página é criada de acordo com o componente. Desta forma, o usuário não perde alterações realizadas - se ele desejar pode restaurar a v1 como nova versão da página - v3.
Para as páginas novas.
- Será feita a criação e publicação delas.

Caso a nova versão do componente não tenha mais algumas páginas será necessário desativar e reativar o componente. Ex.:

componente publicado com 5 páginas;
ativar o componente (criação das páginas);
alteração do arquivo "pages.xml", removendo páginas;
enviar novamente o componente com 2 páginas;
desativar (exclui as páginas existentes);
ativar novamente.

Se o componente não for desativado, as páginas ainda existirão.