Índice

Objetivo

O objetivo deste guia é detalhar o suporte a exibição de páginas e widgets da plataforma fluig no aplicativo fluig mobile.

Definições Gerais 

Para que uma página esteja disponível no aplicativo mobile, deve existir pelo menos uma instância de Widget habilitada para o aplicativo mobile na página. Para habilitar as instâncias de Widgets para o aplicativo mobile será necessário:

1. Acessar o modo de edição da página;
2. Assinalar quais widgets da página serão apresentadas no aplicativo mobile, clicando no ícone Habilitar no aplicativo mobile. Este ícone só estará presente para widgets que possuam suporte ao aplicativo mobile;
   1. As Widgets com compatibilidade para o aplicativo Mobile são:
      1. Editor de Conteúdo
      2. Documentos Populares
      3. Endereço WEB
      4. Analytics
      5. kit aniversariantes
      6. Visualização de Artigos
   2. Para habilitar a widget no aplicativo mobile, acessar o mode de edição de página, adicionar a widget desejada e clicar no ícono conforme a imagem:

1. Publicar a nova versão da página. 

A renderização das páginas no aplicativo mobile será enxuta, apresentando apenas o conteúdo das widgets habilitadas sequencialmente, conforme exemplo abaixo:

Como criar um Widget com suporte a dispositivos mobile

Para o desenvolvimento de Widgets com suporte à dispositivos mobile deve ser adicionado a propriedade application.mobileapp no arquivo application.info com o valor true (Arquivo application.info está localizado dentro da widget). Este propriedade será processada e persistida na base de dados durante o processo de deploy da Widget.

application.type=widget
application.code=news
application.title=Not\u00EDcias da Semana
application.description=Exibe uma lista com as \u00FAltimas not\u00EDcias da semana
application.category=KitIntranet	
application.renderer=freemarker
application.icon=icon.png
developer.code=developer
developer.name=TOTVS S.A.
developer.url=http://www.fluig.com
view.file=view.ftl
edit.file=edit.ftl
application.uiwidget=true
application.resource.js.1=/resources/js/news.js
application.resource.css.2=/resources/css/news.css
simple.deploy=false
application.mobileapp=true

Foi adicionado a variável booleana mobileAppMode no template do FreeMarker que determinará se a Widget está sendo renderizada através de uma requisição do aplicativo mobile. O fluig irá verificar o header User-Agent da requisição e caso seja oriundo do aplicativo mobile o valor da variável mobileAppMode será true. Através desta variável o desenvolvedor poderá modificar o comportamento da Widget quando renderizada pelo aplicativo mobile. O valor da variável mobileAppMode também estará disponível via JavaScript através do método WCMAPI.isMobileAppMode().

if (WCMAPI.isMobileAppMode()) {
    this.DOM.find('a').attr('href', '#');
}

API Pública

Está disponível serviço na API Pública para realizar a consulta de páginas do fluig. Esta consulta retornará somente as páginas que o usuário tenha permissão de visualização. O retorno do serviço será paginado com uma lista de PageVOs contendo as informações das páginas, entre elas a URL de acesso, URL do ícone, páginas filhas (quando houverem) e se está disponível para o aplicativo mobile. Será possível informar os seguintes filtros:

• parentPageCode: Código da página pai. Quando informado, retorna somente as páginas filhas da página informada.
• isMobile: Caso informado true retorna somente as páginas disponíveis para o aplicativo mobile.
• pageIndex: Caso informado, será o index da página a ser exibida
• pageSize: Caso informado, definirá a quantidade de registros por página.
• searchLevel: Caso informado, busca hierarquicamente as páginas filhas .
• internalPages: Caso informado true, a consulta de páginas resultará somente em paginas internas da plataforma.
• filter: String para filtrar o dados em caso de busca.

Desenvolvimento de widgets Mobile

Todas as interfaces devem ser desenvolvidas nativamente, com exceção da visualização das  widgets da página que será renderizada pelo webview nativo de cada plataforma.

Qualquer tipo a autenticação requerido pela widget é de inteira responsabilidade do servidor do fluig (SSO, por exemplo), o mobile é apenas responsável por mostrar o HTML retornado pelo servidor no webview.

Para maiores detalhes clique aqui