PV REPORT ONE

4D View v16

PV REPORT ONE


PV REPORT ONE ( area ; coluna ; linha ; master ; tabelaRuptura ; campoRuptura ; operador ; tabelas ; campos ; inserir ; detalhe ; titulo )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D View
coluna	Inteiro longo	Número de coluna
linha	Inteiro longo	Número de linha
master	Inteiro	Número de tabela primária
tabelaRuptura	Inteiro	Número de tabela onde ocorre a ruptura
campoRuptura	Inteiro	Número de campo onde ocorre a ruptura
operador	Inteiro	Operações a realizar
tabelas	Inteiro	Número de tabela do campo a mostrar
campos	Inteiro	Número do campo a mostrar
inserir	Inteiro	0 = Substituir; 1 = Inserir linhas
detalhe	Inteiro longo	Opções de inserção de detalhe
titulo	String	Título de ruptura

Descrição

O comando PV REPORT ONE cria um relatório na área 4D View utilizando os valores dos campos 4D especificados em tabelas e campos a partir da seleção atual da tabela master. Uma operação pode ser aplicada a este campo definido por operação: subtotal, número, máximo, etc. Para definir o parâmetro operação, utilize as constantes do tema PV Funções relatórios:

Constante	Tipo	Valor
pv report function average	Inteiro longo	1
pv report function count	Inteiro longo	4
pv report function max	Inteiro longo	3
pv report function min	Inteiro longo	2
pv report function none	Inteiro longo	-1
pv report function sum	Inteiro longo	0

O resultado gerado é inserido na area a partir da célula designada por linha e coluna.

tabelaRuptura e campoRuptura designam o campo onde se realiza a sequência de ruptura. As rupturas permitem separar os registros em grupos homogêneos e realizar cálculos intermediários para cada grupo.
Uma ruptura é uma mudança de valor em uma tabela de ordem. É necessário associar este nível de ruptura com um critério de ordem. A ordem da seleção de registros de tabelaRuptura e campoRuptura é necessário antes de usar o comando PV REPORT ONE. Pode ter critérios de ordem adicionais, que não serão levados em conta na ruptura. Para mais informação sobre a construção de relatórios rápidos com rupturas, consulte o Manual de Desenho 4D.

O parâmetro inserir determina se os dados localizados na área 4D View por este comando devem substituir as células que podem estar presentes ou devem ser inseridas nas novas linhas. Se passar 0, os dados são apagados e substituídos. Se passar 1, as linhas adicionais se inserem.

O parâmetro detalhe permite definir a forma em que 4D View vai inserir o detalhe, assim como as linhas de ruptura no relatório:

Se passar 0 em detalhe, só são inseridas as linhas de ruptura (as linhas de detalhe não se inserem).
Se passar 1 em detalhe, se inserem as linhas de detalhe e os valores de ruptura se repete em cada linha.
Se passar 2 em detalhe, se inserem as linhas de detalhe e os valores de rupturas se mostram uma só vez.

O parâmetro titulo permite definir o título da linha de resultados (ou seja, "Total", "Média", etc.) Igual que no Editor de relatórios rápidos de 4D, pode utilizar o caractere # como um marcador para o valor de ruptura atual. Por exemplo, se o campo "País" é seu campo de ruptura, pode passar "Total para #:" e obter "Total para USA:", "Total para Japão:", etc. Passe uma cadeia vazia se não deseja inserir um título.

Nota: Se detalhe vale 0 e o título é uma cadeia vazia, a primeira coluna não se insere (estaria vazia).

Exemplo

Mostramos em uma área 4D View uma lista de clientes, separando as mulheres e os homes e indicando para cada grupo o número de registros:

 C_LONGINT($Column) //Número da coluna

 C_LONGINT($Row) //Número da linha

 C_LONGINT($Master) //Número primário da tabela

 C_LONGINT($TableBreak) //Número da tabela onde a quebra ocorre

 C_LONGINT($FieldBreak) //Número do campo onde a quebra ocorre

 C_LONGINT($Operator) //Operação a executar

 C_LONGINT($Table) //Número da tabela dos campos a exibir

 C_LONGINT($Field) //Número dos campos a exibir

 C_LONGINT($Insert) //0=Substitui;1=Insere linhas

 C_LONGINT($Detail) //Opções de exibição de detalhes

 C_TEXT($Title) //Título da linha resultados

 

  //Initializa

 $Column:=4 //Exibe começando com a coluna C

 $Row:=3 //Exibição começa na 3ra linha (Titulo + linha vazia)

 $Master:=Table(->[Clients]) //Tabela cliente é limpa

 $TableBreak:=Table(->[Clients])

 $FieldBreak:=Field(->[Clients]Type) //Quebra no tipo de cliente

 $Operator:=pv report function count //Calcula o número de mulheres e homens

 $Table:=Table(->[Clients]) //Campos tabela clientes

 $Field:=Field(->[Clients]Name) //Imprimir nomes

 $Insert:=1 //Inserir requisição

 $Detail:=2 //Linhas detalhes são inseridas, valores são exibidos uma vez

 $Title:="Total"

 

 ALL RECORDS([Clients])

 ORDER BY([Clients];[Clients]Type;[Clients]Name) //Order by necessário na quebra + exibir alfabeticamente

 

 PV REPORT ONE(Area;$Column;$Row;$Master;$TableBreak;$FieldBreak;$Operator;$Table;$Field;$Insert;$Detail;$Title)

Ver também

PV ARRAY TO CELLS
PV REPORT MANY