Os Formulários representam uma importante funcionalidade de configuração de uma lista de campos para serem disponibilizados/renderizados na tela, como por exemplo, pra preenchimento de um cadastro, etc.

Basicamente um Formulário é composto por uma lista de Campos, agrupados em Seções e ainda é possível configurar uma lista de Validações.

As páginas subsequentes apresentam as configurações para cada um desses elementos de um Formulário.

Criando um formulário

Para criar um novo Formulário, você deve seguir os seguintes passos:

1. Autentique-se no Admin console

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

3. Acione o botão Novo

4. Especifique o Nome e a Descrição do novo formulário

5. Acione o botão Salvar

Editando um formulário

Após a criação de um formulário, que consiste basicamente em dar-lhe um nome e uma descrição, passa-se à fase de configuração/edição do mesmo. Para isso você pode seguir os passos:

1. Autentique-se no Admin console

2. Plataforma > Workspace > Geral > Formulários

3. Busque pelo formulário a ser editado/configurado, e clique na linha do mesmo

4. Na página do formulário, acesse a aba Geral, edite o Nome e a Descrição

5. Acione o botão Salvar, na aba Geral

6. Na página do formulário, acesse a aba Campos, aqui você poderá:

   • criar novos campos do formulário

   • editar campos do formulário

   • remover campos do formulário

Removendo um formulário

Você poderá remover um formulário sempre que necessitar e para isso deve seguir os passos:

1. Autentique-se no Admin console

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

3. Selecione o(s) formulário(s) que será(ão) removido(s)

4. Acione o botão Remover

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

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 Admin console e serão tratadas nas páginas subsequentes.

Tipos de itens

Para cada um dos tipos de itens do Catálogo, um acesso em específico é concedido.

Recurso

Um item do Catálogo, do tipo Recurso, representa uma solicitação de acesso a um recurso, ou seja, uma solicitação de uma conta num recurso.

Cada recurso do diretório do Blazon, e que está habilitado pra self-service, terá seu item respectivo pra configurações adicionais.

Dentre as configurações adicionais possíveis, está a possibilidade de se associar ao item, um Formulário, o qual será renderizado no momento da solicitação do recurso pra viabilizar configurações necessárias de alguns tipos de contas.

Direito

Um item do Catálogo, do tipo Direito, representa uma solicitação de acesso a um direito, ou seja, uma solicitação de um direito pra uma conta de um recurso.

Cada direito do diretório do Blazon, e que está habilitado pra self-service, terá seu item respectivo pra configurações adicionais.

Caso seja necessário, é também possível associar um Formulário a um item do tipo Papel.

Papel

Um item do Catálogo, do tipo Papel, representa uma solicitação de acesso a um papel.

Cada papel do diretório do Blazon, e que está habilitado pra self-service, terá seu item respectivo pra configurações adicionais.

Caso seja necessário, é também possível associar um Formulário a um item do tipo Direito.

Check-in de conta administrativa

Um item do Catálogo, do tipo check-in de conta administrativa, representa uma solicitação de acesso às credenciais da respectiva conta administrativa.

Cada conta de um recurso administrativo do diretório do Blazon, e que está habilitado pra self-service, terá seu item respectivo pra configurações adicionais.

Caso seja necessário, é também possível associar um Formulário a um item do tipo Check-in de conta administrativa.

Usuário

Todos os itens, dos tipos citados acima, são gerados automaticamente por processos internos do Blazon, verificando o diretório, com exceção do item do tipo Usuário.

Um item do tipo Usuário, representa uma pessoa a ser registrada/cadastrada no Blazon, via Workspace.

Além de configurar, você pode adicionar um item do tipo Usuário, diretamente no Admin console.

Adicionando um item de Usuário

A adição de um item de Usuário é constituída de dois passos, o primeiro deles é a criação de um formulário. Este formulário é responsável por obter as informações do novo usuário cadastrado e posteriormente enviar estas informações para que de fato o mesmo seja criado. Após a criação do formulário, devemos criar um item de catálogo do tipo Usuário e atrelar o formulário configurado.

Configurando um formulário

