4D Doc Center : PV REPORT ONE

4D View v14

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	cadeia	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 de coluna

 C_LONGINT($Row) `Número de linha

 C_INTEGER($Master) `Número de tabela primária

 C_INTEGER($TableBreak) `Número de tabela onde ocorre a ruptura

 C_INTEGER($FieldBreak) `Número de campo onde ocorre a ruptura

 C_INTEGER($Operator) `Operação a executar

 C_INTEGER($Table) `Número da tabela de campos a mostrar

 C_INTEGER($Field) `Número de campos a mostrar

 C_INTEGER($Insert) `0=Substituir;1=Inserir linhas

 C_INTEGER($Detail) `Opção de visualização do corpo

 C_STRING(20;$Title) `Título de la linha de resultado

 

  `Inicializa

 $Column:=4 `Visualiza a partir da coluna C

 $Row:=3 `Visualiza a partir da terceira linha (Titulo + linha vazia)

 $Master:=Table(->[Clientes]) `Tabela de clientes arrastada

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

 $FieldBreak:=Field(->[Clientes]Tipo) `Ruptura no tipo de clientes

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

 $Table:=Table(->[Clientes]) `Campos da tabela dos clientes

 $Field:=Field(->[Clientes]Nome) `Imprimir os nomes

 $Insert:=1 `Inserção solicitada

 $Detail:=2 `Linhas de detalhe inseridas, os valores se mostram uma vez

 $Title:="Total"

 

 ALL RECORDS([Clientes])

 ORDER BY([Clientes];[Clientes]Tipo;[Clientes]Name) `Ordem necessária para ruptura + visualização por ordem alfabética

 

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