Mudanças entre as edições de "Consulta:Grid"

De LATROMI Manuais
Ir para: navegação, pesquisa
(Filtros Avançados)
(Disposição das Colunas)
 
(30 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 2: Linha 2:
  
 
== Comando SQL ==
 
== Comando SQL ==
 +
Na aba ''Comando SQL'', deve ser informado um comando que retorne dados, como SELECT ou chamadas de Funções e Stored Procedures.
  
 +
Para maiores informações, consulte a página [[Editor de Comandos SQL]].
  
 
== Configurações ==
 
== Configurações ==
 
Na parte inferior da sessão de configurações da Grid, há uma parte que mostra a descrição da propriedade selecionada. Isso ajuda a entender para que serve cada configuração.
 
Na parte inferior da sessão de configurações da Grid, há uma parte que mostra a descrição da propriedade selecionada. Isso ajuda a entender para que serve cada configuração.
Neste tópico, serão abordados apenas algumas configurações, que exigem um pouco mais de explicação.
+
<!--Neste tópico, serão abordados apenas algumas configurações, que exigem um pouco mais de explicação.-->
[[Arquivo:Client Consulta GridSettings.png|miniaturadaimagem|nenhum|Tela de Configurações da Grid]]
+
[[Arquivo:Client Consulta GridSettings.png|miniaturadaimagem|nenhum|Tela de Configurações da Grid no LATROMI Client]]
  
== Filtros Avançados ==
+
== Filtros ==
 +
Na Grid é possível utilizar dois modos de filtros diferentes. Os filtros serão habilitados apenas para as colunas configuradas para tal.
  
Também conhecido por ''Excel Like-Filtering''. Quando habilitado, o filtro padrão (''que utiliza um campo de entrada de dados no cabeçalho da coluna'') será substituído por um botão, que ao clicar exibe um menu com opções avançadas para filtragem.
+
No modo de '''Filtro Padrão''', são exibidos no LATROMI Web campos de entrada de dados no cabeçalho das colunas. Para filtrar basta preencher este campos.
  
[[Arquivo:Web Consulta GridFilters.png|miniaturadaimagem|nenhum|Tipos de Filtros da Grid]]
+
No modo de '''Filtro Avanaçado''' (também conhecido por ''Excel Like-Filtering''), o filtro padrão (''que utiliza um campo de entrada de dados no cabeçalho da coluna'') será substituído por um botão, que ao clicar exibe um menu com opções avançadas para filtragem.
 +
 
 +
[[Arquivo:Web Consulta GridFilters.png|miniaturadaimagem|none|Tipos de Filtros da Grid no LATROMI Web]]
 +
 
 +
== Agrupamento de Dados ==
 +
O Agrupamento de Dados, como o próprio nome sugere, cria uma visão hierárquica dos dados, agrupando as informações pelas colunas selecionadas para agrupamento.
 +
Os dados podem ser agrupados em tempo de execução pelo usuário no LATROMI Web, como também podem ser pré-configurados para isso no LATROMI Client.
 +
 
 +
[[Arquivo:Web Consulta Agrupamento.mkv|thumb|none|854px|Agrupamento de dados da Grid no LATROMI Web]]
 +
 
 +
== Configuração das Colunas ==
 +
[[Arquivo:Client Consulta ConfiguracoesDasColunas.png|miniaturadaimagem|right|Configurações das Colunas da Grid]]
 +
Sempre que o Comando SQL usado para popular os dados da Grid for confirmado no cadastro da Consulta, a sessão de '''Colunas'' será atualizada. Nessa sessão, existe um item correspondente para cada coluna resultante do Comando SQL, e neles é possível configurar a formatação de texto, alinhamento, formatação e comportamentos das colunas.
 +
 
 +
As configurações das Colunas estão listadas na tabela abaixo:
 +
 
 +
{| class="wikitable"
 +
! Propriedade
 +
! Descrição
 +
|---------------------------------
 +
| Seq.
 +
| Sequência da Coluna. Não pode ser alterada.
 +
|---------------------------------
 +
| Nome
 +
| Nome da Coluna. É o mesmo nome da coluna retornada no Comando SQL. Não pode ser alterada.
 +
|---------------------------------
 +
| Descrição
 +
| Texto de Cabeçalho das Colunas.
 +
|---------------------------------
 +
| Tipo
 +
| Tipo de Dados da Coluna. Essa coluna assume o tipo correto automaticamente. Ela só precisa ser alterada manualmente para '''Hora''' quando for necessário configurar um totalizado do tipo '''Soma''' para uma coluna do tipo texto que contenha horas no formato <code>hh’:’mm[’:’ss]</code>.
 +
 
 +
Os tipos disponíveis são: Alfanumérico, Numérico, Data e Hora.
 +
|---------------------------------
 +
| [[Arquivo:Client Consulta Buttons ColunaVisivel.png]]
 +
| Propriedade que torna a coluna visível ou invisível.
 +
|---------------------------------
 +
| [[Arquivo:Client Consulta Buttons ColunaMobile.png]]
 +
| Propriedade que torna a coluna visível ou invisível apenas em dispositivos móveis.
 +
|---------------------------------
 +
| [[Arquivo:Client Consulta Buttons ColunaLock.png]]
 +
| Propriedade que torna a coluna parte do grupo de colunas Fixadas.
 +
|---------------------------------
 +
| [[Arquivo:Client Consulta Buttons ColunaFiltro.png]]
 +
| Propriedade que habilita ou desabilita o filtro da coluna.
 +
|---------------------------------
 +
| [[Arquivo:Client_Consulta_Buttons_ColunaAgrupamento.png]]
 +
| Propriedade que configurada a coluna para agrupamento de dados automaticamente ao abrir a Consulta.
 +
|---------------------------------
 +
| [[Arquivo:Client Consulta Buttons ColunaMultiline.png]]
 +
| Propriedade que habilita ou desabilita a renderização de quebras de linha na coluna. Essa configuração será ignorada quando a opção '''Exibir Quebra de Texto''' das configuração de Grid estiver com o valor "''Para todas as Colunas''".
 +
|---------------------------------
 +
| Largura
 +
| Largura da Coluna em Pixels. Se a area disponível no navegador for maior que a soma da largura de todas as colunas, o sistema vai distribuir proporcionalmente a diferença entre as colunas para que seja ocupada a largura inteira da tela.
 +
|---------------------------------
 +
| Alinhamento
 +
| Define o alinhamento da coluna. Quando as colunas são criadas, elas já assumem um alinhamento padrão conforme o tipo de dados: tipos Alfanuméricos ficam alinhados a esquerda, tipos Numéricos a direita e Datas ao centro.
 +
|---------------------------------
 +
| Formato
 +
| Formatação da coluna. Para saber mais: [[Formatação de Valores]].
 +
|---------------------------------
 +
| [[Arquivo:Client Consulta Buttons ColunaLink.png]]
 +
| Propriedade usada para configurar Links na coluna.
 +
|---------------------------------
 +
| [[Arquivo:Client Consulta Buttons ColunaSoma.png]]
 +
| Propriedade usada para configurar totalizadores na coluna. Para saber mais: [[Consulta:Totalizadores da Grid|Totalizadores da Grid]].
 +
|---------------------------------
 +
| Conversão
 +
| Converte os dados da coluna antes de exibir no LATROMI Web. Atualmente, a única formatação disponível é do formato '''RTF''' para '''Texto Plano'''.
 +
|---------------------------------
 +
| Fonte
 +
| Opções de Formatação de Texto. Para saber mais: [[Formatação de Texto]].
 +
|---------------------------------
 +
| Tipo .NET
 +
| Tipo de dados do Microsoft .NET. Esta propriedade não por de ser alterada, e exibe o resultado da tradução do tipo de dados do banco de dados para o tipo de dados do .NET.
 +
Por exemplo:
 +
:: Int → System.Int32
 +
:: Bigint → System.Int64
 +
:: Varchar → System.String
 +
|}
 +
 
 +
== Disposição das Colunas ==
 +
[[Arquivo:Client Consulta DisposicaoColunas.png|miniaturadaimagem|right|Como modificar a disposição das colunas da Grid na Consulta]]
 +
A sessão de Disposição das Colunas permite que o desenvolvedor modifique a ordem e crie agrupamentos de colunas.
 +
Para modificar a disposição das colunas, siga os passos:
 +
* Na sessão ''Disposição das Colunas'', marque a opção '''Alterar disposição das colunas'''.
 +
* Configure a disposição:
 +
*: Arraste as colunas para alterar a ordem; ou
 +
*: Clique com o botão direito dou mouse para criar agrupamento, e arraste as colunas para dentro.
 +
[[Arquivo:Grid - Alterando Disposição das Colunas.jpg]]
 +
 
 +
== Ver Também ==
 +
* [[Consulta:Visão Geral]]

Edição atual tal como às 23h43min de 18 de outubro de 2018

Consultas com saída em Grid, exibem os dados de forma tabular (linhas e colunas) e possuem várias opções de configuração.

Comando SQL

Na aba Comando SQL, deve ser informado um comando que retorne dados, como SELECT ou chamadas de Funções e Stored Procedures.

Para maiores informações, consulte a página Editor de Comandos SQL.

Configurações

Na parte inferior da sessão de configurações da Grid, há uma parte que mostra a descrição da propriedade selecionada. Isso ajuda a entender para que serve cada configuração.

Tela de Configurações da Grid no LATROMI Client

Filtros

Na Grid é possível utilizar dois modos de filtros diferentes. Os filtros serão habilitados apenas para as colunas configuradas para tal.

No modo de Filtro Padrão, são exibidos no LATROMI Web campos de entrada de dados no cabeçalho das colunas. Para filtrar basta preencher este campos.

No modo de Filtro Avanaçado (também conhecido por Excel Like-Filtering), o filtro padrão (que utiliza um campo de entrada de dados no cabeçalho da coluna) será substituído por um botão, que ao clicar exibe um menu com opções avançadas para filtragem.

Tipos de Filtros da Grid no LATROMI Web

Agrupamento de Dados

O Agrupamento de Dados, como o próprio nome sugere, cria uma visão hierárquica dos dados, agrupando as informações pelas colunas selecionadas para agrupamento. Os dados podem ser agrupados em tempo de execução pelo usuário no LATROMI Web, como também podem ser pré-configurados para isso no LATROMI Client.

Configuração das Colunas

Configurações das Colunas da Grid

Sempre que o Comando SQL usado para popular os dados da Grid for confirmado no cadastro da Consulta, a sessão de 'Colunas será atualizada. Nessa sessão, existe um item correspondente para cada coluna resultante do Comando SQL, e neles é possível configurar a formatação de texto, alinhamento, formatação e comportamentos das colunas.

As configurações das Colunas estão listadas na tabela abaixo:

Propriedade Descrição
Seq. Sequência da Coluna. Não pode ser alterada.
Nome Nome da Coluna. É o mesmo nome da coluna retornada no Comando SQL. Não pode ser alterada.
Descrição Texto de Cabeçalho das Colunas.
Tipo Tipo de Dados da Coluna. Essa coluna assume o tipo correto automaticamente. Ela só precisa ser alterada manualmente para Hora quando for necessário configurar um totalizado do tipo Soma para uma coluna do tipo texto que contenha horas no formato hh’:’mm[’:’ss].

Os tipos disponíveis são: Alfanumérico, Numérico, Data e Hora.

Client Consulta Buttons ColunaVisivel.png Propriedade que torna a coluna visível ou invisível.
Client Consulta Buttons ColunaMobile.png Propriedade que torna a coluna visível ou invisível apenas em dispositivos móveis.
Client Consulta Buttons ColunaLock.png Propriedade que torna a coluna parte do grupo de colunas Fixadas.
Client Consulta Buttons ColunaFiltro.png Propriedade que habilita ou desabilita o filtro da coluna.
Client Consulta Buttons ColunaAgrupamento.png Propriedade que configurada a coluna para agrupamento de dados automaticamente ao abrir a Consulta.
Client Consulta Buttons ColunaMultiline.png Propriedade que habilita ou desabilita a renderização de quebras de linha na coluna. Essa configuração será ignorada quando a opção Exibir Quebra de Texto das configuração de Grid estiver com o valor "Para todas as Colunas".
Largura Largura da Coluna em Pixels. Se a area disponível no navegador for maior que a soma da largura de todas as colunas, o sistema vai distribuir proporcionalmente a diferença entre as colunas para que seja ocupada a largura inteira da tela.
Alinhamento Define o alinhamento da coluna. Quando as colunas são criadas, elas já assumem um alinhamento padrão conforme o tipo de dados: tipos Alfanuméricos ficam alinhados a esquerda, tipos Numéricos a direita e Datas ao centro.
Formato Formatação da coluna. Para saber mais: Formatação de Valores.
Client Consulta Buttons ColunaLink.png Propriedade usada para configurar Links na coluna.
Client Consulta Buttons ColunaSoma.png Propriedade usada para configurar totalizadores na coluna. Para saber mais: Totalizadores da Grid.
Conversão Converte os dados da coluna antes de exibir no LATROMI Web. Atualmente, a única formatação disponível é do formato RTF para Texto Plano.
Fonte Opções de Formatação de Texto. Para saber mais: Formatação de Texto.
Tipo .NET Tipo de dados do Microsoft .NET. Esta propriedade não por de ser alterada, e exibe o resultado da tradução do tipo de dados do banco de dados para o tipo de dados do .NET.

Por exemplo:

Int → System.Int32
Bigint → System.Int64
Varchar → System.String

Disposição das Colunas

Como modificar a disposição das colunas da Grid na Consulta

A sessão de Disposição das Colunas permite que o desenvolvedor modifique a ordem e crie agrupamentos de colunas. Para modificar a disposição das colunas, siga os passos:

  • Na sessão Disposição das Colunas, marque a opção Alterar disposição das colunas.
  • Configure a disposição:
    Arraste as colunas para alterar a ordem; ou
    Clique com o botão direito dou mouse para criar agrupamento, e arraste as colunas para dentro.

Grid - Alterando Disposição das Colunas.jpg

Ver Também