1. Autentique-se no Admin console

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

3. Acione o botão Novo

4. Especifique o Nome, a Descrição

5. Acione o botão Salvar

Após a adição do formulário, ele irá aparecer na listagem de formulários, basta acessá-lo e clicar sob a aba "Campos". Nesta aba você deve adicionar os campos necessários para a criação de um novo usuário, conforme descrito a seguir.

Para a definição de um formulário para o cadastro de um novo usuário, devemos sempre nos atentar a criar uma configuração que seja realmente válida. Para isto, devemos:

• Lembrar que todos os campos obrigatórios do usuário devem ser adicionados no seu formulário;

• Para cada campo do formulário, o mesmo deve possuir uma ligação ao campo do schema do usuário.

A tabela abaixo demonstra uma configuração básica para o seu formulário:

O campo "Nome" é uma identificação única para o campo do seu formulário, ele pode ser utilizado posteriormente em um script de validação ou manipulação do seu formulário. O campo "Label" é o nome que irá aparecer para o seu usuário durante a criação do usuário. Já o campo "Campo de vinculação" é utilizado para vincular os dados do formulário ao campo de fato do usuário, ou seja, é assim que o Blazon sabe em qual atributo do usuário a informação do formulário deve ser persistida.

Para adicionar campos que não foram citados no exemplo acima lembre-se apenas que o mesmo deve ter uma configuração válida entre o formulário e o schema do Usuário e isto deve ser feito. partir do campo "Campo de vinculação".

Adicionando um item do tipo Usuário

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Catálogo de itens > Usuários

3. Acione o botão Novo

4. Especifique o Nome, a Descrição e Formulário

5. Acione o botão Salvar

Pronto, você acaba de adicionar um item do tipo Usuário, no Catálogo.

Editando um item

Você pode, a qualquer momento, editar qualquer item do Catálogo de itens. Para editar um item do Catálogo:

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Catálogo de itens

3. Realize a busca pelo nome ou tipo do item que deseja-se alterar

4. Selecione o item que deseja-se alterar no resultado de busca

5. Realize as alterações desejadas

6. Acione o botão Salvar

Pronto, você acaba de editar um item do Catálogo! A edição de um item do Catálogo vai naturalmente refletir na sua apresentação e funcionalidade lá no Workspace.

Por exemplo, a edição de um item, configurando um Formulário irá afetar o processo de checkout que irá renderizar um formulário pra ser preenchido pelo usuário do Workspace.

Removendo um item

Para remover um item do Catálogo:

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Catálogo de itens

3. Realize a busca pelo nome ou tipo do item que deseja-se remover

4. Selecione o check-box do item que deseja-se remover

5. Acione o botão Remover

6. Acione o botão Confirmar

Pronto, você acaba de remover um item do Catálogo!

Você poderá remover Campos de um Formulário de forma simples e apenas seguindo os passos:

1. Autentique-se no Admin console

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

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

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 Admin console

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

Quando um formulário é aplicado, ou melhor renderizado na tela, os campos apresentados podem ser agrupados em seções.

Embora sempre vá existir uma seção Padrão, você pode criar ou remover seções e organizar os campos de acordo com as seções existentes.

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.

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?"

Esses serviços são os mesmos serviços disponíveis para os scripts de validação do formulário e estão documentados na página:

Identidade visual

O Blazon permite que a Identidade visual do Workspace seja configurada através dessa funcionalidade. Para isso:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Geral > Identidade visual

3. Acione a área destinada para realizar o envio da Logo desejada

4. Selecione a imagem que deseja adicionar como Logo no workspace

5. Acione o botão Salvar da seção correspondente

6. Selecione o check-box do Tema do workspace que preferir

7. Acione o botão Salvar da seção correspondente

8. Acione a área destinada para realizar o envio de uma Imagem de Fundo da tela de Login do workspace

9. Acione o botão Salvar da seção correspondente

Tarefas

O gerenciamento das Tarefas é composto por configurações que são utilizadas na resolução de tarefas do workspace, tanto no nível funcional da ferramenta quanto no nível de informações disponíveis sobre o usuário durante a resolução de uma tarefa.

