Quebras

View video

Configuração das Quebras

Estas são configurações gerais para as quebras da consulta, independente do seu tipo, estática ou dinâmica. Aqui poderemos definir algumas opções de visualização das quebras, como a utilização de treeview, por exemplo.

A opção Habilitar TreeView não está disponível para paginação Scroll Infinito.

• Habilitar TreeView : Define a utilização de TreeView nas quebras, que por sua vez, permite expandir ou recolher os registros exibidos nas quebra.
• Posição da Quebra : Define o posicionamento da quebra em relação aos registros do grupo. As opções são Antes dos registros ou Após os registros.
• Cabeçalho da Quebra : Permite exibir o cabeçalho da quebra em todas as páginas.
• Ordenação com Quebra : Permite ordenar os campos respeitando as quebras.
• Exibir Label na Quebra : Permite a exibição da label dos campos dentro dos grupos.
• Título para Quantidade : Define um título para a coluna de quantidade de registros.
• Separador do Valor : Definir o separador entre o título e o valor do campo na quebra.
• Tabular quebra : Define a margem esquerda da Quebra. O valor deve ser informado em pixel.
• Dividir quebra : Define o espaçamento entre duas Quebras. O valor deve ser informado em pixel.

Quebra Dinâmica

Este tipo de quebra, possibilita que o usuário final configure a aplicação em tempo de execução, da forma que lhe convém. Os campos selecionáveis, no momento da execução da aplicação, são disponibilizados pelo desenvolvedor no ato da configuração da quebra dinâmica.

Selecionar Campos

Nesta tela definimos os campos disponíveis na quebra dinâmica e que serão totalizados na consulta e resumo, quando a quebra dinâmica for utilizada.

Esta quebra funciona independente de qualquer outra configuração de quebra ou totalização já realizada, ou seja, os campos definidos para serem totalizados na consulta ou resumo na quebra dinâmica, estarão visíveis apenas quando a quebra dinâmica for utilizada.

Poderemos visualizar todos os campos disponíveis para configuração da quebra e totalizações nos Campos da Consulta.

A opção Usar Quebra Dinâmica, ativa a quebra na aplicação em tempo de execução.

Campos utilizados na totalização da consulta devem estar configurados para serem exibidos na consulta.

• Campos da Consulta: Lista todos os campos da aplicação.
• Campos da Quebra: Define os campos que faram parte da quebra.
• Totalização da Consulta: Define os campos que farão parte da totalização da consulta.
• Totalização do Resumo:Define os campos que farão parte da totalização do resumo.

Campos da Quebra

Devemos arrastar e soltar os campos que farão parte da quebra em Campos da Quebra.

Cada campo pode ser adicionado apenas uma vez aos Campos da Quebra, com exceção dos campos tipo date e datetime.

Campos date e datetime

Para campos date e datetime, foram adicionados alguns intervalos de visualização, por este motivo estes campos podem ser adicionados duas ou mais vez a quebra.

Todos os campos da consulta podem ser adicionados a totalização, a única diferença serão as funções disponíveis. Campos numéricos poderão utilizar todas as funções de totalização disponíveis, já os campos não numéricos poderão utilizar apenas a contagem e a contagem distinta.

Os campos configurados nesta totalização podem ser editados em Consulta > Totalização > Campos > Quebra dinâmica

Totalização do Resumo

Os campos adicionados na totalização do resumo, estarão visíveis apenas no resumo no momento que quebra dinâmica for utilizada.

Todos os campos da consulta podem ser adicionados a totalização, a única diferença serão as funções disponíveis. Campos numéricos poderão utilizar todas as funções de totalização disponíveis, já os campos não numéricos poderão utilizar apenas a contagem e a contagem distinta.

Os campos configurados nesta totalização podem ser editados em Resumo > Campos > Quebra dinâmica

Campos

Os campos adicionados aos Campos da quebra serão listados dentro da pasta Campos, para que possam ser editados individualmente.

Configuração Geral

Categorias: Texto e Código de Barras

• Tipo do Dado: Define o tipo de dado do campo no html.
• Label das quebras: Define a label do campo exibido na quebra.
• Converte Letra: Capitula o texto de acordo com a opção selecionada.
  • Caixa Alta: Transforma todo texto em letras maiúsculas.
  • Caixa Baixa: Transforma todo texto em letras minúsculas.
  • Capitula primeira palavra: Transforma a primeira palavra em caixa alta ou caixa baixa, de acordo com o texto recuperado, ou seja, se o texto recuperado pela aplicação for em caixa baixa essa opção irá transformar em caixa alta apenas a primeira palavra.
  • Capitula todas as palavras: Transforma todas as palavras em caixa alta ou caixa baixa, de acordo com o texto recuperado, ou seja, se o texto recuperado pela aplicação for em caixa baixa essa opção irá transformar em caixa alta todas as palavras.
