Manipuladores
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.
Criando um manipulador
Um manipulador de um formulário pode ser criado a qualquer momento e você deverá seguir os passos:
Autentique-se no Admin console
Acione o menu Plataforma > Workspace > Geral > Formulários
Busque pelo formulário que se deseja criar um Manipulador, e clique na linha do mesmo
Na página de detalhamento do formulário, acesse a aba Campos
Clique no ícone de Manipuladores (ver figura abaixo)
Na caixa de diálogo, clique no botão Novo
Preencher os campos Descrição e Script
Acione o botão Salvar
Editando um manipulador
Um manipulador de um formulário pode ser editado a qualquer momento e você deverá seguir os passos:
Autentique-se no Admin console
Acione o menu Plataforma > Workspace > Geral > Formulários
Busque pelo formulário que se deseja editar um Manipulador, e clique na linha do mesmo
Na página de detalhamento do formulário, acesse a aba Campos
Clique no ícone de Manipuladores (ver figura abaixo)
Selecione o manipulador que deseja editar
Editar os campos Descrição e Script
Acione o botão Salvar
Removendo um manipulador
Um manipulador de um formulário pode ser removido a qualquer momento e você deverá seguir os passos:
Autentique-se no Admin console
Acione o menu Plataforma > Workspace > Geral > Formulários
Busque pelo formulário que se deseja remover um Manipulador, e clique na linha do mesmo
Na página de detalhamento do formulário, acesse a aba Campos
Clique no ícone de Manipuladores (ver figura abaixo)
Selecione os manipuladores que serão removidas
Acione o botão Remover
Serviços disponíveis para um manipulador
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:
accountService
Permite operações de busca sobre as contas do diretório do Blazon.
userService
Permite operações de busca sobre os usuários do diretório do Blazon.
organizationService
Permite operações de busca sobre as organizações
do diretório do Blazon.
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:
Boolean existAccount(Map<String, Object> params);
À partir de um conjunto de parâmetros, verifica a existência de uma conta no diretório do Blazon.
Serviço de usuários (userService)
As operações do serviço "userService", são:
List<Map<String, String>> findUsers(Map<String, Object> params);
À partir de um conjunto de parâmetros retorna uma lista de usuários do diretório do Blazon.
Boolean existUser(Map<String, Object> params);
À partir de um conjunto de parâmetros, verifica a existência de um usuário no diretório do Blazon.
Serviços de organizações (organizationService)
As operações do serviço "organizationService", são:
Boolean existUserInOrganization(String username, String organizationName, String type);
Com base no nome de usuário, nome da organização e tipo da organização, verifica se um usuário faz parte de uma organização.
List<Map<String, String>> findOrganizations(Map<String, Object> params);
À partir de um conjunto de parâmetros retorna uma lista de organizações do diretório do Blazon.
List<Map<String, String>> findOwners(String organizationName, String type);
Com base no nome da organização e no tipo da organização, retorna a lista de donos/gerentes da organizaçã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
}Atualizado
Isto foi útil?