Para realizar essa configuração:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Geral > Tarefas

3. Selecione opcionalmente as caixas de seleção desejadas para determinar o comportamento do usuário durante a resolução de tarefas

4. Acione o botão Salvar da seção Informações gerais

5. Selecione um Atributo do usuário disponível na caixa de listagem

6. Acione o botão correspondente à adição para incluir o atributo selecionado à lista

7. Acione o botão Salvar da seção Campos visualizáveis do usuário na tarefa

Times

É possível definir através da página de Times quais dos campos que compõem o perfil do usuário serão exibidos na página de membros do time dentro do workspace. Para edição dessa lista:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Geral > Times

3. Selecione um Atributo do usuário disponível na caixa de seleção

5. Acione o botão Salvar

Requisições

É possível definir através da tela de Requisições quais os campos que compõem o perfil do usuário serão exibidos numa página de requisição dentro do workspace. Para edição dessa lista:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Geral > Requisições

3. Selecione um Atributo do usuário disponível na caixa de seleção

5. Acione o botão Salvar

Perfil do usuário

Através dessa funcionalidade, é possível definir via Console Administrativo quais os campos do próprio Perfil o usuário será capaz de alterar dentro do workspace. Para realizar essa configuração:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Geral > Perfil do usuário

3. Selecione um Atributo do usuário disponível na caixa de seleção

5. Acione o botão Salvar

Documentação

Através da funcionalidade de Documentação, é possível configurar uma URL externa ao Console Administrativo e ao Workspace contendo uma documentação diferente das documentações disponibilizadas para o Blazon. Para essa configuração:

1. Autentique-se no Console Administrativo

2. Acione o menu Plataforma > Workspace > Documentações

3. Especifique a URL da documentação

4. Especifique o Label da documentação

5. Acione o botão Salvar

O Workspace possui uma série de funcionalidades que podem ser configuradas de acordo com uma necessidade específica. O Admin console permite que as configurações necessárias ao Workspace sejam feitas de maneira facilitada.

O Workspace contém um conjunto de componentes responsáveis por disponibilizar ao usuário maneiras de solicitar novos acessos, resolver tarefas de aprovação, certificação e acessar credenciais por meio do cofre de senha.

Boa parte destes componentes permitem configurações que alteram seu comportamento de alguma maneira. Por exemplo o Catálogo, que permite a adição de formulários para o cadastro personalizado de usuários.

Os próximos tópicos abordam as possíveis configurações ao Workspace.

Uma seção de um formulário pode ser criada a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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

3. Busque pelo formulário que se deseja criar uma Seção, e clique na linha do mesmo

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

5. Clique no ícone de Seções (ver figura abaixo)

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

7. Preencher os campos Nome e Ajuda

8. 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 Admin console

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.

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

1. Autentique-se no Admin console

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 concessão de novos acessos no Blazon é feita via self-service. Sempre que um novo acesso é necessário, o mesmo pode ser solicitado por meio do Workspace a partir de uma interface de autoserviço.

O Workspace possui um catálogo de itens que podem ser solicitados por um usuário e esta solicitação é submetida a um processo de avaliação, no qual um conjunto de aprovações e validações pode ser necessário.

Um item do catalogo basicamente é um objeto que contém nome, descrição e tipo. Para cada um dos tipos, o Blazon concede um tipo de acesso específico. O catálogo é formado pelo seguintes itens:

O próximo tópico apresenta de forma mais detalhada cada um dos tipos de item.

O Catálogo permite a criação de buscas customizáveis que facilite a busca por novos acessos. Estas buscas permitem a adição de termos voltados ao negócio e permite o filtro já pré-configurado de itens do Catálogo, o que aumenta a capacidade do usuário encontrar o acesso desejado.

Em ambientes organizacionais onde há um número muito grande de recursos e direitos, muitas vezes se torna um desafio encontrar o acesso desejado. As buscas customizáveis do catálogo são uma maneira de melhorar a experiência de uso do usuário.

A busca nos permite o filtro avançado de todos os tipos de itens presentes no catálogo e você pode dar um destaque maior aos acessos muito solicitados, o que facilita o encontro do acesso necessário pelo usuário.

