TOTVS Fluig

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 30

changes.mady.by.user Thiago Venturelli

Gravado em

comparado com

Nova versão 31

changes.mady.by.user Thiago Venturelli

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Antes de iniciar, é importante que leia a documentação sobre Desenvolvimento de Formulários e, durante a leitura você vai sentir a necessidade de entender um pouco mais sobre o parâmetro form (FormController)


Como criar eventos de formulário

...

Após a criação de uma definição de formulário é possível realizar a criação de scripts para customização. O eventos para formulários são criados conforme passos a seguir:

Deck of Cards
effectDuration0.5
historyfalse
idsamples
effectTypefade
Card
defaulttrue
id1
labelPasso1


  • Para a criação de um script de formulário no fluig, na visão Explorador de pacotes (Package Explorer) deve-se acessar a pasta forms do projeto fluig, clicar com o botão direito e no menu acessar Novo (New) > Outras (Other).

    Image Added

Figura 5 - Criação de script evento da definição de formulário.


Card
id2
labelPasso 2


  • Abra a pasta Fluig e selecione a opção Script Fluig e clique no botão Avançar (Next > ).Image Added

Figura 6 - Criação de script evento da definição de formulário.


Card
id3
labelPasso 3


  • Selecione o tipo e clique em Avançar (Next >).

Image Added


Card
id4
labelPasso 4


  • Nesta tela é necessário informar os campos pertinentes ao evento que se deseja adicionar e clicar no botão Concluir.

Após a criação de uma definição de formulário é possível realizar a criação de scripts para customização. O eventos para formulários são criados conforme passos a seguir:



Para a criação de um script de formulário no fluig, na visão Explorador de pacotes (Package Explorer) deve-se acessar a pasta forms do projeto fluig, clicar com o botão direito e no menu acessar Novo (New) > Outras (Other).



Figura 5 - Criação de script evento da definição de formulário.




Abra a pasta Fluig e selecione a opção Script Fluig e clique no botão Avançar (Next > ).

Figura 6 - Criação de script evento da definição de formulário.




Selecione o tipo e clique em Avançar (Next >).




Image Added

Figura 7 - Criação de script evento da definição de formulário.


Card
id5
labelPasso 5


  • No exemplo selecionamos o evento validateForm, e o relacionamos a definição de formulário form_exemplo_fluig.

Image Added

Figura 8 - Criação de script evento da definição de formulário.


Card
id6
labelPasso 6


  • Ao concluir a estrutura principal do método estará disponível no editor.

Image Added

Figura 9 - Criação de script evento da definição de formulário.


Card
id7
labelPasso 7


  • Configure seu script. Para entender mais sobre os eventos e algumas dicas continue lendo essa documentação

Image Added

Figura 10 - Criação de script evento da definição de formulário.


LOGs

...

Uma das funções mais importantes para entender o que está acontecendo no código e rastreamento futuro é o log. Tanto em eventos de formulário, eventos de processo, datasets, o fluig permite fazer log em quatro níveis:

log.info

Usado para apresentar alguma mensagem de rastreamento do código ou dos campos

Bloco de código
languagejs
log.info(“Testando o log info”);
Bloco de código
languagejs
log.info(“O campo código contém o valor: ” + form.getValue("codigo"));


log.warn

Usado para indicar algum ponto de atenção ou problema eminente no código

Bloco de código
languagejs
if (form.getValue("codigo") == "") {
   log.warn(“O campo código está em branco e pode apresentar problemas com as integrações”);
}


log.debug

Os logs, se não usados com moderação, podem mais atrapalhar do que ajudar. Por isso, caso necessário, algumas informações podem ser utilizadas como debug, que são ativas somente quando o usuário realmente ver elas

Bloco de código
languagejs
log.debug("verificando o conteúdo do campo código")
if (form.getValue("codigo") == "") {
   log.debug("o campo código está em branco");
} else {
   log.debug("o campo código está preenchido: " + form.getValue("codigo"));
}


log.error

Usado para imprimir um log de erro

Bloco de código
languagejs
if (form.getValue("codigo") == "") {
   log.error("O campo código não foi preenchido");
   throw "Preencha o campo código";
}


log.dir

Este log não é um tipo diferente, na verdade é um log.info turbinado. Serve para fazer o log de objetos mais complexos que simples strings

Bloco de código
languagejs
var objeto = {'codigo': form.getValue("codigo"), 'nome': form.getValue("nome")};
log.dir(objeto);

Eventos

...

Os eventos de formulários são um conjunto de scripts carregados pela API de Formulários, os quais são desenvolvidos utilizando Javascript e são chamados durante a execução de ação em formulários ou em momentos específicos de interação em formulários.

...

  • Para ocultar o os botões Imprimir e Imprimir em nova Janela, deve-se utilizar o método setHidePrintLink.


Sem customizaçõesCom customização

Image Modified

Image Modified

Bloco de código
languagejs
function displayFields(form, customHTML) {
   form.setShowDisabledFields(true);
   form.setHidePrintLink(true);
}

comdelete.pngImage Modified

Image Modified


Bloco de código
languagejs
function displayFields(form, customHTML) {
   form.setHideDeleteButton(false);
}


Formulário funcional com exemplos de utilização de setVisible, setVisibleById, setHideDeleteButton e setHidePrintLink:

...