Você está na página 1de 33

fluig.com | 0800 882 9191 | Av.

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:

AfterSaveNew.
DisplayFields.
EnableFields.
InputFields.
SetEnable.
ValidadeForm.
AfterProcessing.
BeforeProcessing.


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.