apitdn/fluig_rag_docs/Plataforma Documentação técnica/Recurso de Páginas e Widgets (WCM)/Central de componentes.md

---
title: Central de componentes
source: https://tdn.totvs.com/display/fluig/Central+de+componentes
path: \Plataforma  Documentação técnica\Recurso de Páginas e Widgets (WCM)\Central de componentes.md
---

# Índice

- 1 [Objetivo](#Centraldecomponentes-Objetivo)
- 2 [Fazer download de um componente](#Centraldecomponentes-Fazerdownloaddeumcomponente)
- 3 [Customização de um componente](#Centraldecomponentes-Customizaçãodeumcomponente)
- 4 [Adicionar um componente no no TOTVS Fluig Plataforma](#Centraldecomponentes-AdicionarumcomponentenonoTOTVSFluigPlataforma)
- 5 [Ativar/Desativar um componente](#Centraldecomponentes-Ativar/Desativarumcomponente)
- 6 [Redeploy de componentes (Atualização de componentes)](#Centraldecomponentes-Redeploydecomponentes(Atualizaçãodecomponentes))

## Objetivo

A Central de Componentes permite gerenciar todos os componentes existentes na plataforma. É possível adicionar componentes adquiridos na [Fluig Store](http://www.fluigstore.com/) e, também, baixar componentes para personalizá-los e importá-los novamente. A opção de *download* é exibida apenas para componentes que permitem desenvolvimentos sobre a plataforma.

## Fazer *download* de um componente

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

![](..\..\images\Download%20componente.gif)

## Customização de um componente

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

1. Descompacte o .zip;
2. Importe o projeto Maven através do pom.xml no Eclipse ou sua IDE de preferência;
3. No arquivo application.info altere os seguintes parâmetros:  
   1. **application.code**=NOME\_DA\_SUA\_WIDGET
   2. **locale.file.base.name**=NOME\_DA\_SUA\_WIDGET
   3. Remova o parâmetro **application.extendible**=true
   4. Adicione o parâmetro **application.origincode**=NOME\_DA\_WIDGET\_ORIGINAL. Exemplo: **socialtimeline**.
4. Altere o nome dos arquivos de internacionalização do diretório **src/main/resources**, substuindo o nome do widget atual pelo nome de seu 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**
5. Altere 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. O widget está pronto para ser customizado e compilado para poder ser feito o upload!

## Adicionar um componente no no TOTVS Fluig Plataforma

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

- Acesse o**Painel de controle** → agrupador **Aplicativos** → **Central de componentes**.

![](..\..\images\Painel%20de%20Controle%20165.png)

Em atualizações anteriores à **1.6.5 (Liquid)**, a Central de componentes é acessada pela aba **WCM** no **Painel de controle**.

- Acione **Escolher arquivo** e selecione o arquivo do componente para publicação na plataforma Fluig.

- Acione **Enviar** para fazer a publicação.

![](..\..\images\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.

![](..\..\images\add_componente_3.png)

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

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

- Selecione o componente na lista de componentes.

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

![](..\..\images\Ativar%20componente.gif)

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

- Selecione o componente na lista de componentes.

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

![](..\..\images\Desativar%20componente.gif)

Atenção!

Orientamos que o componente (.war ou .ear) não seja removido manualmente da pasta **apps/**. Essa remoção trará impactos consideráveis pois o comando de *undeploy* é acionado executando as seguintes ações para cada item abaixo:

- *Widget* (**.war**):
  - Remove todas as *widgets* de todas as páginas;
- *Layout* (**.war**):
  - Remove todas as páginas**\*** que utilizam esse *layout*;
- Tema (**.war**):
  - Remove todas as páginas**\*** que utilizam esse tema;
- *Component* (**.ear**):
  - Remove todas as páginas desse componente.

Removendo manualmente, **o processo de recuperação é irreversível**, dado que todos os registros desse componente também serão removidos do banco de dados pois não serão mais utilizados.

**\*** As páginas internas não são removidas, como por exemplo: **cpaneladmin**

Recomendação

Recomendamos que o processo correto seja feito desativando estes componentes através da Central de componentes que é encontrada no menu **Painel de Controle** > agrupador **Aplicativos** > **Central de componentes**.

## *Redeploy* de componentes (Atualização 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. Exemplo:

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