¶ 1. Visão Geral
O Formulário de Dados é o recurso do T6 utilizado para visualizar, inserir, atualizar e remover registros de uma Tabela de Dados. Ele funciona como uma interface de interação com a base de dados, permitindo configurar quais campos serão exibidos, quais ações estarão disponíveis e quais regras se aplicarão durante o uso.
Ao criar um formulário, o primeiro passo é decidir como ele será vinculado a uma Tabela de Dados:
- Criando uma nova tabela, diretamente no editor.
- Utilizando uma tabela já existente, previamente configurada no T6.
¶ 1.1. Pré-requisitos
Para acessar essa funcionalidade, é necessário habilitar o preview DataForm New Create or Edit.
Para criar e editar formulários de dados, será necessário possuir as seguintes permissões:
O usuário deverá ter, em Permissões, as seguintes Funcionalidades de Gestor habilitadas:
Também será necessário estar associado a um grupo global, com as seguintes Funcionalidades de Gestor habilitadas:
¶ 2. Funcionalidades
¶ Associação a uma Tabela de Dados
- Criar uma nova Tabela: Ao selecionar essa opção, um painel lateral será aberto. Nele, é possível configurar todos os campos da nova tabela sem precisar mudar de aba ou sair da tela atual (para que essa opção seja exibida o usuário deverá possuir permissões para criação de tabelas de dados). Para mais detalhes sobre este processo, consulte a documentação de criação de Tabelas de Dados.
Após criar uma nova tabela através dessa tela o formulário de dados será aberto para edição sem a necessidade de acessar outras telas.
- Usar uma Tabela existente: Um dropdown exibirá todas as tabelas já cadastradas. Basta escolher a desejada para vinculá-la ao formulário.
¶ Estrutura do Editor
O editor é dividido em painéis laterais:
- Dados: lista todas as colunas disponíveis na Tabela de Dados vinculada.
- Designer: permite escolher quais colunas serão exibidas no formulário e como serão organizadas.
- Páginas: exibido apenas quando existem colunas do tipo Link de Dados (como "Usuário" ou "Tabela de Dados") ou metadados de colunas do tipo Dimensão. Essas páginas permitem criar subdivisões de informações dentro do formulário.
Ao adicionar colunas no Designer, a visualização do formulário é atualizada em tempo real.
¶ Designer
Ao adicionarmos uma coluna da Tabela de Dados ao painel Designer, algumas interações serão possíveis, a depender do tipo de coluna adicionada.
- Excluir: Disponível em todos os tipos de coluna. Efetua a remoção de uma coluna do painel Designer.
- Linkar Coluna: Disponível em todos os tipos de coluna. Permite fazer um link entre a coluna selecionada e um formulário de dados existente; ao criarmos o link, podemos acessar o formulário associado sem sair do formulário de origem.
- Filtragem: disponível apenas para colunas do tipo Data Table ou Dimensão durante a edição.
- Ao clicar no ícone de filtro um painel será aberto na lateral, onde faremos a seleção da Hierarquia e do Tipo de Agregação, para mais informações sobre os tipos de agregação acesse: Seleção de membros. Neste painel faremos a seleção dos membros e/ou atributos que serão exibidos na coluna selecionada.
-
Editar: Disponível em todos os tipos de coluna. Ao clicarmos em Editar, um painel será aberto na lateral, onde podemos alterar as propriedades da coluna selecionada. Temos os seguintes campos:
-
Nome: permite alterar o nome de exibição no cabeçalho do formulário;
-
Tamanho da Coluna: permite alterar a dimensão da coluna selecionada; valor padrão 210px;
-
Casas Decimais: disponível somente para colunas do tipo Valor; permite definir o número de casas decimais a serem exibidas após a vírgula em um número decimal;
-
Alinhamento da Coluna: dropdown no qual podemos definir o alinhamento dos dados dentro da coluna selecionada; opções Indefinido, Esquerda, Centro e Direita;
-
Somente Leitura: botão switch; quando desabilitado, permite a escrita nas células da coluna selecionada; quando habilitado, a escrita nas células é bloqueada, sendo possível somente a leitura dos dados;
-
Aplicar Segurança do Usuário: podemos utilizar a flag "Aplicar Segurança do Usuário" nas colunas do formulário de dados, fazendo com que os registros exibidos sejam filtrados com base no usuário logado, ocultando registros destinados a outros usuários. Para efetuar essa filtragem, será necessária a utilização de uma Tabela de Dados do tipo consulta, onde iremos trazer os usuários do sistema. Utilizaremos essa Tabela de Dados para fazer um link com uma coluna do formulário de dados, permitindo assim realizar a filtragem por usuário logado. Para aplicarmos este filtro em páginas, será necessária a criação de uma Tabela de Dados à qual iremos linkar com o identificador do formulário de dados e adicioná-lo em "Páginas", aplicando a segurança do usuário e selecionando, no dropdown, a coluna que desejamos filtrar da Tabela de Dados.
-
Colunas da Tabela de Dados: somente será habilitado caso a flag "Aplicar Segurança do Usuário" esteja ativa. Habilita um dropdown para seleção de uma coluna específica da Tabela de Dados associada;
-
Hierarquia: campo habilitado somente quando temos uma coluna com link direto para outra coluna da mesma Tabela de Dados;
-
Largura do Campo: somente será aplicada quando o tipo de abertura for definido como Painel. A largura-limite para exibição de uma coluna em um painel é "12"; sendo assim, se o valor for definido como "12", teremos a exibição da coluna ocupando toda a linha; se definirmos o valor como "6", teremos a exibição de duas colunas na mesma linha, e assim sucessivamente.
-
Exemplo: Na imagem abaixo, temos a exibição de um formulário de dados com o modo de visualização definido como Painel.
- Na primeira linha, temos a exibição de "3" colunas, pois tiveram sua largura definida para "4";
- Na segunda linha, temos a exibição de "2" colunas, pois tiveram sua largura definida como "6";
- Na terceira linha, temos a exibição de somente uma coluna, pois sua largura foi definida como "12", dessa forma ocupando toda a largura disponível no painel;
- Na quarta linha, temos a exibição de "12" colunas, pois a largura foi definida como "1".
-
Número de caracteres para abrir o dropdown: disponível somente para colunas dos tipos Dimensão, Usuário e Tabela de Dados. Podemos definir quantos caracteres são necessários para exibir as opções disponíveis para seleção; o valor padrão é 3 caracteres;
-
Valor padrão para a coluna: Através deste campo podemos definir um valor padrão que será exibido como exemplo antes da inserção de dados, podemos inserir qualquer valor desde que respeite o formato de inserção permitido pela coluna. Em uma coluna com valor padrão definido, se adicionarmos uma nova linha no formulário sem efetuar o preenchimento de dados na coluna em questão o mesmo será preenchido de forma automática utilizando o valor definido como padrão.
Exemplo:
-
Visualizar: a opção Visualizar somente será habilitada em colunas do tipo Tabela de Dados, ou colunas com link para uma Tabela de Dados. Ao clicarmos no ícone
, um painel será aberto na lateral, onde podemos efetuar a seleção dos metadados que desejamos que sejam exibidos na célula do formulário.- Metadados: são informações de referência e não podem ser alterados diretamente pelo formulário.
¶ 3. Configurações
¶ Aba Editar
A aba Editar centraliza as configurações do formulário.
Botão Salvar: Salva as configurações e a disposição de colunas e páginas definidas.
Editar/Visualizar: Botão que nos permite alternar entre os modos de edição e visualização sem a necessidade de troca de tela ou recarregamento de página. No modo de edição as opções de configuração do formulário estarão ativas, enquanto no modo de Visualização as opções de configuração não poderão ser alteradas.
←→
Botão Propriedades: Ao clicarmos em Propriedades, um painel será aberto na lateral, onde iremos definir:
- Modo de Visualização: controla como o formulário será exibido (Padrão, Painel, Dinâmico ou Janela).
Permissões: Temos as seguintes checkboxes:
- Permitir inserir linhas – habilita a inclusão de novos registros.
- Permitir remover linhas – libera a exclusão de registros existentes.
- Permitir atualizar linhas – permite a edição de registros.
¶ Ordenação e Formatação
- Ordenar Colunas: permite definir a ordem de exibição, selecionando múltiplas colunas e optando por ordem crescente ou decrescente (alfabética para colunas do tipo texto).
- Grupo de Formatação: aplica estilos predefinidos ao formulário. Ao clicarmos, será exibido um painel na lateral onde faremos a seleção de um grupo de formatação por meio de um dropdown.
¶ Aba Formatação
Além das configurações da aba Editar, é possível aplicar estilos visuais:
- Selecionando um Grupo de Formatação previamente criado.
- Utilizando ferramentas da Ribbon para ajustes pontuais.
Mais detalhes em: Formatação.
¶ 4. Utilização
-
Acesse o menu principal do T6;
-
Selecione a opção Explorer;
- Após acessar o Explorer, navegue até o local desejado para criação do objeto;
-
Clique em Novo Item na Ribbon;
-
Clique em Data Entry para exibir as opções disponíveis;
- Selecione a opção Formulário de Dados;
- Abra o objeto criado, com um duplo clique ou através da Ribbon, clicando em Abrir;
- A tela será atualizada. Caso o usuário tenha as features necessárias para criação de tabelas de dados serão exibidas duas opções: Criar uma nova Tabela de Dados e Utilizar Tabela de Dados existente; selecione uma das opções;
- Criar uma nova Tabela de Dados: Para mais detalhes sobre este processo, consulte a documentação de criação de Tabelas de Dados.
- Utilizar Tabela de Dados existente: Um dropdown exibirá todas as tabelas já cadastradas, separando-as por pastas conforme a hierarquia de pastas do Explorer. Basta escolher a Tabela de Dados desejada para vinculá-la ao formulário (se o usuário não possuir permissões para criação de tabelas de dados a tela anterior não será exibida, forçando o usuário a selecionar uma tabela existente).
→
Após selecionar a Tabela de Dados, a tela para configuração e edição do formulário será aberta, onde iremos configurar os dados de maneira dinâmica. Inicialmente, nenhuma linha, coluna ou página será exibida; deveremos configurar a disposição através dos painéis Dados e Designer;
- No painel Dados, teremos a exibição das colunas existentes na Tabela de Dados selecionada anteriormente. Clique em "|||" para adicionar como coluna. Clique em "≡" para adicionar como página, é possível também definir a disposição utilizando drag and drop (arrastar e soltar);
-
Ao selecionar uma coluna da Tabela de Dados, ela será disposta no painel Designer, respeitando a seleção anterior (coluna ou página), e será refletida ao lado, no preview do formulário de dados.
- Para alterar a ordem de disposição de colunas e páginas, após adicioná-las ao painel Designer, altere a ordem de exibição utilizando drag and drop (arrastar e soltar).
- Após definir a disposição de colunas e páginas, acesse a aba Editar e configure conforme necessário (Configurações).
- Para finalizar a criação do formulário de dados, clique em Salvar.
Atenção: Caso alterne entre os modos de visualização/edição sem salvar as alterações realizadas serão perdidas.
Após salvar o formulário, ele estará pronto para utilização.