Para a configuração de buscas, devemos basicamente adicionar uma busca e atrelar um formulário a mesma. Este formulário deve possuir configurações específicas necessárias para o mecanismo de busca.

Criando uma busca

Para você criar uma Busca, via Admin console, siga os passos:

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Geral > Buscas

3. Acione o botão Novo

4. Especifique o Nome, a Descrição e o Formulário que será utilizado na busca

5. Acione o botão Salvar

A operação de criação de uma Busca em essência é bem simples, como citado acima, no entanto a operação de se criar o Formulário da busca, merece uma certa atenção.

Uma vez que os valores dos campos do Formulários serão usados para prover dados para a busca de itens de fato, você deve configurar valores adequados para algumas propriedades dos campos do formulário.

Tais valores irá depender da convenção de nomes de atributos de filtragem da busca.

Convenção de nomes de atributos

Uma busca de itens no self-service resume-se na filtragem sobre itens disponíveis até que o usuário do Workspace consiga encontrar o item do acesso desejado.

Logo, pra que essa filtragem seja possível o processo interno das buscas conta com alguns atributos convencionados.

Os atributos convencionados, juntamente com seu possíveis valores e possíveis tipos de campos, são:

Criando busca para itens do tipo recurso

Devido a forma de ligação dos atributos de uma busca com relação aos campos de um formulário, você pode configurar de diversas maneiras buscas para filtrar itens de recursos no self-service. Vamos ver uma delas!

Busca de recursos usando campos do tipo String

Você pode criar uma busca pelo nome aproximando do recurso usando apenas dois campos do tipo String.

Nesse caso, um dos campos irá definir o tipo do item, recurso no caso, e ou outro campo irá referenciar ao nome completo ou parcial de um item de recurso.

As configurações das propriedades do primeiro campo são:

As configurações das propriedades do segundo campo são:

Criando busca para itens do tipo direito

Da mesma forma que para buscar itens do tipo recurso tem-se várias possibilidades de configuração de campos, também o é para as buscas sobre itens do tipo direito.

Vamos ver uma dessas formas.

Busca de direitos de um recurso específico

Você pode criar uma busca pelo nome aproximando do direito, mas fixando o recurso no qual irá ser filtrado os direitos. Serão necessários 3 campos, sendo que um deles será oculto na renderização do formulário.

Nesse caso, um dos campos irá definir o tipo do item, direito no caso, outro campo irá referenciar ao nome completo ou parcial de um item de direito e outro campo irá definir o recurso.

As configurações das propriedades do primeiro campo são:

As configurações das propriedades do segundo campo são:

As configurações das propriedades do terceiro campo são:

Pronto, basta associar um Formulário com esses três campos à uma busca criada e habilitar a mesma.

Criando busca para itens do tipo papel

Dada a natureza dos papéis, num sistema de gestão de identidades e acessos, como o BLAZON, as buscas por um acesso a um papel geralmente são simples e diretas e levam em consideração o nome do papel.

Sendo assim vamos configurar um Formulário com dois campos do tipo String para essa busca. Um dos campos irá definir o tipo do item, papel no caso, o outro campo irá definir o nome completo ou parcial do papel.

As configurações das propriedades do primeiro campo são:

As configurações das propriedades do segundo campo são:

Pronto, basta associar um Formulário com esses dois campos à uma busca criada e habilitar a mesma.

Criando busca para itens do tipo check-in

De forma análoga às buscas por papel, as buscas por um acesso administrativo geralmente são simples e diretas e levam em consideração o nome do acesso administrativo.

Sendo assim vamos configurar um Formulário com dois campos do tipo String para essa busca. Um dos campos irá definir o tipo do item, acesso administrativo no caso, o outro campo irá definir o nome completo ou parcial da conta administrativa.

As configurações das propriedades do primeiro campo são:

As configurações das propriedades do segundo campo são:

Pronto, basta associar um Formulário com esses dois campos à uma busca criada e habilitar a mesma.

Criando busca para itens do tipo usuário

