Feedback Imprimir

SubConsulta

Subconsultas são usadas quando é preciso exibir dados hierárquicos, como Clientes e seus respectivos Pedidos. Para tanto a consulta principal encapsula outras consultas, mostrando em cada um dos seus registros dados complementares das subconsultas. Observe a figura abaixo onde para cada cliente é exibida uma subconsulta com os seus pedidos.

Consulta de clientes com subconsulta de pedidos. Consulta de clientes com subconsulta de pedidos.

Configuração

No menu de aplicação, clicando sobre o item Configuração da pasta Subconsultas, poderão ser alterados os atributos gerais das subconsultas.

Menu Subconsultas.

Configuração geral da subconsulta.

  • Título da mesma linha : Este atributo permite configurar a forma de exibição da subconsulta. Caso o título seja exibido na mesma linha, a tabela da subconsulta será incorporada à consulta principal. Usando título da subconsulta na mesma linha.

  • PDF : Esta opção permite habilitar/desabilitar a exibição da subconsulta nos relatórios PDF.
  • XLS: Esta opção permite habilitar/desabilitar a exibição da subconsulta nos relatórios XLS e XLSX.
  • XML: Esta opção permite habilitar/desabilitar a exibição da subconsulta nos relatórios XML.

  • Habilitar Treeview : Esta opção adiciona na consulta um recurso de esconder/exibir a subconsulta. Escolhendo Sim, a opção Título da mesma linha ficará desabilitada. Usando treeview na subconsulta

  • Posicionamento : Permite configurar o posicionamento das subconsultas dentro da consulta principal. As opções são:
    • Em uma Coluna Exibe a subconsulta na mesma linha do registro da consulta principal Exibe a subconsulta na mesma linha do registro da consulta principal.

    • Abaixo de um Registro Exibe a subconsulta em uma linha separada abaixo do registro da consulta principal Exibe a subconsulta em uma linha separada abaixo do registro da consulta principal.

    • Alinhamento : Permite configurar o alinhamento da subconsulta em relação a consulta principal quando a opção Posicionamento for Abaixo de um Registro. As opções são: Esquerda, Direita e Centro.

Definir Individualmente

Qualquer um dos atributos que utilizar o valor Definir Individualmente obriga que a propriedade seja configurada em cada uma das ligações criadas.

Ligações

Para criar uma nova ligação com uma subconsulta clique sobre o item Nova Ligação na pasta Ligações dentro de Subconsultas.

Criando uma nova subconsulta Criando uma nova subconsulta

  • Adicionando uma nova subconsulta : Informe o nome e o label para a ligação que será criada.

Adicionando uma nova subconsulta Adicionando uma nova subconsulta

  • Lista de aplicações : Serão listadas aplicações de consulta do projeto corrente que contenham variáveis globais.

Seleção da aplicação de consulta. Seleção da aplicação de consulta.

  • Para que uma aplicação seja utilizada como subconsulta, ela deve ter dentro de seu Comando SQL ( Consulta > SQL ) uma cláusula WHERE com variável global.

Configuração do SQL da Consulta que será usada como subconsulta através de ligação. Configuração do SQL da Consulta que será usada como subconsulta através de ligação.

  • Definição dos parâmetros : Definindo o valor que será passado para a(s) variável(is) do Comando SQL da subconsulta.

Passagem de parâmetro para variável Passagem de parâmetro para variável

Na tela acima, do lado esquerdo, são exibidos parâmetros de entrada da subconsulta (variavéis globais), no lado direito, deverá ser selecionado a opção para passagem de parâmetro. As opções são:

  • Atributos
    • Campo : Utilizado para passagem do valor de um campo da consulta como parâmetro.
    • Fixo : Utilizado para passagem de um valor fixo como parâmetro.
    • Vazio : Escolhendo essa opção não será passado nenhum valor como parâmetro.
    • Botão Salvar : Clicando neste botão a criação da ligação de subconsulta será concluída.

Editando Subconsultas

No menu de aplicação dentro da pasta Subconsultas existe uma pasta ligações que contém todas as subconsultas chamadas por esta aplicação. Clicando sobre uma subconsulta será exibida uma tela para edição.

Editando subconsultas Editando subconsultas

Configuração Geral

Configuração geral de Subconsulta Configuração geral de Subconsulta

Nesta interface é posivel editar os seguintes atributos da subconsulta:

  • Label : Título da subconsulta na aplicação
  • Ligação : Neste atributo são exibidos dados sobre a ligação atual com a subconsulta, mostrando a aplicação e os parâmetros usados. Para alterar qualquer atributo da ligação clique no botão Editar Ligação.
  • Exibição : Este atributo permite que seja definido quais itens da subconsulta, caso a subconsulta utilize algum destes recursos, serão visualizados na consulta principal. Configuração de exibição Configuração de exibição

    • 1 : Exibir Título.
    • 2 : Exibir Sequencial (Número de Linha).
    • 3 : Exibir Totalização.
  • Herdar Visualização : Quando marcado força que o esquema de visualização da subconsulta seja igual ao da consulta principal.

Definir individualmente

Caso o valor de um dos atributos da configuração da subconsulta tenha sido selecionado como Definir Individualmente, estes deverão ser configurados na tela de edição da ligação da subconsulta, para cada subconsulta que a aplicação chamar.

Configuração das Subconsultas. Configuração das Subconsultas.

Configuração da visualização

Estas opções só serão exibidas caso todas as seguintes condições sejam verdadeiras:

Atributo Valor
Titulo na mesma linha Não
Habilitar Treeview Não
Posicionamento Em uma Coluna

Configuração de visualização da subconsulta Configuração de visualização da subconsulta

  • Atributos
    • Alinhamento Horizontal : Define o alinhamento horizontal da subconsulta. Pode ser alinhado a Esquerda, Direita ou Centro.
    • Alinhamento Vertical : Define o alinhamento vertical da subconsulta. Pode ser alinhado ao Topo, Meio ou Final.
    • Cor do Fundo : Pode definir a cor de fundo. Caso não seja preenchido será utilizado a cor de fundo de aplicações de consulta do Esquema de Visualização atual.
    • Alinhamento Horizontal do Título : Define o alinhamento horizontal do Label da subconsulta. Pode ser alinhado a Esquerda, Diretira ou Centro.
    • Alinhamento Vertical do Título : Define o alinhamento vertical do Label da subconsulta. Pode ser alinhado ao Topo, Meio ou Final.
    • Negrito : Define o título (label) da subconsulta em negrito.