Documentação

10 Formulário de consulta

Este tipo de página permite criar formulários em modo somente leitura, embora semelhante com formulários de cadastro ele não permite edições.

Formulário de consulta

10.1 Criação

Para criar um formulário de consulta, deve ser utilizada a opção “Nova página”, e em seguida, selecionar “Formulário de consulta”. Após, será aberto um diálogo com informações necessárias para a criação. Para criar uma listagem, deve-se informar respectivamente:

  1. A base de dados desejada.

  2. A tabela que o formulário buscará as informações

  3. O módulo em que a página ficará agrupada.

  4. Informar se a página aparecerá no menu da aplicação.

  5. O nome da classe controladora do formulário.

  6. O nome da página no menu da aplicação.

  7. Informar se a página será pública. Páginas públicas são acessíveis para usuários não logados na aplicação.

Após a criação, a página do formulário será apresentada em tela com os campos da tabela selecionada rótulo + campo. No topo, tem-se a barra de ferramentas, e à direita o painel de propriedades, eventos e filtros. Com a criação, o desenvolvedor pode proceder com as definições de quais campos serão exibidos, configurar estilos para os dados do formulário, adicionar detalhes, atalhos e outros componentes. Todos os componentes que podem ser adicionados no formulário são para extração informações.

Seguem os componentes disponíveis.:

Componente Descrição
Label Rótulo de texto com formatação de fonte e cor
Image Exibe uma imagem
TextDisplay(DateTime) Campo de texto para visualização de datas com horas e definições de máscaras
Link Caminho de ligação
File Link para download de um arquivo.
TextDisplay Campo de texto
TextDispay(Date) Campo de texto para datas com definições de máscaras
TextDisplay(Numeric) Campo de texto para números
ActionLink Botão de ação que permite executar métodos de outras páginas.

As propriedades e ferramentas da página se apresentam de maneira muito similar com um formulário de cadastro, para mais informações capítulo 7.

10.2 Formulário de consulta com detalhe

Este tipo de página consegue exibir mais informações do que apenas as da tabela selecionada, é possível adicionar detalhes de outras entidades que possuem relacionamento. Um exemplo seria em um sistema de reservas de recursos um formulário de consulta da tabela pessoas pode ter um detalhe (Grid) com as informações dos empréstimos já realizados por ela.

Para adicionar um detalhe basta clicar na opção "Listagem detalhe" e selecionar a relação desejada. Mais de um detalhe pode ser adicionado por página.

Formulário de consulta com detalher

Em formulários de consulta é possível adicionar botões que funcionaram como links e ações, eles ficam no topo da página e sua configuração é idêntica é a mesma explicada no capítulo 6.2.1 Barra de ferramentas.

Ações em formulários de consulta