El formato Rpx es el más importante de todos los formatos que son utilizados en Rpv. La herramienta Rpv Visual Editor está diseñada para trabajar con este tipo de archivos.
¿Qué es un archivo Rpx?
Un archivo Rpx es simplemente un archivo de texto que contiene datos delimitados.
Obviamente que un listado no está compuesto sólo de los datos sino que también necesita de su encabezado, leyendas, columnas, líneas, etcétera.
¿Qué sucede entonces? Sucede que dentro de un listado conseguiremos partes "fijas" y partes "variables".
Las "fijas" son las aquellas leyendas fijas, imágenes, líneas y todo lo relativo al formato del listado. Las partes "variables" en cambio son las cambiarán, como su nombre lo indica y son ni más ni menos que los datos que mostrará el informe.
Una de las características principales del trabajo con plantillas (Rpx y Rpd) es la posibilidad de omitir la programación de estos datos fijos en nuestros programas. La idea es que nuestro proceso envíe sólo datos sin formato y éstos se combinen con los datos fijos para así formar el listado.
¿Cómo funciona un archivo Rpx?
El archivo Rpx es entonces una colección de datos en un orden específico y delimitados por un caracter a elección.
Un ejemplo de esto podría ser el siguiente:
Supongamos que necesitamos hacer un listado de clientes, donde tenemos tres campos: nombre, apellido y teléfono.
Podríamos representarlos de la siguiente manera:
|Gerardo|Martinez|4441-2340|
|Rafael|Oliva|8931-1122|
|Carlos|Chaves|991-1233|
|
Aquí vemos tres registros delimitados por "pipes" que cumplen con la estructura que vimos anteriormente.
En un archivo Rpx deberemos agregarle además un identificador fijo al primer campo. Por ejemplo diremos que esta estructura se llama "registro".
Entonces, los datos quedarían representados del siguiente modo:
|registro|Gerardo|Martinez|4441-2340|
|registro|Rafael|Oliva|8931-1122|
|registro|Carlos|Chaves|991-1233|
|
La estructura entonces sería: [registro: @nombre, @apellido, @telefono]
Estos datos, con esta estructura deberá ser reconocida por la plantilla para que todo funcione.
Construyendo una plantilla para este ejemplo
Lo primero que debemos hacer es un pegar estos datos en un archivo de texto al cual llamaremos "c:\DATOSCLIENTES.RPX". Si lo hace con el Bloc de Notas, ponga especial atención en que la extensión no termine siendo TXT, ya que el Bloc de Notas la agrega automáticamente.
Contenido de C:\DATOSCLIENTES.RPX
|registro|Gerardo|Martinez|4441-2340|
|registro|Rafael|Oliva|8931-1122|
|registro|Carlos|Chaves|991-1233|
|
Obviamente, si lo desea puede agregar más líneas al archivo que cumplan con la estructura que tenemos aquí.
Una vez hecho esto, generaremos un nuevo listado con el Rpv Visual Editor y declararemos el archivo C:\DATOSCLIENTES.RPX en las propiedades del reporte a la propiedad "Sample Rpx/Rpd file"
Luego de ello, generaremos una nueva subsección seleccionando la opción de menú Edición / Nueva Subsección.
La siguiente ventana aparecerá:
En la parte inferior de la ventana encontraremos los registros que se encuentran en el archivo Rpx.
Veremos las posibilidades que nos brinda esta ventana:
Para sección: Este campo determina en qué parte del informe se incluirá la subsección que se está insertando/modificando.
Nombre: este nombre es fijo y dependerá del identificador que el programa pueda leer desde el archivo Rpx.
Comienza en pos (Y): en este campo se determina la posición vertical exacta donde debe imprimirse la subsección cada vez que ésta aparezca. Usualmente se utiliza el valor predeterminado.
Altura: define la altura de la subsección. Esta altura incide definitivamente en el largo del informe.
Subsección termina en: usualmente este valor es el mismo valor que el de la altura del informe. No obstante, este valor también puede ser menor a la altura provocando distintos efectos.
Asignar nombres de los campos
De modo predeterminado, los campos que vienen desde el archivo Rpx se llamarán @campo01, @campo02, @campo03, etc.
Si bien el listado puede funcionar sin problemas así, posiblemente sea conveniente cambiar los nombres de los campos para que éstos sean más representativos respecto del dato que contienen.
Para hacerlo simplemente se debe hacer click sobre cualquier parte de la columna que se pretende modificar de la siguiente manera.
Luego escribir el nuevo nombre del campo y presionar "definir".
Una vez definidos los nombres de los campos, al presionar el botón "Aceptar" la nueva subsección será insertada en el informe de la siguiente manera.
Insertando datos dentro la subsección:
Cualquier objeto puede ser insertado dentro de la subsección, pero le daremos énfasis especial a las etiquetas y variables.
¿Cál es la diferencia entre ambas? Ninguna en términos reales. Las variables son simples etiquetas que "son" o "contienen" en la expresión el nombre de la variable misma.
Insertaremos entonces etiquetas a través de la herramienta que se encuentra en la barra o bien presionando la combinación de teclas CTRL-T con el mouse ubicado en el lugar donde se desee incluir la etiqueta.
La diferencia práctica de insertar una variable en este caso está dada porque al hacerlo, el programa inserta una etiqueta con el nombre de la próxima variable disponible de acuerdo a la subsección.
Para hacerlo también se puede utilizar la herramienta correspondiente o bien presionar la combinación CTRL-D sobre el lugar donde se desea incluir la variable.
Insertaremos las tres variables en la subsección entonces:
En este momento ya puede verse el listado. Para hacerlo se deberá presionar F5.
Como se puede apreciar, la subsección se repite una debajo de la otra cada vez que encuentra un "registro". Si al archivo Rpx se le agregan más líneas, entonces se repetirá más veces.
El espaciado entre las líneas se debe al alto de la subsección. Como se puede ver en las ilustraciones anteriores, la subsección tiene un espacio en altura de 400 twips. Si ese espacio es reducido, entonces también se reducirá el espaciado.
Es posible modificar el alto de una subsección desde las propiedades de la subsección o bien tomando el fin de la subsección y desplazándolo.
Agregando componentes estéticos dentro del informe.
Con las herramientas de las que se dispone, se pueden crear encabezados, agregar imágenes, enlaces etc.
Hacemos, a continuación un encabezado y un pie de página en las secciones HEADER y DATA. (Recordar que tanto HEADER como FOOTER son secciones y no subsecciones y por lo tanto no dependen de información que provenga desde el fichero C:\DATOSCLIENTES.RPX)
En este caso se ha hecho lo siguiente:
En primer lugar se abrió la sección HEADER para poder incluir un encabezado más atractivo donde se incluye una imagen así como también un recuadro y una etiqueta para demostrar el número de página actual y el número total de páginas. ("Página @@pag de @@ofpag")
En la sección FOOTER también se incluye un recuadro con fecha y hora.
Presionando la tecla F5 veremos como ha cambiado el listado.
Intente agregando más registros al archivo Rpx para ver la diferencia que se produce al previsualizar el listado.
Terminando el informe y haciéndolo funcionar desde nuestro programa.
Una vez terminado el informe y pulido en cuanto a su aspecto deberemos guardar la plantilla con un nombre y con extensión RPV. En este caso le llamaremos C:\CLIENTES.RPV
Luego, deberemos agregar al archivo Rpx la ruta hacia la plantilla que se acaba de generar de la siguiente manera:
TEMPLATE=C:\CLIENTES.RPV
Donde "C:\CLIENTES.RPV" es en este caso el archivo que acabamos de salvar. Debajo de esta línea agregaremos el resto de la información quedando el archivo entonces de la siguiente manera:
Contenido de C:\DATOSCLIENTES.RPX
TEMPLATE=C:\CLIENTES.RPV
|registro|Gerardo|Martinez|4441-2340|
|registro|Rafael|Oliva|8931-1122|
|registro|Carlos|Chaves|991-1233|
|
Cómo llamarlo desde nuestro programa.
Este punto específico se realiza de distintas formas dependiendo el lenguaje de programación. En cualquier caso, el archivo que debe ser llamado es el archivo Rpx y no la plantilla. En caso de equivocarnos llamando al archivo RPV (la plantilla) veremos entonces el formulario con todos los nombre de las variables dentro.
Por ejemplo, si utilizamos Visual Basic podremos llamar al listado de la siguiente manera
Shell "c:\archivos de programa\rpv\rpv.exe C:\DATOSCLIENTES.RPX"
Desde Cobol:
CALL 'SYSTEM' USING 'rpv.exe C:\CUSTOMERSDATA.RPX'.
See also
Video Hola Mundo (Hello world).
|
