Escolar Documentos
Profissional Documentos
Cultura Documentos
PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
DCTE Documentao
Tcnica
SE Formulrio - Editor
de frmulas
Produto
Verso
1.3
Pgina: 1/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
CONTEDO
Contedo ..............................................................................................................................................2
Introduo ............................................................................................................................................3
Frmulas ..............................................................................................................................................3
Exemplos de regras no SE Formulrio.......................................................................................................7
Locais de utilizao de frmulas no SE Processo ...................................................................................... 17
SE Formulrio: Frmulas de Data/hora ................................................................................................... 20
SE Processo: Envio de e-mail com campos do formulrio ......................................................................... 32
Pgina: 2/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
INTRODUO
O Objetivo deste documento mostrar de forma prtica o uso das frmulas nos componentes que compem a soluo
SE BPM. As frmulas so compostas por condies (se/seno), funes e variveis. So utilizadas para criar uma regra em
determinado ponto do sistema, possibilitando ao cliente/usurio atender necessidades especficas. O sistema de frmulas
(regras) possui atalhos na barra de ferramentas para facilitar o uso.
FRMULAS
1.1 Frmulas no SE Formulrio
Um formulrio composto por campos, cada campo relacionado a um atributo da entidade. As entidades so tabelas
na base de dados e os atributos so colunas da tabela. Um exemplo de frmula verifica o valor de um campo e realiza aes
sobre outros campos. As aes so: Habilitar, desabilitar, marcar como requerido, no requerido, exibir, ocultar, limpar, carregar
e aplicar valor em um campo.
1.1.1.
As regras/frmulas so executadas nos eventos do formulrio. Um evento um controle do sistema que monitora o
uso e dispara execuo das regras. Um exemplo desse mecanismo o evento de carregar o formulrio. Aps completar o
carregamento executada a formula que foi associada a esse evento, como mostra a figura 01. Outro exemplo comum, ao
clicar em um item de checkbox executa-se a frmula associada ao clique desse item (figura 02). A maioria dos itens possui
somente um evento (clique/alterao).
Pgina: 3/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Campo
Eventos
Checkbox
Clique
Combobox
Alterao
Fieldset
No possui evento
Imagem
No possui evento
Entrada
Input
Sada
Ttulo
No possui evento
Radio button
Clique
Entrada
SpinInput
Zoom
Sada
Alterao
Sada
Entrada
Hora
Alterao
Entrada
Data
Descrio
Sada
Grid
Alterao
Texto
No possui evento
Pgina: 4/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.1.2.
O Editor de frmulas composto por uma barra de ferramentas que possui biblioteca de funes, por uma rea de
descrio da regra e por uma rea que mostra a regra em diferentes cores para melhor identificao e links para abrir tela de
configurao dos parmetros. A figura 3 mostra um exemplo de utilizao simples.
Pgina: 5/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.1.3.
A tabela 02 apresenta as funes do SE Formulrio. Nas seces seguintes so mostrados exemplos explicando o
funcionamento de cada uma.
Nome da funo
Descrio
AO
AO NO GRUPO
AO NO ITEM GRAFICO
USURIO LOGADO
VALOR DO CAMPO COM FILTRO
FILTRO DE ENTIDADE
TOTAL DA GRID
REA DO INICIADOR
ATIVIDADE
INICIADOR
Utilizado somente em
Pgina: 6/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Em um formulrio comum existir regras que desabilitam campos de acordo com alguma opo selecionada. Um
exemplo simples um conjunto de radiobuttons para identificar o estado civil (Solteiro/Casado). Ao selecionar a opo casado
deve-se habilitar o campo cnjuge (figura 04). Para melhor entendimento pode-se escrever a frmula (regra) em uma forma
simples e em seguida na forma que o editor de frmulas precisa.
O quando determinado pelo evento de clique no radio button Casado. A ao de habilitar determinada pela funo de
ACAO. Pode-se usar a tela de configurao dos parmetros como mostra a figura 05.
Pgina: 7/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.2.2.
Variveis so utilizadas para guardar valores e utilizadas em diversos lugares da frmula. Um exemplo comum
buscar o valor de um campo e comparar diversas vezes na frmula para habilitar/desabilitar campos de acordo com um valor.
Para criar uma varivel basta escrever uma letra ou palavra seguida do caractere = (igual) e o valor. O valor pode ser
um nmero (resultado de um calcull), um texto (nesse caso entre aspas simples) e tambm pode ser um valor de um campo do
formulrio (figura 06).
Pgina: 8/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.2.3. Como utilizar condies (se/seno) para habilitar campos de acordo com valor de
outro campo
Condies servem para casos que deseja-se verificar um valor de um campo, e dependendo do valor habilitar alguns
campos e desabilitar/esconder outros. Para habilitar/desabilitar campos deve-se sempre usar a funo ACAO (figura 05). A
figura 07 mostra um exemplo que busca o valor de um campo chamado Emissor e armazena em uma varivel para utilizar nas
condies.
Pgina: 9/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 10/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 11/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.2.10.
Para habilitar campos de acordo com a atividade deve-se primeiramente buscar o identificador ou nome da atividade
para utilizar nas condies. Para isso utiliza-se a funo ATIVIDADE que busca a atividade corrente que o formulrio
visualizado. Aps isso deve-se criar as condies (Se/Seno) e utilizar a funo ACAO para habilitar/desabilitar campos. A
figura 14 mostra um exemplo.
Pgina: 12/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.2.11.
Esse exemplo utilizado em casos que o usurio digita a matricula ou cdigo e o sistema busca nas demais entidades
o nome, idade, estado civil, etc na entidade Colaborador. Para realizar essa tarefa deve-se seguir o seguinte procedimento
(figura 15):
Na frmula primeiramente deve-se buscar o valor do campo matricula e armazenar em uma varivel. Utiliza-se a
funo VALORCAMPO
Criar um filtro com o valor da matrcula na entidade Colaborador que possui os dados de Nome, Idade, etc. Utiliza-se
a funo FILTROENTIDADE.
Buscar o nome e idade na entidade Colaborador utilizando o filtro criado acima e armazena em variveis. Utiliza-se a
funo VALORCAMPOFILTRO.
1.2.12.
No necessrio que a coluna esteja sendo mostrada na grid, pois considera-se uma coluna da entidade. Para
calcular deve-se utilizar a funo TOTALGRID. Nessa funo informa-se o relacionamento, a entidade da grid (mesmos dados
informados nas propriedades da grid), o campo que deseja-se calcular e a operao (Soma, Mdia, Mximo, Mnimo,
Contador). Aps calcular pode-se preencher o resultado em um campo do formulrio via funo ACAO. A figura 16 mostra o
exemplo.
Pgina: 13/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.2.13.
Para aplicar aes em todos os itens posicionados dentro de um fieldset pode-se utilizar a funo ACAOGRUPO.
Deve-se informar o identificador do fieldset e as aes a serem realizadas. Utilizada em casos que deseja-se esconder ou
desabilitar varias seces do formulrio. Para aplicar a mais de um fieldset basta repetir a linha alterando o identificador para
cada fieldset. A figura 17 mostra um exemplo.
Figura 17 Exemplo de Habilitar e marcar requerido em todos os campos do fieldset Setor responsvel pela tratativa
Pgina: 14/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.2.15.
Para preencher valor no ttulo utiliza-se a mesma funo descrita na seco 3.1.14. Precisa-se somente informar no
ultimo parmetro a varivel com o valor a ser preenchido. A figura 19 mostra um exemplo.
1.2.16.
Para calcular a idade necessrio utilizar algumas funes do boto de Data na barra de ferramentas. A imagem 20
mostra o exemplo.
Pgina: 15/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
1.2.17.
possvel calcular a quantas horas entre dois campos do tipo hora. No exemplo da figura 21 mostra um exemplo
entre um campo hora e a hora atual.
1.2.18.
Como utilizar as funes ACAO, ACAOGRUPO e ACAOITEMGRAFICO na mesma
frmula
possvel utilizar as funes de ACAO, ACAOGRUPO e ACAOITEMGRAFICO combinadas. Existem casos que
deseja-se manter somente um item habilitado dentro de um fieldset e os demais desabilitados. Para atender a esse caso podese desabilitar todos os itens do fieldset com a funo ACAOGRUPO (seco 3.1.13) e em seguida habilitar o campo desejado
com a funo ACAO. A sequncia das aes so respeitadas. A figura 22 mostra um exemplo.
Pgina: 16/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Figura 23 Tela de dados da atividade para configurao da durao dinmica via frmula
Pgina: 17/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 18/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Para definir uma rota do processo com frmulas deve-se utilizar os gateways XOR ou COMPLEXO. No fluxo de sada
do gateway, na tela de dados, deve-se criar a frmula. Para que o processo siga pela rota desse fluxo deve-se retornar
VERDADEIRO na frmula. A figura 25 mostra um exemplo com gateway XOR. Pode-se utilizar condies (Se/Seno) de acordo
com campos do formulrio para determinar se deve ou no prosseguir por um determinado caminho.
Pgina: 19/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 20/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 21/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 22/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 23/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 24/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 25/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Figura 32 Calendrio
Pgina: 26/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Criar uma varivel (objeto) com a data e hora de requisio. Funo: DATETIME
Pgina: 27/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 28/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Figura 36 Formulrio para calculo do prazo considerando calendrio e durao do SLA do cliente
Pgina: 29/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Quando est em dia mostra a imagem verde com seta para cima. Quando est em atraso mostra vermelha com
seta para baixo.
A frmula foi criada no evento de carregar do formulrio para que ao carregar mostre se est em dia ou em
atraso. Para calcular pode-se seguir os seguintes passos:
Verificar se a data/hora atual maior que a data e hora do prazo (deadline). Caso sim Esconde a
imagem de em dia e mostra a imagem de em atraso. Funo AFTER_DATETIME
Mostrar nos campos do formulrio a data e hora atual, somente para ilustrao.
Pgina: 30/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 31/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
A figura 40 mostra um exemplo de processo com evento de mensagem. A figura 41 mostra um exemplo de um e-mail envidado.
A figura 42 mostra o arquivo modelo (template) com as tags em html. A figura 43 mostra o cdigo fonte utilizado no arquivo
modelo (template).
Pgina: 32/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 33/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 34/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 35/36
DCTE.PT00024
SE Formulrio - Editor de frmulas
Reviso: 00
Homologado: 29/10/2012
Pgina: 36/36