Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 1
Ttulo do documento Studio III Studio
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 2
Sumrio
1. Introduo ........................................................................................... 3 1.1. Objetivos do Treinamento .................................................................. 3 2. Formulrio ............................................................................................ 4 2.1. Preview do Formulrio ........................................................................ 6 2.2. Eventos do Formulrio ........................................................................ 8 2.3. Customizao do Formulrio .......................................................... 13 2.4. Exportar Formulrio ........................................................................... 17 2.5. Aviso ................................................................................................... 24 3. Relatrio no Fluig .............................................................................. 25 3.1. Verso BIRT ........................................................................................ 25 3.2. Anatomia do BIRT .............................................................................. 26 3.3. Acesso a Dados ................................................................................ 26 3.4. BIRT Engine ......................................................................................... 27 3.5. Parmetros ........................................................................................ 28 3.6. Fluig Tags ........................................................................................... 28 3.7. Passo a Passo .................................................................................... 29 4. Concluso ......................................................................................... 33
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 3 1. Introduo
Ol! Seja bem-vindo ao treinamento Studio III do curso Studio do Fluig.
1.1. Objetivos do Treinamento
Ao trmino deste treinamento voc ter conhecido mais sobre:
Criao do Formulrio. Preview de Formulrio. Eventos de Formulrio. Customizao de Formulrio. Exportar Formulrio para o servidor Fluig. Relatrios no Fluig.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 4 2. Formulrio
Os formulrios no Fluig so um tipo de pasta formatada, todos os documentos abaixo dessa estrutura tero o mesmo formato.
Uma Solicitao de Nota Fiscal, por exemplo, pode ser um formulrio no Fluig.
Todas as solicitaes desse formulrio iro possuir o mesmo formato e os mesmos campos a serem preenchidos.
O modelo de formatao da solicitao informado no formulrio.
A seguir, veja o passo a passo para a criao de um formulrio a partir do plugin Fluig Designer no Fluig.
Passo 1
Para criar um formulrio, clique com o boto direito do mouse na pasta Forms na viso Explorador de Pacote, acesse a opo Novo, Outras. A tela de seleo de assistente ser aberta, selecione a pasta Fluig clique em Formulrio e seguida em Avanar.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 5 Passo 2
Em seguida a tela de Criao de formulrio ser exibida, informe o Nome do formulrio e clique em Concluir.
Passo 3
A seguir, um pacote referente ao formulrio criado na pasta Forms e automaticamente a tela do Editor exibe o contedo HTML para edio.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 6 Passo 4
Neste exemplo, um simples formulrio de Cadastro foi desenvolvido.
Aps finalizar a edio do formulrio, possvel exportar para o servidor Fluig.
A exportao do formulrio para o servidor Fluig ser exibida no fim deste treinamento.
2.1. Preview do Formulrio
Esta funcionalidade permite a pr-visualizao de um formulrio, durante e aps a criao ou edio.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 7
A seguir, veja o passo a passo para pr-visualizar um formulrio no Fluig.
Passo 1
Para pr-visualizar um formulrio, selecione-o na pasta Forms na viso Explorador de Pacote do projeto Fluig.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 8 Passo 2
Aps selecionar o formulrio, ser exibido o cdigo em HTML no Editor.
Clique na aba Preview para pr-visualizar o Formulrio.
Passo 3
Aps clicar na aba Preview, o formulrio exibido.
2.2. Eventos do Formulrio
Os eventos so um conjunto de scripts desenvolvidos com o uso da linguagem JavaScript e possuem como objetivo personalizar um formulrio de acordo com a necessidade do usurio.
Podem ser criados a partir do plugin Fluig no Studio, no mesmo projeto da criao do formulrio e chamados ao longo da renderizao e utilizao destes em momentos pr-determinados.
A seguir, veja o passo a passo para criar eventos de formulrio no Fluig.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 9 Passo 1
Para criar um script de evento de formulrio, clique com o boto direito do mouse sobre pasta Forms na viso Explorador de Pacote, acesse a opo Novo e clique em Outras.
Passo 2
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 10 Nesta tela, expanda a pasta Fluig, selecione a opo Script Fluig e clique em Avanar.
Passo 3
Nesta tela selecione o tipo: Script Evento de Formulrio e clique em Avanar.
Passo 4
Os eventos disponveis para customizao do formulrio so:
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 11
Para mais detalhes sobre especificaes de cada evento, consulte a pgina Customizao de Formulrios, no endereo dev.fluig.com.
Escolha um evento e clique em Avanar.
Passo 5
Como exemplo, selecione o evento validadeForm.
A seguir, relacione o formulrio no campo Relacionar o formulrio e clique em Concluir.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 12
Passo 6
Ao concluir, a estrutura principal do mtodo estar disponvel no Editor.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 13 Passo 7
O evento utilizado como exemplo - validateForm, valida o preenchimento dos campos solicitao e usurio.
O objeto formController, foi utilizado para verificar o valor dos campos, atravs da sintaxe form.getValue(fieldname).
Ao exportar o formulrio para o servidor, os eventos criados tambm sero exportados.
2.3. Customizao do Formulrio
As customizaes so personalizaes e adaptaes realizadas em formulrios com o objetivo de adequ-los s necessidades especficas do usurio.
No Fluig pode se utilizar o formController que uma referncia ao formulrio, e o zoom que permite a listagem e seleo de dados provenientes de outras fontes de dados.
A seguir, veja como utilizar os recursos para customizao de formulrios no Fluig.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 14 formController
O formController o objeto que realiza a comunicao entre o formulrio e a customizao dos eventos.
Esse objeto est disponvel em cada um dos eventos de customizao de formulrios atravs da varivel form.
A varivel permite alterar os valores dos campos de um registro de formulrio e tambm obter o estado de edio deles, por exemplo: se o usurio est visualizando ou editando o registro de formulrio.
Veja a seguir como definir e obter o valor de um campo de registro de formulrio.
Todos os eventos do formulrio recebem a referncia ao registro de formulrio a ser preenchido.
Atravs dessa referncia possvel acessar/definir o valor de um campo e tambm modo de edio do registro de formulrio.
Para definir o valor de um campo do formulrio, utilize a funo:
form.setValue(fieldName, value);
Onde fieldName o campo do formulrio, e value o registro, ou seja, o valor a ser definido para o campo do formulrio.
Para obter o valor de um campo do formulrio, utilize a funo:
form.getValue(fieldName);
Onde fieldName o nome do campo do formulrio.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 15
possvel tambm obter o modo de edio do formulrio, para isso utilize a funo:
form.getFormMode ();
Os trs estados do formulrio so:
ADD: Criao do formulrio. MOD: Formulrio em edio. VIEW: Visualizao do formulrio. NONE: No h comunicao com o formulrio, por exemplo, ocorre no momento da validao dos campos do formulrio onde este no est sendo apresentado.
Zoom
O componente de Zoom do Fluig foi desenvolvido para permitir que o recurso fosse utilizado em formulrios.
O acesso a este componente realizado a partir de uma chamada JavaScript no HTML do formulrio.
Confira na imagem a url padro para a chamada do zoom, onde:
title: o ttulo para a janela de zoom. datasetId: o nome do dataset (Built-in, CardIndex ou Customized).
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 16 dataFields: so os nomes dos campos a serem apresentados. resultFields: so os campos que devem ser retornados para o registro selecionado pelo usurio. likeField: o nome do campo para filtro de dados (se necessrio). likeValue: o valor a ser usado no filtro de dados (se necessrio).
Para mais detalhes sobre as chamadas de zoom, consulte a pgina Customizao de Formulrios, no endereo dev.fluig.com.
Para obter o registro selecionado pelo usurio no zoom, utilize a seguinte funo JavaScript no formulrio:
function setSelectedZoomItem(selectedItem){ }
Onde selectedItem um objeto que representa o registro selecionado pelo usurio.
Para acessar o campo do registro selecionado, utilize a seguinte funo:
selectedItem.fieldName
Onde fieldName o nome do campo de retorno que foi definido na chamada de zoom.
Confira na imagem, um exemplo do recurso de zoom implementado no formulrio.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 17
2.4. Exportar Formulrio
Aps a criao do formulrio e dos eventos customizados, possvel exportar para o servidor Fluig e realizar o preenchimento e publicao do formulrio na navegao de documentos.
Ao exportar o formulrio, os eventos customizados tambm sero exportados.
Caso a exportao j tenha sido realizada, uma nova exportao deve ser feita para que os novos eventos sejam exportados.
A seguir, veja o passo a passo para exportar um formulrio para o servidor Fluig.
Passo 1
Para exportar um formulrio para o servidor Fluig, clique com o boto direito do mouse sobre o arquivo HTML do formulrio desejado e acesse a opo Exportar.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 18
Passo 2
Nesta tela, selecione a opo Exportar para o servidor Fluig e clique em Avanar.
Passo 3
A tela de exportao de formulrio exibida.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 19
Selecione o servidor desejado para realizar a exportao e selecione a opo Novo formulrio.
O campo Formulrio preenchido automaticamente ao selecionar o arquivo que deseja exportar.
Nome Dataset: No exemplo, no associamos o formulrio com um dataset, por este motivo o campo est vazio.
Pasta Destino: Informe a pasta destino da navegao de documentos em que o formulrio ser publicado. Lembre-se: Deve ser informado o cdigo da pasta de destino.
Neste exemplo, no informamos um Campo Descritor, em seguida selecione Tabelas de Banco de Dados no campo Armazenar em e clique em Avanar.
Passo 4
Neste passo, necessrio configurar o formulrio para uma verso mobile.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 20
O formulrio ser enviado ao servidor e o arquivo HTML para a verso mobile ser disponibilizado na pasta forms do projeto Fluig.
Selecione os campos desejados para a exibio nos dispositivos mobiles, neste exemplo todos os campos foram selecionados.
Aps selecionar os campos, clique em Concluir.
Passo 5
Aps exportar, acesse a pasta de destino informada na navegao de documentos do Fluig.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 21
Verifique que o formulrio foi exportado com sucesso.
Passo 6
Acesse a pasta do formulrio para publicar um registro de formulrio.
Em seguida, clique na opo Mais no menu superior, e acesse a opo Novo Registro de Formulrio. Esta funo permitir preencher os dados do formulrio publicado.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 22 Passo 7
O formulrio exportado exibido.
Informe uma Descrio para o formulrio e este ser o nome da publicao.
Lembre-se: possvel alterar os arquivos anexos do formulrio atravs da aba Anexos e tambm configurar a segurana, adicionar aprovadores ao registro de formulrio, entre outras funcionalidades.
Para mais detalhes consulte o treinamento Documentos II.
Passo 8
Clique em Confirmar e uma mensagem em tela ser exibida impedindo a publicao do registro de formulrio.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 23
O campo Solicitao no foi preenchido, e a mensagem disparada porque o formulrio est sendo validado pelo evento validateForm criado anteriormente.
Passo 9
Aps preencher os campos corretamente, clique em Confirmar para publicar o registro de formulrio.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 24 Passo 10
O registro de formulrio publicado com sucesso e para verificar os campos preenchidos, clique sobre o formulrio.
2.5. Aviso
Caso o formulrio em arquivo HTML e anexos j tenham sido criados, ou seja fornecido ao usurio, tambm possvel fazer a publicao do formulrio diretamente na web, sem precisar realizar a criao atravs do plugin Fluig Designer e depois realizar a exportao para o servidor Fluig. Caso desejar optar por esta opo siga os passos do objetivo Formulrios do treinamento Documentos I.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 25 3. Relatrio no Fluig
O BIRT - Business Intelligence and Reporting Tools, uma plataforma open source que facilita a modelagem de relatrios dentro do Fluig.
A plataforma se integra com o aplicativo Java / Java EE e os relatrios podem ser desenvolvidos atravs do Studio ou outra distribuio do Eclipse.
3.1. Verso BIRT
A verso do BIRT utilizada no Fluig a 2.6.2.
A partir da plataforma, possvel criar relatrios com:
Listagem. Agrupamento. Clculos. Cartas e Documentos. Grficos.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 26 3.2. Anatomia do BIRT
Dados: A plataforma trabalha com Web Services, Objetos Java, JDBC, XML.
Transformao: Agrupamentos e clculos.
Lgica de Negcio: Utiliza-se scripts para converso de registro, consulta parametrizada ou formatao de texto.
Apresentao: Os resultados podem ser exibidos atravs de tabelas, grficos ou textos.
3.3. Acesso a Dados
Com o BIRT possvel acessar os dados de outros produtos atravs de Javascript, JDBC, Web Service ou arquivos XML e tambm dados do banco do Fluig via Queries JPA, Dataset e JDBC.
Queries JPA
o Controle de acesso (@WDKServiceField). o Funes de agregao.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 27 Dataset
o Nmero limitado de datasets. o Controle de Acessos (@WDKServiceField). o Recomendado para dados de Formulrios.
JDBC
o Acesso total. o Funes de agregao. o No-seguro.
3.4. BIRT Engine
O BIRT tambm permite a utilizao de scripts com os quais possvel customizar o processo de gerao e renderizao do relatrio, permitindo a adequao do relatrio com as necessidades do usurio.
Para mais detalhes sobre a utilizao dos scripts de customizao em relatrios acesse a pgina Desenvolvimento de Relatrios, no endereo dev.fluig.com.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 28 3.5. Parmetros
possvel tambm incluir parmetros no relatrio a serem solicitados para o usurio antes da sua renderizao, auxiliando assim no filtro de consulta aos dados e gerando um relatrio mais especfico.
Ao abrir o relatrio, um formulrio com os parmetros definidos para o relatrio exibido.
Aps o preenchimento clique em OK e o relatrio ser gerado de acordo com os dados informados.
3.6. Fluig Tags
Na customizao dos relatrios possvel utilizar Fluig Tags.
Fluig Tags so variveis que possuem valores da instncia Fluig onde o usurio est conectado, por exemplo:
WKCompany: Cdigo da empresa autenticada no Fluig. WKUser: Cdigo do usurio autenticado no Fluig.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 29 As tags podem ser utilizadas nos cdigos dos scripts de customizao do relatrio, possibilitando assim o desenvolvimento de relatrios mais especficos.
3.7. Passo a Passo
A seguir, veja o passo a passo para configurar o BIRT a partir do Studio.
Passo 1
Para configurar o desenvolvimento do relatrio no Studio, acesse a opo Ajuda na barra superior e clique em Install New Software.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 30 Passo 2
Nesta tela, informe Indigo no campo Work with.
Aps as opes serem listadas no grid, digite BIRT no campo de busca e selecione a opo: Business Intelligence, Reporting and Charting.
Em seguida, clique em Avanar.
Passo 3
Em seguida, verifique os detalhes dos itens que sero instalados para reviso, clique em Next.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 31
Passo 4
Nesta tela selecione a opo I accept the terms of the license agreement e clique em Finish.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 32 Passo 5
Aps a edio e concluso de um relatrio, possvel exportar para o Fluig diretamente do Studio ou public-lo atravs da navegao de documentos conforme explicado no Treinamento Documentos I.
Verifique o Guia de Desenvolvimento de Relatrios disponvel em http://dev.fluig.com para mais informaes sobre relatrios no Fluig.
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil 33 4. Concluso
Assim, voc terminou o treinamento Studio III do curso Studio do Fluig.
Neste treinamento voc conheceu mais sobre:
Criao do Formulrio. Preview de Formulrio. Eventos de Formulrio. Customizao de Formulrio. Exportar Formulrio para o servidor Fluig. Relatrios no Fluig.