Para criar um campo de um formulário, você deverá acessar a aba Campos, na página do Formulário. Os seguintes passos devem ser seguidos:

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 Campo, e clique na linha do mesmo

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

5. Acione o botão Novo para adicionar um campo ao formulário

6. Na caixa de diálogo, especifique o Nome, Label, o Campo para bind e o Tipo do campo que será criado no formulário

7. Acione o botão Salvar

A ordem que os campos de um Formulário é apresentada na tela, quando o Formulário é renderizado, é a mesma ordem que os campos são apresentados durante a criação.

No entanto você poderá re-ordenar os Campos de um Formulário de forma simples, na tela de listagem dos campos, apenas seguindo 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 campo, e clique na linha do mesmo

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

5. Na linha do Campo que se deseja reposicionar, clique no símbolo () e arraste o campo até onde deseja e solte

Pronto, você acaba de reposicionar um campo num Formulário.

O campo de um formulário é o elemento chave na definição do formulário em si. Um campo representa a unidade de informação que será trabalhada na renderização de um formulário na tela.

As operações de criação, edição e remoção de campos são disponibilizadas na interface do Console Administrativo e serão tratadas nas páginas subsequentes.

Um campo 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 Campo, e clique na linha do mesmo

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

5. Clique no Campo que se deseja editar

6. Na caixa de diálogo, na aba Detalhes, edite as configurações do Campo conforme a necessidade

7. Acione o botão Salvar

Editando configurações específicas de cada tipo de campo

Na caixa de diálogo, na aba Detalhes, ainda é possível configurar informações específicas de cada tipo de Campo.

Para isso, acione o botão de configurações (), ao lado direito da configuração de Tipo do campo. Após configurar, acione o botão Salvar.

Configurando validações do campo

Cada campo do formulário pode ter associado a ele um script de validação. Esse script de validação, será executado no momento de se validar os dados do formulário, quando de sua renderização em tela.

Pra configurar esse script, basta você acessar a aba Validações, na caixa de diálogo de detalhamento do Campo e digitar o script em Bean Shell.

A funcionalidade do Formulário conta com vários tipos de Campos, como tipo String, Data, Número, etc, e cada tipo de Campo conta com um conjunto padrão de propriedades.

As propriedades padrão de todos os tipos de campos são as disponíveis na tela de edição de um campo e podem ser vistas na figura a seguir:

Conforme a figura acima, as propriedades padrão são:

Além das propriedades padrão de todo tipo de Campo do Formulário, cada tipo ainda pode ter propriedades específicas.

Configurando propriedades específicas de cada tipo de campo

Vamos ver, pra cada tipo, as propriedades específicas que você pode configurar:

Campo do tipo String:

Campo do tipo Número:

Campo do tipo CheckBox:

Campo do tipo TextArea:

• Não tem propriedade específica.

Campo do tipo Data:

Campo do tipo Lista:

Campo do tipo Organização:

Campo do tipo Usuário:

Campo do tipo Nome de usuário:

Campo do tipo Categoria:

Campo do tipo Classificação:

Campo do tipo Ambiente:

Campo do tipo Recurso:

Você pode definir um manipulador para um campo de um formulário.

Esse manipulador é definida como scripts em BeanShell e será executada imediatamente antes que o valor de um campo renderizado for editado.

O script de manipulação de um campo pode acessar os dados do próprio campo apenas. No script o valor do campo será acessado como um variável com o nome do campo ou com o nome padrão "value".

Abaixo um exemplo de um script de manipulação, que formata o valor, de um campo do tipo String com o nome "cpf":

try {		
  String pattern = "###.###.###-##";
  javax.swing.text.MaskFormatter mask = new javax.swing.text.MaskFormatter(pattern);
  mask.setValueContainsLiteralCharacters(false);
  cpf = mask.valueToString(cpf);
} catch (Exception e) {
  //nothing here
}

Usando propriedades específicas de alguns campos

Alguns campos do formulário possuem propriedades específicas e elas podem ser acessadas no script de manipulação. Esses campos são:

Cada um desses campos apresenta propriedades específicas, são elas:

Propriedades do campo Organization

Propriedades do campo User

Propriedades do campo List

Propriedades do campo Username

Exemplo de um script de manipulação usando propriedade específica

Como definido acima, o campo do tipo "Organization" contem 3 propriedades específicas: name, type e identifier.

Abaixo um exemplo de como um script de manipulação pode usar uma dessas propriedades:

if (organization.type != null && organization.name != null) {
 	return organization.name.toLowerCase() + "_" + organization.type.toLowerCase(); 
}

Serviços disponíveis para um script de manipulação de campo

Os scripts de manipulação de campo possuem à disposição 3 serviços que permitem acesso às informações do diretório do Blazon para efetivação de algumas manipulações.

Você poderá remover Campos de um Formulário de forma simples e apenas seguindo 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 campo, e clique na linha do mesmo

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

5. Selecione o(s) campo(s) que será(ão) removido(s)

6. Acione o botão Remover

7. Na caixa de diálogo, acione o botão Confirmar

Você pode definir uma validação para um campo de um formulário.

Essa validação é definida como scripts em BeanShell e será executada sempre que o valor de um campo renderizado for editado.

O script de validação de um campo pode acessar os dados do próprio campo apenas. No script o valor do campo será acessado como um variável com o nome do campo ou com o nome padrão "value".

Abaixo um exemplo de um script de validação de um campo do tipo String com o nome "cpf":

if (value == null) {
  	return "Valor do campo cpf não pode ser nulo.";
}
if (cpf.length() < 11) {
	return "Campo cpf com formato incorreto.";
}
return true;

Usando propriedades específicas de alguns campos

Alguns campos do formulário possuem propriedades específicas e elas podem ser acessadas no script. Esses campos são:

Cada um desses campos apresenta propriedades específicas, são elas:

Propriedades do campo Organization

Propriedades do campo User

Propriedades do campo List

Propriedades do campo Username

Exemplo de um script de validação usando propriedade específica

Como definido acima, o campo do tipo "Organization" contem 3 propriedades específicas: name, type e identifier.

Abaixo um exemplo de como um script de validação pode usar uma dessas propriedades:

if (organization.name == null || organization.name.isEmpty()) {
	return "Campo organization não pode ser nulo.";
}
return true;

Serviços disponíveis para um script de validação de campo

Os scripts de validação de campo possuem à disposição 3 serviços que permitem acesso às informações do diretório do Blazon para efetivação de algumas validações do tipo:

"Existe um usuário com o mesmo cpf definido no campo CPF?"

Um Campo de um Formulário pode ser de um dos 13 tipos disponíveis, que são: