Acerca de este documento.
A partir de la versión 5.3.3 de Rpv Reports se incorporan nuevas posibilidades para la integración de la herramienta a proyectos ya existentes de una manera muy simple y rápida.
Se recomienda ampliamente su lectura para evaluar las facilidades de Rpv Reports con listados generados a través de archivos de texto.
Acerca de los archivos TXT
Es importante tener en cuenta que los reportes a los que se refiere este artículo son aquellos informes que son generados hacia un archivo plano que luego es vaciado hacia la impresora. Este archivo plano contiene un formato simple, eventualmente contienen comandos específicos para ser reconocidos por la impresora pero no cuentan con grandes posibilidades gráficas.
A estos archivos les llamamos "archivos TXT" o "archivos de texto" y son perfectamente compatibles con el Bloc de Notas de Windows, con el Vi de Unix o con cualquier otro visor/editor de texto plano.
Posiblemente sepa que los archivos TXT no tienen ningún formato. De hecho, son sólo caracteres que son enviados a la impresora pero que no aceptan ninguna clase de efecto.
Dependiendo de la impresora que sea necesario utilizar, es posible enviar ciertos comandos (comandos escape, PCL, PJL) que le indican a la impresora qué hacer en ciertos casos. Lo que es posible usualmente con los archivos TXT es realmente limitado y los resultados variarán dependiendo de la impresora que sea utilizada.
¿Qué puede hacer Rpv en esta situación?
Simplemente imagine que está generando un archivo plano y luego, lo abre con el programa WordPad de Windows. Le da formato, asigna efectos de texto, gráficos, códigos de barras y una vez que está listo lo envía a cualquier impresora aceptada por Windows.
Esto es lo que Rpv puede hacer automáticamente.
¿Cómo hacerlo?
En primer lugar, los datos no deben ser vaciados en la impresora directamente sino hacia un archivo con extensión TXT, LST ó PRN. Esto es lo que la mayoría de los programadores hace. Sin embargo no es extraño encontrar el vaciado de los datos directamente hacia la impresora.
Los archivos TXT, LST y PRN son básicamente lo mismo. Tienen el mismo formato interno de hecho. La diferencia entre estos está dada en que Rpv los reconoce como tres extensiones distintas y permite configurarlos separadamente. De esta manera es posible asignar a los TXT un tipo de letra, a los PRN una orientación de papel distinta y a los LST alguna otra característica que los diferencie.
Existen tres modos diferentes para obtener listados gráficos a partir de archivos de texto. Estos métodos pueden ser utilizados separadamente o combinados según sea necesario.
A) Configuración de las tres extensiones
Esta acción se realizará utilizando el utilitario RpvConfig.exe o el panel de configuración de Rpv. Este utilitario gestiona el archivo RPV.INI.
B) Configuración de las tablas de conversión
Las tablas de conversión se utilizan para explicarle a Rpv que ciertas secuencias que aparecen dentro del archivo significan una determinada acción. Una vez configurada la tabla de conversión no deberían verse los caracteres que son enviados a la impresora sino el efecto deseado.
C) Insertar efectos dentro los archivos de texto
Adicionalmente es posible agregar efectos o comandos Rpv dentro de los textos de un modo muy simple. Esto permite agregar todas las características de un listado gráfico como ser: códigos de barras, imágenes, gráficos, y todos aquellos efectos que Windows acepta como ser cambios de letra, colores, subrayado, etc.
A) Configuración de las tres extensiones.
La configuración de estas extensiones es realmente sencilla. Al ejecutar el programa RpvConfig.exe se encuentra un botón llamado "Configuración de archivos", donde se verá la siguiente pantalla:
B) Configuración de la tabla de conversión.
Las tablas de conversión son archivos con extensión CNV que sirven para realizar cambios específicos en los informes.
Esta funcionalidad es de suma importancia cuando se dan las siguientes circunstancias:
1) Cuando los informes se generan desde un lenguaje basado en Ms-Dos o Unix y utilizan caracteres especiales de otros idiomas distintos del inglés. Por ejemplo las letras acentuadas y caracteres especiales del Español, Portugués, Italiano, Alemán y otros idiomas.
2) Cuando los informes que se generan contienen .secuencias escape. o comandos PCL o cualquier cadena de caracteres que le indica a la impresora un comando específico y no un texto determinado.
Un claro ejemplo de esto sería el siguiente:
Suponiendo que el comando ESC+4 signifique fuente itálica o cursiva, estos dos caracteres estarían dentro del archivo de texto pero al momento de la impresión no se verían sino que serían interpretados por la impresora.
El comando Rpv para significar letra itálica es "I=Y" (italic equals yes). Para significar esto en un archivo de conversión deberemos hacer lo siguiente:
27,52=1,73,61,89,2
¿Qué significa esto? Significa la cadena de entrada y la de salida escrita en caracteres ASCII en formato decimal donde 27 significa ESC, 52 significa el .4., 73 significa .I. para .italic., etc.
Cuando en la cadena de destino contiene comandos Rpv las llaves "{" y "}" deben ser sustituidas por los caracteres 1 y 2 respectivamente tal como se muestra en el ejemplo.
Existe también otra alternativa muy utilizada que se utiliza para hacer caso omiso a los comandos. Esto significaría .no mostrarlos. ni ejecutarlos. En ese caso, la línea más arriba se escribiría de la siguiente manera:
27,52=0
En este caso, al encontrar la secuencia 27, 52 la reemplazará con un carácter 0 lo cual dejará todo sin efecto.
Adicionalmente, es posible configurar los caracteres especiales que no sean leídos por Windows adecuadamente. Este sería el caso de la letra "Ñ" en Español por ejemplo, acentos y demás caracteres especiales.
C) Inserción de efectos dentro de un archivo de texto.
Esta es una funcionalidad nueva de Rpv Reports 5.3.3 en adelante y resulta de gran utilidad para la rápida modificación de los informes logrando excelentes resultados.
Se trata de escribir comandos Rpv entre llaves dobles en medio de los textos. De esta manera será posible {{B=Y}} colocar un texto en fuente negrita {{U=Y}} ó subrayada {{B=N;U=N}} donde resulte necesario.
En el momento que Rpv encuentre las llaves dobles no imprimirá ni mostrará la cadena que se encuentre entre las llaves dobles sino que ejecutará los comandos Rpv que se encuentren en ellas.
De esta manera es posible no sólo insertar un efecto para las fuentes dentro de un texto sino que también pueden ser agregadas imágenes, enlaces (links), códigos de barras y todo aquel comando reconocido por Rpv: líneas, saltos de página, boxes, etc.
Comandos directos
Resulta también posible insertar comandos directos dentro de un archivo TXT.
Estos comandos se utilizan básicamente para definir parámetros dentro del informe así como para definir [HEADER] y [DATA].
Para insertar un comando directo es necesario iniciar la línea con el carácter .>. (mayor que) en la primera posición de la línea.
Ejemplo:
>REPORT_TITLE=Prueba sobre listados sobre ficheros de texto
>ORIENTATION=2
>[HEADER]
>[DATA]
El resto del texto aquí .....
..............
..............
..............
Resulta importante destacar que al utilizar comandos directos para declarar parámetros como el caso que se ilustra más arriba resulta obligatorio declarar [HEADER] y [DATA], como se muestra más arriba.
Tipos de letra de ancho fijo
Si bien resulta posible insertar comandos tales como para utilizar tipos de letra de ancho variable, lo más usual es utilizar las de ancho fijo para ver los informes encolumnados adecuadamente.
Las fuentes de ancho fijo son aquellas donde todos los caracteres tienen el mismo ancho.
Por ejemplo, la fuente utilizada para imprimir este texto no es de ancho fijo. Escribiremos cinco letras "i" y debajo imprimiremos cinco "W" para corroborar la diferencia:
iiiii
WWWWW
La diferencia es abismal. Ahora bien, si utilizamos una fuente de ancho fijo el efecto será completamente diferente:
iiiii
WWWWW
Fuente utilizada: Courier New
Ejemplos
Aquí hemos colocado tres ejemplos muy simples generados a partir de un DIR en Ms-Dos que es un listado muy familiar para todos los usuarios. Cada uno con un nivel de complejidad mayor pero con mayores prestaciones.
Atención: Los ejemplos abrirán una instancia del visualizador de informes Rpv al ser seleccionados.
Ejemplo #1. Archivo TEXT_ORIGINAL.TXT
Ejemplo #2. Archivo modificado: TEXT_01.TXT
Ejemplo #3. Archivo modificado: TEXT_02.TXT
Descargar los archivos en formato ZIP para ver los archivos por dentro.
|
