Consultas

Esta página apresenta os itens para criação/definição de consultas, para obtenção de dados a serem utilizados nos itens de relatórios.

Fig. Árvore de itens de Queries

Queries

Este item permite criar a hierarquia de itens necessários para elaboração de consultas a bases de dados, para obtenção de dados a serem usados nos relatórios. Para adicionar o próximo item da hierarquia, QueryGroup, clique com botão direito do mouse sobre o item Queries e selecione o menu “Adiciona Item -> QueryGroup”.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades do IDE, quando selecionado o item Queries no painel de projeto.

Identificação
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)

QueryGroup

O item QueryGroup é utilizado para agrupar Consultas (Query). Para adicionar um item de consulta, clique com botão direito do mouse sobre o item QueryGroup e selecione o menu “Adiciona Item -> Query” ou “Adiciona Item -> HistoryQuery”.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item QueryGroup no painel de projeto.

Propriedades de identificação do objeto
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)
Descrição	Texto opcional que permite a inclusão de uma breve descrição do item associado. Este campo é apenas documental.	(Nenhum)

Query

O item Query é utilizado para realizar as configurações de uma consulta para a obtenção de dados a partir de uma base de dados externa à aplicação, para utilização destes dados em Relatórios. Para adicionar itens deste tipo (Query), clique com botão direito do mouse sobre o item QueryGroup e selecione o menu “Adiciona Item -> Query”.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item Query no painel de projeto.

Propriedades de identificação do objeto
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)
Descrição	Texto opcional que permite a inclusão de uma breve descrição do item associado. Este campo é apenas documental.	(Nenhum)

Propriedades Comuns
Propriedade	Descrição	Default
String de consulta	Permite inserção de texto representando a consulta a ser executada para obtenção dos dados. Usuário precisa possuir conhecimento básico de SQL.	Sem DataBase definida

Propriedades Específicas
Propriedade	Descrição	Default
Conexão	Permite seleção (através de um Combo Box) de base de dados no qual será realizada a consulta especificada no campo String de Consulta. As opções de bases de dados listadas referem-se aos itens DataBase criados sob o item DataBases na árvore de Globals.	(Nenhum)

HistoryQuery

O item HistoryQuery é utilizado para realizar as configurações de uma consulta para a obtenção de dados a partir de um Histórico, os quais poderão ser utilizados em Relatórios. Para adicionar itens deste tipo (HistoryQuery), clique com botão direito do mouse sobre o item QueryGroup e selecione o menu “Adiciona Item -> HistoryQuery”.

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item HistoryQuery no painel de projeto.

Propriedades de identificação do objeto
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)
Descrição	Texto opcional que permite a inclusão de uma breve descrição do item associado. Este campo é apenas documental.	(Nenhum)

Propriedades Comuns
Propriedade	Descrição	Default
String de consulta	Permite inserção de texto representando a consulta a ser executada para obtenção dos dados. Usuário precisa possuir conhecimento básico de SQL.	Sem DataBase definida

Propriedades Específicas
Propriedade	Descrição	Default
Histórico	Permite a seleção (através de um seletor de itens) de um item do tipo Histórico sobre o qual será realizada a consulta especificada no campo String de Consulta.	(Nenhum)

Detalhamento da inserção de Histórico no HistoryQuery Ao clicar no botão deste campo, o Seletor de Itens é exibido. Nele o usuário deve selecionar a ‘’Origem’’ (Kernel, Model) do Histórico. Serão listados os Grupos de Históricos (HistoryGroup) que eventualmente existirem, abaixo da hierarquia do item selecionado como ‘’Origem’’. Para cada grupo listado, serão exibidos os itens de Histórico nele cadastrados. O usuário deve confirmar a seleção. Caso o Histórico selecionado pelo usuário não possua uma base de dados associados, o ambiente não permitirá a seleção deste Histórico, exibindo mensagem para o usuário. Caso a seleção de Histórico tenha ocorrido com sucesso, ocorrerá o que se segue: Caso seja um Histórico do (com origem no) Kernel: Serão inseridos, abaixo do HistoryQuery, dois QueryParm: DataHoraInicial: Representa o filtro de data e hora inicial a ser utilizado para obtenção dos dados; DataHoraFinal: Representa o filtro de data e hora final a ser utilizado para obtenção dos dados; Caso seja um Histórico de (com origem em) Modelo: Além dos dois QueryParm mencionados no item anterior, será inserido mais um QueryParm: Origem: Representa o filtro de nome de origem a ser utilizado para obtenção dos dados; Em ambos os casos (Histórico de Kernel ou de Modelo), após a seleção e criação dos QueryParms, é realizado preenchimento automático da ‘’String de Consulta’’ do HistoryQuery com um valor padrão, baseado nos filtros mencionados.

QueryParm

O item QueryParm é para estabelecer valores para parâmetros de filtragem a serem utilizados na String de Consulta do item pai (Query ou HistoryQuery)

A tabela a seguir apresenta os parâmetros disponíveis para configuração pelo editor de propriedades, quando selecionado o item QueryParm no painel de projeto.

Identificação
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)

Propriedades Específicas
Propriedade	Descrição	Default
Tag	Permite seleção (através de um Seletor de Itens) de um item do tipo TagRef. O valor associado ao Tag referenciado por este item poderá ser usado para configuração de filtros na consulta especificada na propriedade String de Consulta do item pai (Query ou HistoryQuery).	(Nenhum)