O serviço de Páginas Personalizadas possui um ambiente administrativo disponibilizado pelo administrador do portal, para o cadastro de widgets. Os widgets cadastrados podem ser alterados ou excluído.
Todos os widgets que serão utilizados na personalização de páginas do portal são criados a partir de serviços Lumis sejam eles serviços padrões do próprio produto ou serviços desenvolvidos por usuários.
No contexto de criação de widgets existem alguns pontos importantes a serem destacados:
| 1. | Toda interface de serviço do tipo “Lista Rápida” sempre será passível de se tornar um widget; |
| 2. | Para que uma interface de serviço, que não é do tipo “Lista Rápida”, esteja disponível na lista de interfaces que podem ser widgets é necessário adicionar a configuração “<isWidget>true</isWidget>” na definição da interface de serviço (Código 1). |
| a. | Por padrão essa configuração é inserida automaticamente, caso não exista, com o valor igual a “false”. |
<interface id="details" name="STR_DETAILS" type="lum_contentDetails"> <styles> <style id="style" name="STR_DETAILS" isDefault="1" path="lumis/service/image/style/ImageDetails.xsl"/> <style id="styleWidget" name="STR_DETAILS_WIDGET" path="lumis/service/image/style/DetailsWidget.xsl" isWidgetDefault="true"/> </styles> <isWidget>true</isWidget> </interface> |
Código 1 - XML de Definição da Interface de Serviço
| 3. | Fica a cargo do desenvolvedor do serviço elabora um XSL que renderize o widget adequadamente. Caso o desenvolvedor deseje elaborar um XSL para a interface de forma que a mesma se comporte diferente de um widget, o mesmo poderá definir um estilo para o renderização padrão e outro estilo para a renderização do widget. Para o segundo, é necessário informar o atributo “isWidgetDefualt” sendo “true” (Código 1), para que no momento da renderização do widget este estilo seja aplicado automaticamente. |
| 4. | Por padrão algumas interfaces de serviços do Lumis Portal estão disponíveis para a criação de widgets. São elas: |
| • | Serviço de Agenda de Eventos – Interface Lista Rápida |
| • | Serviço de Avisos – Interface Lista Rápida |
| • | Serviço de Comentários – Interface Lista Rápida |
| • | Serviço de Consumidor WSRP – Interface Portlet Remoto |
| • | Serviço de Contatos – Interface Lista |
| • | Serviço de Fórum – Interface Lista de Fóruns |
| • | Serviço de HTML – Interface HTML |
| • | Serviço de Links – Interface Lista Rápida |
| • | Serviço de Notícias – Interface Lista Rápida |
| • | Serviço de Sala de Chat – Interface Lista Rápida |
| • | Serviço de Visualizador de Webservice – Interface Visualizador |
| • | Serviço de Wiki – Interface Exibe Artigo |
A Figura 1 apresenta a interface de administração de widgets. Esta interface permite ao administrador adicionar, alterar ou remover widgets que serão utilizados na personalização de páginas.
Figura 1 - Administração de Widget
A Figura 2 apresenta a tela de adição de widget. Nesta tela existem as seguintes informações:
| • | Nome: Nome do widget. Este nome será exibido na lista de widgets durante a personalização de uma página. |
| • | Instância de serviço: Instância de serviço que será considerada para a criação do widget. |
| • | Descrição: Breve descrição sobre o widget. |
| • | Ícone: Imagem que será exibida para o widget na lista de widgets. Caso não seja informada uma imagem, será utilizada uma imagem padrão. |
| • | Interface: Interface da instância de serviço selecionada que será o widget. |
| • | Estado: Estado em que se encontra o widget. Os estados possíveis são os definido pelo workflow corrente. |
| • | Responsável: Usuário responsável pelo widget. |
Figura 2 - Adição de Widget: visão simplificada
A tela de adição de widget possui um modo de seleção de instância de serviço avançada conforme Figura 3. Nesta visualização o usuário poderá escolher qual o tipo serviço e a partir dele escolher qual instância será utilizada.
Figura 3 - Adição de Widget: visão avançada
Nessa tela também existe uma opção de configurações avançadas de customização da interface de serviço que será utilizada para a criação do widget. As opções de configuração são exibidas na Figura 4. Nesta tela é possível, por exemplo, definir qual XSL será utilizado para o widget, além de outras opções, caso o padrão não seja definido ou desejado.
Figura 4 - Customização do widget