• Máscara de Exibição: Neste campo você configura uma máscara de exibição de acordo com a tabela informado em Aplicações > Consulta > Campos > Texto.
• Tipo SQL: Informa o tipo do campo no banco de dados.

Categorias: Número e Calculado

• Tipo do Dado: Define o tipo de dado do campo no html.
• Label das quebras: Define a label do campo exibido na quebra.
• Máscara de Exibição: Neste campo você configura uma máscara de exibição de acordo com a tabela informado em Aplicações > Consulta > Campos > Texto.
• Tipo SQL: Informa o tipo do campo no banco de dados.

Categorias: Especial e Data/Hora

• Tipo do Dado: Define o tipo de dado do campo no html.
• Label das quebras: Define a label do campo exibido na quebra.
• Tipo SQL: Informa o tipo do campo no banco de dados.

Configurar Lookup

Esta opção está disponível para os campos das categorias: Texto, Número, Calculado, Especial e Código de Barras.

Nesta opção, é possível configurar um lookup de exibição para os campos dos tipos citados acima.

Estão disponíveis três opções de lookup.

• Automático - O SQL deve ser montado para exibir a informação desejada. Você pode montar um sql utilizando a opção Criar select.

• Manual - Os valores que serão exibidos na aplicação são informados na interface. Deve ser informado o valor a ser exibido (Label) e o valor corespondente ao banco de dados(Valor).

• Herdar da consulta - Herda o lookup configurado no campo da aplicação.

Para mais informações sobre como utilizar o lookup de consulta, acesse Aplicações > Consulta > Campos > Texto.

Formatação dos Valores

Tipo Número

