4D Doc Center : PV REPORT ONE

4D View v14

PV REPORT ONE


PV REPORT ONE ( area ; columna ; linea ; master ; tablaRuptura ; campoRuptura ; operacion ; tablas ; campos ; insertar ; detalle ; titulo )

Parámetro	Tipo	Descripción
area	Entero largo	Área 4D View
columna	Entero largo	Número de la columna
linea	Entero largo	Número de línea
master	Entero	Número de tabla primaria
tablaRuptura	Entero	Número de tabla en donde ocurre la ruptura
campoRuptura	Entero	Número de campo donde ocurre la ruptura
operacion	Entero	Operaciones a efectuar
tablas	Entero	Número de tabla del campo a mostrar
campos	Entero	Número del campo a mostrar
insertar	Entero	0 = Remplazar; 1 = Insertar líneas
detalle	Entero largo	Opciones de inserción de detalle
titulo	Cadena	Titulo de ruptura

Descripción

El comando PV REPORT ONE crea un informe en el area 4D View utilizando los valores de los campos 4D especificados en tablas y campos a partir de la selección actual de la tabla master. Una operación puede aplicarse a este campo definido por operacion: subtotal, número, máximo, etc. Para definir el parámetro operacion, utilice las constantes del tema PV Funciones informes:

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

El resultado generado se inserta en el area a partir de la celda designada por linea y columna.

tablaRuptura y campoRuptura designan el campo donde se efectúa la secuencia de ruptura. Las rupturas permiten separar los registros en grupos homogéneos y efectuar cálculos intermediarios para cada grupo.
Una ruptura es un cambio de valor en una tabla de ordenación. Es necesario asociar este nivel de ruptura con un criterio de ordenación. El orden de la selección de registros de tablaRuptura y campoRuptura es necesario antes de usar el comando PV REPORT ONE. Puede tener criterios de ordenación adicionales, que no serán tenidos en cuenta en la ruptura. Para más información sobre la construcción de informes rápidos con rupturas, consulte el Manual de Diseño 4D.

El parámetro insertar determina si los datos ubicados en el área 4D View por este comando deben reemplazar las celdas que pueden estar presentes o deben insertarse en las nuevas líneas. Si pasa 0, los datos se borran y remplazan. Si pasa 1, las líneas adicionales se insertan.

El parámetro detalle permite definir la forma en que 4D View insertará el detalle, así como también las líneas de ruptura en el informe:

Si pasa 0 en detalle, sólo se insertan las líneas de ruptura (las líneas de detalle no se insertan).
Si pasa 1 en detalle, se insertan las líneas de detalle y los valores de ruptura se repite en cada línea.
Si pasa 2 en detalle, se insertan las líneas de detalle y los valores de rupturas se muestran una sola vez.

El parámetro titulo permite definir el título de la línea de resultados (es decir, "Total", "Promedio", etc.) Al igual que en el Editor de informes rápidos de 4D, puede utilizar el carácter # como un marcador para el valor de ruptura actual. Por ejemplo, si el campo "País" es su campo de ruptura, puede pasar "Total para #:" y obtener "Total para USA:", "Total para Japón:", etc. Pase una cadena vacía si no se desea insertar un título.

Nota: si detalle vale 0 y el título es una cadena vacía, la primera columna no se inserta (estaría vacía).

Ejemplo

Mostramos en un área 4D View una lista de clientes, separando las mujeres y los hombres e indicando para cada grupo el número de registros:

 C_LONGINT($Column) `Número de columna

 C_LONGINT($Row) `Número de línea

 C_INTEGER($Master) `Número de tabla primaria

 C_INTEGER($TableBreak) `Número de tabla donde ocurre la ruptura

 C_INTEGER($FieldBreak) `Número de campo donde ocuerre la ruptura

 C_INTEGER($Operator) `Operación a ejecutar

 C_INTEGER($Table) `Número de la tabla de campos a mostrar

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

 C_INTEGER($Insert) `0=Remplazar;1=Insertar líneas

 C_INTEGER($Detail) `Opción de visualización del cuerpo

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

 

  `Inicializa

 $Column:=4 `Visualiza a partir de la columna C

 $Row:=3 `Visualiza a partir de la tercera línea (Titulo + linea vacía)

 $Master:=Table(->[Clientes]) `Tabla de clientes arrastrada

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

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

 $Operator:=pv report function count `Calcula el número de hombres y mujeres

 $Table:=Table(->[Clientes]) `Campos de la tabla de los clientes

 $Field:=Field(->[Clientes]Nombre) `Imprimir los nombres

 $Insert:=1 `Inserción solicitada

 $Detail:=2 `Líneas de detalle insertadas, los valores se muestran una vez

 $Title:="Total"

 

 ALL RECORDS([Clientes])

 ORDER BY([Clientes];[Clientes]Tipo;[Clientes]Name) `Ordenación necesaria para ruptura + visualización por orden alfabético

 

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