Índice

Objetivo

O objetivo deste guia é apresentar os elementos que constituem a estrutura de uma página no TOTVS Fluig Plataforma.

Elementos de uma Página

O Fluig Plataforma é constituído de páginas e essas possuem os seguintes elementos: Layout, Slots e Widgets.

Uma página é constituída de um layout, que por sua vez possui slots que definem o posicionamento e a disposição dentro do layout onde os widgets são inseridos. Toda página permite definir o o modo de visualização como pública ou privada.

Página privada

Para determinar que uma página esteja acessível apenas aos usuários autenticados na plataforma, ao criá-la ou editá-la basta selecionar a opção "AUTHENTICATED" no campo "Autorização". Desta maneira, somente usuários autenticados terão acesso a esta página.

Caso um usuário acesse uma página cuja autorização seja Authenticated sem estar autenticado, ele será redirecionado para a página de login. Somente após a autenticação ele poderá visualizar a página solicitada.

Criação de páginas - Autorização: AUTHENTICATED

Página pública

Para determinar que uma página seja acessada também por usuários que não estejam autenticados, ao criá-la ou editá-la, basta selecionar a opção "PUBLIC" no campo "Autorização". Desta maneira, usuários visitantes e autenticados conseguem visualizar a página pública.

Criação de páginas - Autorização: PUBLIC

PathParam

A plataforma Fluig permite que uma página contenha parâmetros em sua URL de forma que seja possível recuperá-los em um layout ou qualquer widget inserido na página. Cada parâmetro é nomeado pelo formato "p" seguido da sua ordem na URL, por exemplo, "p1", "p2", "p3", etc. É possível recuperar cada parâmetro na URL diretamente no seu template Freemarker.

Por exemplo: http://meufluig.com/portal/p/meutenant/reservadesala/sala73/08:00/12:00

Definir comportamento distinto para um widget em páginas públicas ou autenticadas

É possível desenvolver um widget para que ele se comporte de forma diferente quando estiver em um contexto privado (com "/p" na URL) ou público (sem "/p" na URL). Para esses casos, pode-se utilizar os seguintes comandos:

No arquivo *.js:

if(WCMAPI.getUserIsLogged()){
	// Executa uma ação quando o usuário estiver autenticado
} else {
	// Executa outra quando não estiver
}

No arquivo *.ftl:

<#if widgetRender.isUserLogged()==true >
	<!-- Executa uma ação quando o usuário estiver autenticado -->
<#else>
	<!-- Executa outra quando não estiver -->
</#if>

Layout

Toda página da plataforma Fluig é constituída por um layout que define a estrutura dela o que diz respeito ao posicionamento e ao tamanho dos slots.

Slots

Os slots servem para organizar os widgets dentro de um layout. Eles são áreas pré-definidas dentro do layout onde os widgets podem ser distribuídos na ordem desejada para atender a cada necessidade.

Widgets

Dentro de uma página os widgets são os componentes concretos, que podem exibir e consultar informações, variando de componente para componente.