Corfix Form Builder: Utilização do componente «Data Grid».

Este poderoso componente permite-lhe criar uma estrutura dinâmica e repetível, semelhante a uma tabela, na qual os utilizadores podem adicionar várias linhas de subcomponentes (campos). É ideal para recolher listas de itens, várias entradas do mesmo tipo ou dados complexos que se repetem.

Onde o encontrar

No seu Corfix Form Builder, clique num Componente de Grelha de Dados para aceder ao painel de configuração. Irá ver quatro separadores:

• Exibição

• Dados

• Validação

• Condicional

1. Separador «Exibição»

O separador «Exibição» controla o layout e a aparência geral do componente «Grelha de Dados».

• Rótulo:

  • Este é o título visível da sua secção da grelha de dados que os utilizadores irão ver. É um campo obrigatório.

  • Exemplo: «Itens de linha», «Participantes», «Defeitos detetados».

• Posição do rótulo:

  • Determina onde o rótulo é apresentado em relação à grelha de dados (por exemplo, Topo, Esquerda, Direita, Fundo).

  • Predefinição: Topo.

• Descrição:

  • Fornece texto explicativo adicional para o componente, normalmente apresentado abaixo do rótulo.

  • Exemplo: «Enumerar todos os materiais utilizados, a quantidade e o preço unitário.»

• Dica de ferramenta:

  • Texto que aparece quando o utilizador passa o cursor do rato sobre o componente. Útil para fornecer ajuda rápida ou contexto para toda a grelha.

• Desativar adição/remoção de linhas:

  • Se esta opção estiver marcada, os utilizadores não poderão adicionar novas linhas nem remover as existentes na grelha de dados. Isto torna-a, efetivamente, num conjunto fixo de linhas.

• Adicionar outro texto:

  • Personaliza o texto do botão em que os utilizadores clicam para adicionar uma nova linha.

  • Predefinição: «Adicionar outro».

• Adicionar outra posição:

  • Determina onde o botão «Adicionar mais um» aparece em relação às linhas (por exemplo, Inferior, Superior, Ambos).

  • Predefinição: Parte inferior.

• Inicializar vazio:

  • Se estiver marcado, a grelha de dados começará sem nenhuma linha visível, e o utilizador terá de clicar em «Adicionar outro» para começar a adicionar entradas. Se não estiver marcado, começará normalmente com uma linha vazia.

• Classe CSS personalizada:

  • Permite que utilizadores avançados apliquem estilos personalizados a todo o componente utilizando classes CSS.

• Ocultar rótulo:

  • Se marcada, a etiqueta principal do componente não será apresentada no formulário.

• Mostrar Rótulo na Grelha de Dados:

  • Esta definição controla provavelmente se os rótulos individuais dos campos em cada linha da grelha de dados são apresentados (por exemplo, se for adicionado um campo «Quantidade» à grelha, esta definição controla se «Quantidade» aparece acima ou ao lado do campo de introdução de dados em cada linha).

• Edição modal:

  • Se esta opção estiver marcada, a edição de linhas ou componentes individuais na grelha de dados poderá abrir-se numa janela modal pop-up separada, o que pode ser útil para linhas complexas.

2. Separador «Dados»

O separador «Dados» gere os dados iniciais e a estrutura da grelha de dados.

• Valor predefinido:

  • Permite-lhe preencher previamente a grelha de dados com uma ou mais linhas predefinidas quando o formulário for carregado. Deve clicar em «Adicionar outra» aqui para definir essas linhas predefinidas.

3. Separador «Validação»

O separador «Validação» define as regras para o componente «Grelha de Dados».

• Obrigatório:

  • Se esta opção estiver marcada, o utilizador deve adicionar, pelo menos, uma linha à grelha de dados antes de enviar o formulário.

• Comprimento mínimo:

  • O número mínimo de linhas que deve estar presente na grelha de dados.

• Comprimento máximo:

  • O número máximo de linhas que podem ser adicionadas à grelha de dados.

4. Separador «Condicional»

O separador «Condicional» permite-lhe definir regras que determinam quando todo este componente de grelha de dados (e todos os componentes nele contidos) deve ser apresentado ou ocultado, com base nos valores de outros componentes do formulário.

• Simples:

  • Trata-se normalmente de um botão de alternância ou de um menu suspenso para selecionar entre lógica condicional simples e avançada.

• Este componente deve «Mostrar»:

  • Escolha se o componente deve «Mostrar» ou «Ocultar» (opções implícitas) com base na condição.

• Quando o componente do formulário:

  • Selecione outro componente no seu formulário cujo valor irá acionar a condição.

• Tiver o valor:

  • Especifique o valor exato que o componente do formulário selecionado deve ter para que a condição seja cumprida.

  Exemplo: Pode configurar uma regra para que a grelha de dados «Despesas adicionais» só seja apresentada quando a caixa de seleção «Existem despesas adicionais?» estiver marcada.

Janela de Pré-visualização

A área de pré-visualização, no lado direito da caixa de diálogo, representa visualmente o componente Grelha de Dados. Normalmente, apresenta um espaço reservado para uma linha e um botão «Adicionar outro», indicando que os utilizadores podem adicionar várias entradas. Ajuda-o a visualizar como a secção repetível irá aparecer no seu formulário.

Ações na parte inferior da caixa de diálogo:

• Guardar: Guarda todas as alterações efetuadas nas definições do componente «Grelha de dados».

• Cancelar: descarta quaisquer alterações não guardadas e fecha a caixa de diálogo.

• Remover: Elimina o componente «Data Grid» e todos os componentes nele colocados do formulário.

Boas práticas para o componente «Grelha de dados»:

• Utilizar para dados repetitivos: Ideal para cenários em que os utilizadores precisam de adicionar várias entradas do mesmo tipo, como uma lista de artigos em inventário, dependentes ou leituras diárias.

• Personalizar «Adicionar outro texto»: Altere o «Adicionar outro texto» para que seja mais descritivo (por exemplo, «Adicionar outro item», «Adicionar nova pessoa») para uma melhor orientação do utilizador.

• Definir comprimento mínimo/máximo: Utilize o «Comprimento mínimo» para garantir que os dados essenciais são recolhidos (por exemplo, pelo menos um defeito comunicado) e o «Comprimento máximo» para evitar entradas excessivas, se necessário.

• Considere a opção «Inicializar vazio»: Para grelhas que possam nem sempre ser necessárias, marque «Inicializar vazio» para manter o formulário mais organizado até que o utilizador precise explicitamente de adicionar linhas.

• Exibição condicional: Oculte toda a grelha de dados até que seja relevante para a entrada do utilizador, tornando os formulários complexos mais fáceis de navegar.