De forma análoga às buscas por papel, as buscas por um item do tipo usuário geralmente são simples e diretas e levam em consideração o nome do item.

Sendo assim vamos configurar um Formulário com dois campos do tipo String para essa busca. Um dos campos irá definir o tipo do item, usuário no caso, o outro campo irá definir o nome completo ou parcial do item usuário.

As configurações das propriedades do primeiro campo são:

As configurações das propriedades do segundo campo são:

Pronto, basta associar um Formulário com esses dois campos à uma busca criada e habilitar a mesma.

Alterando as configurações de uma busca

Para alterar uma Busca:

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Geral > Buscas

3. Realize a busca pelo nome da busca que deseja-se alterar

4. Selecione a busca que deseja-se alterar no resultado de busca

5. Realize as alterações desejadas

6. Acione o botão Salvar

Habilitando/Desabilitando uma busca

Para habilitar ou desabilitar uma Busca:

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Geral > Buscas

3. Realize a busca pelo nome da busca que deseja-se alterar o estado

4. Selecione o check-box da busca que deseja-se alterar o estado no resultado de busca

5. Acione o botão Habilitar caso deseje habilitar a busca selecionada. Acione o botão Desabilitar caso deseje desabilitar a busca selecionada

Removendo uma busca

Para remover uma Busca:

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Geral > Buscas

3. Realize a busca pelo nome da busca que deseja-se remover

4. Selecione o check-box da busca que deseja-se remover

5. Acione o botão Remover

6. Acione o botão Confirmar

Você pode definir validações para um formulário.

Essas validações são definidas como scripts em BeanShell e serão executadas sempre que os dados de um formulário renderizado forem salvas.

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

Uma seção de um formulário pode ser removida a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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

3. Busque pelo formulário que se deseja remover uma Seção, e clique na linha do mesmo

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

5. Clique no ícone de Seções (ver figura abaixo)

6. Selecione as seções que serão removidas

7. Acione o botão Remover

Uma seção de um formulário pode ser editada a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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

3. Busque pelo formulário que se deseja editar uma Seção, e clique na linha do mesmo

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

5. Clique no ícone de Seções (ver figura abaixo)

6. Na caixa de diálogo, selecione a Seção que se deseja editar

7. Edite os campos Nome e Ajuda

8. Acione o botão Salvar

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:

Uma seção de um formulário pode ser reposicionada a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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

3. Busque pelo formulário que se deseja reposicionar as Seções, e clique na linha do mesmo

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

5. Clique no ícone de Seções (ver figura abaixo)

6. Arraste a seção e solte na posição desejada

Pronto, você acaba de reposicionar as seções de um formulário.

Uma validação de um formulário pode ser criada a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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

3. Busque pelo formulário que se deseja criar uma Validação, e clique na linha do mesmo

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

5. Clique no ícone de Validações (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

Uma validação de um formulário pode ser editada a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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

3. Busque pelo formulário que se deseja editar uma Validação, e clique na linha do mesmo

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

5. Clique no ícone de Validações (ver figura abaixo)

6. Selecione a validação 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 editado a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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

Uma validação de um formulário pode ser removida a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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

3. Busque pelo formulário que se deseja remover uma Validação, e clique na linha do mesmo

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

5. Clique no ícone de Validações (ver figura abaixo)

6. Selecione as validações que serão removidas

7. Acione o botão Remover

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.

As validações de um formulário, são definidas de fato, com base em scripts BeanShell.

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

Assim você pode implementar validações 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 validação

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

params = new java.util.HashMap();
params.put("cpf",cpf);
existUser = userService.existUser(params);
if(existUser) {
	owners = organizationService.findOwners(organization.name, organization.type);
	if(owners == null || owners.isEmpty()) {
		return "O cpf " + cpf + " já esta cadastrado na base.";
	} else {
		return "O cpf " + cpf + " já esta cadastrado na base. Procure o " + owners.get(0).get("displayName") + " para que ele verifique.";
	}
	return false;
} else {
	return true;
}

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

1. Autentique-se no Admin console

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 removido a qualquer momento e você deverá seguir os passos:

1. Autentique-se no Admin console

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