Você pode definir manipuladores para um formulário. A ideia é permitir alguns tratamento de dados como aplicação de máscaras, modificação para maiúsculas ou minúsculas, remoção de caracteres indesejados, etc.

Esses manipuladores são definidos como scripts em BeanShell e serão executados imediatamente antes que os dados de um formulário renderizado sejam salvos.

Nas seções subsequentes você verá como criar, editar e remover manipuladores de um formulário.

Um manipulador de um formulário pode ser criado a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Geral > Formulários

3. Busque pelo formulário que se deseja criar um Manipulador, e clique na linha do mesmo

4. Na página de detalhamento do formulário, acesse a aba Campos

5. Clique no ícone de Manipuladores (ver figura abaixo)

6. Na caixa de diálogo, clique no botão Novo

7. Preencher os campos Descrição e Script

8. Acione o botão Salvar

Os manipuladores de um formulário, são definidos de fato, com base em scripts BeanShell.

Esses scripts serão executados pelo Blazon imediatamente antes de salvar os dados de um formulário que foi previamente renderizado.

Assim você pode implementar manipuladores sobre os dados do formulário. Juntamente com essa funcionalidade o Blazon disponibiliza 3 serviços injetados no sistema de execução dos scripts que permitem algumas operações sobre os dados do diretório do Blazon.

Os serviços são:

Cada um dos serviços acima citados disponibilizam uma interface com algumas operações.

Serviço de contas (accountService)

As operações do serviço "accountService", são:

Serviço de usuários (userService)

As operações do serviço "userService", são:

Serviços de organizações (organizationService)

As operações do serviço "organizationService", são:

Exemplo de um script de manipulação

Abaixo tem-se um exemplo de um script de manipulação usando algumas operações dos serviços disponibilizados:

params = new java.util.HashMap();
params.put("cpf",cpf);
existUser = userService.existUser(params);
try {
			
  String pattern = "###.###.###-##";
  javax.swing.text.MaskFormatter mask = new javax.swing.text.MaskFormatter(pattern);
  mask.setValueContainsLiteralCharacters(false);
  cpfFormatado = mask.valueToString(cpf);
  return cpfFormatado;

} catch (Exception e) {
  //nothing here
}

Um manipulador de um formulário pode ser editado a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Geral > Formulários

3. Busque pelo formulário que se deseja editar um Manipulador, e clique na linha do mesmo

4. Na página de detalhamento do formulário, acesse a aba Campos

5. Clique no ícone de Manipuladores (ver figura abaixo)

6. Selecione o manipulador que deseja editar

7. Editar os campos Descrição e Script

8. Acione o botão Salvar

Um manipulador de um formulário pode ser removido a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Geral > Formulários

3. Busque pelo formulário que se deseja remover um Manipulador, e clique na linha do mesmo

4. Na página de detalhamento do formulário, acesse a aba Campos

5. Clique no ícone de Manipuladores (ver figura abaixo)

6. Selecione os manipuladores que serão removidas

7. Acione o botão Remover