• Usar configurações regionais: Ao ativa-lo você aplica as configurações regionais para esse campo. Para configura-las você clica no menu Localidades > Configurações Regionais.
• Cor dos negativos: Neste campo você informa uma cor em hexadecimal. (Exemplo: #000000)
• Exibir valor por extenso: Ao ativa-lo a aplicação exibirá o valor por extenso do campo. (Exemplo: dois)
• Tamanho da Linha: Informe o tamanho da linha da célula. A unidade do valor será de acordo com a unidade colocada em Configurações > Unidade de medida do PDF.

Tipo Moeda

• Usar configurações regionais: Ao ativa-lo você aplica as configurações regionais para esse campo. Para configura-las você clica no menu Localidades > Configurações Regionais.
• Valor monetário: Ao ativar essa opção a aplicação irá exibir o símbolo monetário de acordo com a configuração regional.
• Cor dos negativos: Neste campo você informa uma cor em hexadecimal. (Exemplo: #000000)
• Casas decimais: Quantidade de casa decimais que o seu campo terá na exibição.
• Completa Zeros: Ao ativar essa opção a aplicação completará com zeros após a vírgula.
• Exibir valor por extenso: Ao ativa-lo a aplicação exibirá o valor por extenso do campo. (Exemplo: dois)
• Tamanho da Linha: Informe o tamanho da linha da célula. A unidade do valor será de acordo com a unidade colocada em Configurações > Unidade de medida do PDF.

Tipo Data

• Usar configurações regionais: Ao ativa-lo você aplica as configurações regionais para esse campo. Para configura-las você clica no menu Localidades > Configurações Regionais.
• Exibição: Neste campo você seleciona a forma de exibição do campo tipo data.

Configurações das Quebras

• Atributos
  • Organização dos campos : Define como as informações contidas na linha de quebra serão dispostas ou organizadas.
  • Colunas : Define em quantas colunas as informações contidas na linha de quebra serão dispostas ou organizadas.
  • Exibe label : Define se o label do campo será exibido.
  • Linha de quebra : Exibe ou não a linha de quebra com o valor a ser quebrado.
  • Linha de sumarização (Resumo) : Define se na tela de resumo a linha de totalização desta quebra será exibida.
  • Quantidade de registros : Define se na linha de quebra será exibida a quantidade de registros da mesma.
  • Quebra Página PDF (Consulta) : Define se no arquivo pdf, gerado pela consulta. Se cada vez que esta quebra ocorrer será gerada uma nova página.
    • Ex. Em um relatório podemos querer que os pedidos de cada estado serão exibidos em páginas diferentes.
  • Quebra Página PDF (Resumo) : Define se no resumo do arquivo pdf, gerado pela consulta. Se cada vez que esta quebra ocorrer será gerada uma nova página. Ex. Em um relatório podemos querer que os pedidos de cada estado serão exibidos em páginas diferentes.
  • Quebra Página HTML (Consulta) : Quebra página no HTML da consulta
  • Quebra Página HTML (Resumo) : Quebra página no HTML da Resumo
  • Iniciar TreeView : Define o estado inicial do TreeView.
  • Ordenação : Se esta opção estiver selecionada com “Sim” , os campos que estiverem marcados para permitir ordenação ao serem clicados, será feita a ordenação respeitando os critérios da quebra.
  • Campos : Define quais campos serão exibidos nesta linha de quebra. Ainda é possível dizer se será exibida a totalização ou sumarização deste campo chaveando VALOR ou SUMARIZAÇÃO, antes de clicar no botão ligar.

Configuração da Visualização do Label na Quebra

Interface Configuração da Visualização Label na Quebra.

• Atributos
  • Fonte do Texto : Permite definir a fonte utilizada no label da quebra.
  • Tamanho da Fonte : Permite definir o tamanho da fonte utilizada no label da quebra.
  • Cor do Texto : Cor do label na quebra.
  • Cor do Fundo : Cor de fundo da Quebra.
  • Texto Negrito : Permite habilitar ou desabilitar o label da quebra em negrito.

Configuração da Visualização do Campo na Quebra

Interface Configuração da Visualização (campo).

• Atributos
  • Fonte do Texto : Permite definir a fonte utilizada no Campo da quebra.
  • Tamanho da Fonte : Permite definir o tamanho da fonte utilizada no Campo da quebra.
  • Cor do Texto : Cor do label no campo.
  • Texto Negrito : Permite habilitar ou desabilitar o Campo da quebra em negrito.

Quebra Estática

Este tipo de quebra é previamente configurada pelo desenvolvedor, onde o usuário final seleciona uma das quebras disponibilizadas na aplicação.

Configurações

Estas configurações refletem apenas nas quebras estáticas.

Configurações de Agrupamentos Estáticos

• Usar Quebra vazia: Configuração usada quando desejamos que a consulta seja iniciada sem nenhuma quebra.
• Título da quebra vazia: Define um título para a opção quebra vazia. (Disponível apenas ao habilita a opção quebra vazia)
• Quebra inicial: Define a quebra que será usada no carregamento inicial da aplicação gerada.

Configuração das Regras de Ordenações

Define a ordem de exibição das quebras existentes na consulta.

Nova Quebra

Interface de criação das quebras estáticas.

• Nome: Define o nome interno da quebra, utilizado pelo Scriptcase.
• Label: Define o nome de exibição da quebra, que será exibido na aplicação.
• Campos da Consulta: Lista todos os campos da aplicação.
• Campos da Quebra: Define os campos que faram parte da quebra.
• Totalização da Consulta: Define os campos que farão parte da totalização da consulta.
• Totalização do Resumo:Define os campos que farão parte da totalização do resumo.

Campos da Quebra

Devemos arrastar e soltar os campos que farão parte da quebra em Campos da Quebra.

Cada campo pode ser adicionado apenas uma vez aos Campos da Quebra, com exceção dos campos tipo date e datetime.

Campos date e datetime

Para campos date e datetime, foram adicionados alguns intervalos de visualização, por este motivo estes campos podem ser adicionados duas ou mais vez a quebra.

Totalização da Consulta

Os campos adicionados nesta totalização, estarão visíveis apenas na consulta (caso o campo totalizado esteja visível na consulta) no momento que quebra for utilizada.

Todos os campos da consulta podem ser adicionados a totalização, a única diferença serão as funções disponíveis. Campos numéricos poderão utilizar todas as funções de totalização disponíveis, já os campos não numéricos poderão utilizar apenas a contagem e a contagem distinta.

Os campos configurados nesta totalização podem ser editados em Consulta > Totalização > Campos > Quebra dinâmica

Totalização do Resumo

Os campos adicionados na totalização do resumo, estarão visíveis apenas no resumo no momento que quebra dinâmica for utilizada.

Todos os campos da consulta podem ser adicionados a totalização, a única diferença serão as funções disponíveis. Campos numéricos poderão utilizar todas as funções de totalização disponíveis, já os campos não numéricos poderão utilizar apenas a contagem e a contagem distinta.

Os campos configurados nesta totalização podem ser editados em Resumo > Campos > Quebra dinâmica

Editar quebras

Após a criação, as quebras serão listadas dentro da pasta Quebra Estática, abaixo do item configuração.

Ao expandir a pasta da quebra, teremos ícone configuração, que ao acessar poderemos editar toda a quebra.

Ainda poderemos visualizar os campos utilizados na quebra, que podem ser editados independentes da visualização da consulta, pode poder ser visto abaixo.

Campos

Os campos adicionados aos Campos da quebra serão listados dentro da pasta Campos, para que possam ser editados individualmente.

Configuração Geral

Categorias: Texto e Código de Barras

• Tipo do Dado: Define o tipo de dado do campo no html.
• Label das quebras: Define a label do campo exibido na quebra.
• Converte Letra: Capitula o texto de acordo com a opção selecionada.
  • Caixa Alta: Transforma todo texto em letras maiúsculas.
  • Caixa Baixa: Transforma todo texto em letras minúsculas.
  • Capitula primeira palavra: Transforma a primeira palavra em caixa alta ou caixa baixa, de acordo com o texto recuperado, ou seja, se o texto recuperado pela aplicação for em caixa baixa essa opção irá transformar em caixa alta apenas a primeira palavra.
  • Capitula todas as palavras: Transforma todas as palavras em caixa alta ou caixa baixa, de acordo com o texto recuperado, ou seja, se o texto recuperado pela aplicação for em caixa baixa essa opção irá transformar em caixa alta todas as palavras.
• Máscara de Exibição: Neste campo você configura uma máscara de exibição de acordo com a tabela informado em Aplicações > Consulta > Campos > Texto.
• Tipo SQL: Informa o tipo do campo no banco de dados.

Categorias: Número e Calculado

• Tipo do Dado: Define o tipo de dado do campo no html.
• Label das quebras: Define a label do campo exibido na quebra.
• Máscara de Exibição: Neste campo você configura uma máscara de exibição de acordo com a tabela informado em Aplicações > Consulta > Campos > Texto.
• Tipo SQL: Informa o tipo do campo no banco de dados.

Categorias: Especial e Data/Hora

• Tipo do Dado: Define o tipo de dado do campo no html.
• Label das quebras: Define a label do campo exibido na quebra.
• Tipo SQL: Informa o tipo do campo no banco de dados.

Configurar Lookup

Esta opção está disponível para os campos das categorias: Texto, Número, Calculado, Especial e Código de Barras.

Nesta opção, é possível configurar um lookup de exibição para os campos dos tipos citados acima.

Estão disponíveis três opções de lookup.

• Automático - O SQL deve ser montado para exibir a informação desejada. Você pode montar um sql utilizando a opção Criar select.

• Manual - Os valores que serão exibidos na aplicação são informados na interface. Deve ser informado o valor a ser exibido (Label) e o valor corespondente ao banco de dados(Valor).

• Herdar da consulta - Herda o lookup configurado no campo da aplicação.

Para mais informações sobre como utilizar o lookup de consulta, acesse Aplicações > Consulta > Campos > Texto.

Formatação dos Valores

Tipo Número

• Usar configurações regionais: Ao ativa-lo você aplica as configurações regionais para esse campo. Para configura-las você clica no menu Localidades > Configurações Regionais.
• Cor dos negativos: Neste campo você informa uma cor em hexadecimal. (Exemplo: #000000)
• Exibir valor por extenso: Ao ativa-lo a aplicação exibirá o valor por extenso do campo. (Exemplo: dois)
• Tamanho da Linha: Informe o tamanho da linha da célula. A unidade do valor será de acordo com a unidade colocada em Configurações > Unidade de medida do PDF.

Tipo Moeda

• Usar configurações regionais: Ao ativa-lo você aplica as configurações regionais para esse campo. Para configura-las você clica no menu Localidades > Configurações Regionais.
• Valor monetário: Ao ativar essa opção a aplicação irá exibir o símbolo monetário de acordo com a configuração regional.
• Cor dos negativos: Neste campo você informa uma cor em hexadecimal. (Exemplo: #000000)
• Casas decimais: Quantidade de casa decimais que o seu campo terá na exibição.
• Completa Zeros: Ao ativar essa opção a aplicação completará com zeros após a vírgula.
• Exibir valor por extenso: Ao ativa-lo a aplicação exibirá o valor por extenso do campo. (Exemplo: dois)
• Tamanho da Linha: Informe o tamanho da linha da célula. A unidade do valor será de acordo com a unidade colocada em Configurações > Unidade de medida do PDF.

Tipo Data

• Usar configurações regionais: Ao ativa-lo você aplica as configurações regionais para esse campo. Para configura-las você clica no menu Localidades > Configurações Regionais.
• Exibição: Neste campo você seleciona a forma de exibição do campo tipo data.

Configurações das Quebras

• Atributos
  • Organização dos campos : Define como as informações contidas na linha de quebra serão dispostas ou organizadas.
  • Colunas : Define em quantas colunas as informações contidas na linha de quebra serão dispostas ou organizadas.
  • Exibe label : Define se o label do campo será exibido.
  • Linha de quebra : Exibe ou não a linha de quebra com o valor a ser quebrado.
  • Linha de sumarização (Resumo) : Define se na tela de resumo a linha de totalização desta quebra será exibida.
  • Quantidade de registros : Define se na linha de quebra será exibida a quantidade de registros da mesma.
  • Quebra Página PDF (Consulta) : Define se no arquivo pdf, gerado pela consulta. Se cada vez que esta quebra ocorrer será gerada uma nova página.
    • Ex. Em um relatório podemos querer que os pedidos de cada estado serão exibidos em páginas diferentes.
  • Quebra Página PDF (Resumo) : Define se no resumo do arquivo pdf, gerado pela consulta. Se cada vez que esta quebra ocorrer será gerada uma nova página. Ex. Em um relatório podemos querer que os pedidos de cada estado serão exibidos em páginas diferentes.
  • Quebra Página HTML (Consulta) : Quebra página no HTML da consulta
  • Quebra Página HTML (Resumo) : Quebra página no HTML da Resumo
  • Iniciar TreeView : Define o estado inicial do TreeView.
  • Ordenação : Se esta opção estiver selecionada com “Sim” , os campos que estiverem marcados para permitir ordenação ao serem clicados, será feita a ordenação respeitando os critérios da quebra.
  • Campos : Define quais campos serão exibidos nesta linha de quebra. Ainda é possível dizer se será exibida a totalização ou sumarização deste campo chaveando VALOR ou SUMARIZAÇÃO, antes de clicar no botão ligar.

Configuração da Visualização do Label na Quebra

Interface Configuração da Visualização Label na Quebra.

• Atributos
  • Fonte do Texto : Permite definir a fonte utilizada no label da quebra.
  • Tamanho da Fonte : Permite definir o tamanho da fonte utilizada no label da quebra.
  • Cor do Texto : Cor do label na quebra.
  • Cor do Fundo : Cor de fundo da Quebra.
  • Texto Negrito : Permite habilitar ou desabilitar o label da quebra em negrito.

Configuração da Visualização do Campo na Quebra

Interface Configuração da Visualização (campo).

• Atributos
  • Fonte do Texto : Permite definir a fonte utilizada no Campo da quebra.
  • Tamanho da Fonte : Permite definir o tamanho da fonte utilizada no Campo da quebra.
  • Cor do Texto : Cor do label no campo.
  • Texto Negrito : Permite habilitar ou desabilitar o Campo da quebra em negrito.

Eventos

Estes eventos estão disponíveis apenas para quebras estáticas.

O evento OnGroupByAll ocorre após a execução da quebra e nos permite a manipulação das variáveis de totalização.

As variáveis da totalização são criadas por base nos campos selecionados para a quebra e totalização.

Segue abaixo um exemplo das variáveis disponíveis:

Supondo que uma aplicação possua uma quebra por estado e cidade e duas totalizações por parcela e saldo, serão disponibilizadas as seguintes variáveis de totalização:

Para acessar as variáveis de totalização por grupo, basta substituir o nome da quebra por quebra. Exemplo: {sum_saldo_cidade} por {sum_quebra_saldo}

Exemplo:

Em uma aplicação que tenha quebras por estado e cidade e que totalize um campo saldo nos totais das quebras, desejamos exibir a média em substituição ao saldo. Cria-se um método, no evento OnGroupByAll, com o seguinte conteúdo:

{sum_quebra_saldo} = {sum_quebra_saldo} / {count_quebra};