Este documento describe Wparcol 2, un generador de informes para bases de datos ISIS que permite crear listados tabulares a partir de datos contenidos en bases ISIS. Wparcol 2 es una macro VBA para Microsoft Word que utiliza las bibliotecas ISIS de BIREME. Explica cómo instalar Wparcol 2, llenar la tabla de datos en Word para definir el informe, y ejecutar la macro para generar el listado. También incluye ejemplos de cómo crear informes con diferentes configuraciones.
1. Wparcol 2 – Generador de Informes
Introducción:
El presente utilitario Wparcol versión 2 es una implementación Macro VBA para WORD (97- 2000) usando
las IsisDll 32 (v7) de BIREME (www.bireme.br) y tiene como objetivo permitir la generación/impresión
de informes tabulares de datos contenidos en bases Isis tomando como "entrada de datos":
• un ARCHIVO DE MFNs (generado por el módulo de impresión de CDS/ISIS - WinIsis) o un
editor de textos (ej. NotePad), o
• un RANGO de MFNs válido para la base de datos desde donde se extraen los datos (ej. 20/200), o
• una EXPRESIÓN DE BÚSQUEDA POR DICCIONARIO válida para la base de datos a leer .
Wparcol fue pensado como un complemento a las posibilidades de impresión de Cds/Isis 3.07 y WinIsis 1.x.
El nombre del utilitario es en reconocimiento a la utilidad que me brindó PARCOL.PCD para mis
aplicaciones en la versión DOS de CDS-ISIS.
Instalación de WPARCOL 2:
El utilitario se distribuye con los siguientes archivos:
• WPARCOL2.DOC : Documento Word con la Macro. Ubicar este archivo en la carpeta
c:MisDocumentos u otra selecionada para leer el archivo desde Word.
• ISIS32V7.DLL : DLL para la lectura de las bases ISIS. Ubicar este archivo en la carpeta
c:Windows u otro que se encuentre declarada en la variable PATH.
Nota: Esta DLL es la misma isis32.dll distribuida por BIREME, que renombré para evitar
incompatiblidades con aplicaciones con DLL que aún corren en versiones anteriores a la v7.
• WPARCOL.CIP: Archivivo de parámetros para la lectura de las bases Isis. Ubicar estre archivo en
la RAIZ del disco C: .
• ILLUS.TXT: Archivo ASCII con MFNs de la base CDS. Ubicar estre archivo en la RAIZ del disco
C: .
• WPARCOL.TAB: Archivo ASCII (con estructura similar a ISISUC.TAB) que permite efectuar
búsquedas que incluyan la Ñ en la expresión. Ubicar este archivo en la carpeta donde se encuentra el
archivo ISISUC.TAB (generalmente c:winisismenu).
Consideraciones previas:
Antes de utilizar el utilitario debe tener en cuenta lo siguiente:
• Como se trata de una aplicación VBA, es necesario tener instalado MsOffice Word para poder “abrir
el archivo” WPARCOL2.DOC
• MS-Word debe permitir la ejecución de Macros.
• El utilitario “requiere” de un archivo denominado wparcol.cip, el que debe ubicarse en la raíz del
disco C:
Wparcol.cip almacenará el nombre (y camino) de las bases de datos y formatos de impresión
(.pft) que serán usados para generar los listados.
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
2. Wparcol 2 – Generador de Informes
El archivo wparcol.cip puede crearse con cualquier editor de textos y cada línea contendrá :
<nombre>=<camino+nombre>
En wparcol.cip debe declarar TODAS las bases de datos y formatos de impresión que
desee utilizar con el utilitario.
Por ejemplo:
libri.*= c:isisdatalibrilibri.*
cds.*=c:winisisdatacds.*
thes.*=c:winisisdatacds.*
forma1.pft=c:isisdatalibriforma1.pft
autor.pft=c:isisdatalibriautor.pft
titulo.pft=c:isisdatalibrititulo.pft
Observe que para declarar las bases de datos se utiliza el comodín *
NO DEJAR ESPACIOS EN BLANCO ANTES/DESPUES DEL SIGNO IGUAL.
LOS NOMBRES Y CAMINOS DEBEN SER ESCRITOS EN MINÚSCULAS
• Wparcol toma como entrada de datos las tablas diseñadas en el archivo WPARCOL2.DOC
No elimine ninguna fila/columna de esta tabla (ver más adelante como llenar la tabla).
En WPARCOL2.DOC pueden declararse una o más tablas para distintos informes.
• Si la "entrada de datos" es a través de un archivo de MFNs, la presente versión de wparcol "lee" el
archivo desde la raíz del disco C:
• Wparcol permite generar listados de hasta 5 columnas. Es MUY IMPORTANTE recalcar que si no se
utilizarán las 5 columnas con datos, DEBE insertar dos guiones (--) en el título de las columnas que no
se insertarán (ver más adelante como llenar la tabla).
• Wparcol crea un nuevo documento antes de desplegar los datos.
• La información de Encabezamiento/Pie del Listado a generar es tomada desde la última fila de la tabla a
interpretar.
• En el archivo WPARCOL.CIP debe encontrarse declarada la tabla de conversión de caracteres
ISISUC.TAB. Si en la base de datos a leer, se incluye la posibilidad de buscar palabras con Ñ, declare:
isisuc.tab=c:winisismenuwparcol.tab
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
3. Wparcol 2 – Generador de Informes
Como se llena la tabla de datos:
Base/Ancho/Alto/Orientación Nombre de la base de datos Ancho Alto Orientación
Archivo/Rango/Búsqueda Nombre del archivo de MFNs Rango de MFNs Expresión de búsqueda
Columnas 1 al 5: TITULO de la columna. ANCHO columna Formato para extracción de
Título/Ancho/Formato datos.
Encabezado/Pie Página Encabezado del Informe Pie de página del Informe
Nombre de la base de datos
El NOMBRE DE LA BASE DEBE ser indicado en minúsculas y sin extensión.
IMPORTANTE: La base a leer DEBE estar declarada en el archivo wparcol.cip
Ancho de la página
El utilitario tomará el número tipiado para asignarlo como ancho de la página a crear.
El número debe expresarse en la unidad de medida con que se configuró Word (generalmente cm.)
IMPORTANTE:Indique solo el número, no incluya la unidad de medida.
IMPORTANTE:No debe dejar esta celda en blanco.
Alto de la página
El utilitario tomará el número tipiado para asignarlo como ancho de la página a crear.
El número debe expresarse en la unidad de medida con que se configuró Word (generalmente cm.)
IMPORTANTE: Indique solo el número, no incluya la unidad de medida.
IMPORTANTE:No debe dejar esta celda en blanco.
Orientación
Inserte en esta celda una letra H si la orietación de la página será HORIZONTAL (Landscape), o
inserte una V para indicar que la orientación será VERTICAL (Portrait).
Nombre del archivo de MFNs
El utilitario leerá el nombre (y extensión) del archivo declarado desde la raíz del disco C:
El archivo esperado es en formato ASCII y cada línea contiene un número de registro válido para la
base a leer.
IMPORTANTE: Si no se leerán los datos desde un ARCHIVO, tipiar dos guiones (--) en este campo.
Rango de MFNs
El utilitario espera un rango válido para la base de datos a leer.
El rango válido debe ser declarado separando los límites mediante una barra inclinada. Ej: 110/130
IMPORTANTE: Si no se leerán los registros mediante un rango, tipiar dos guiones (--) en este
campo.
Expresión de búsqueda
El utilitario espera una expresión de búsqueda por diccionario válida para CDS/ISIS.
IMPORTANTE: Si no se recuperarán los datos mediante una expresión de búsqueda, tipiar dos
guiones (--) en este campo.
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
4. Wparcol 2 – Generador de Informes
Título de la columna.
El utilitario tomará el texto tipiado para asignarlo como título de la columna.
El tipo de letra y color de la letra con que se declare el texto, será el que se aplique a toda la
columna en el listado a crear.
IMPORTANTE: Para indicar el fin de la declaración de columnas, tipiar dos guiones (--) en este
campo.
ANCHO columna
El utilitario tomará el número tipiado para asignarlo como ancho de la columna.
El número debe expresarse en la unidad de medida con que se configuró Word (generalmente cm.)
IMPORTANTE: Indique solo el número, no incluya la unidad de medida.
Formato ISIS para extracción de datos
El utilitario tomará el texto tipiado y lo interpretará como un formato de impresión válido para
CDS/ISIS.
Se puede declarar un formato existente, indicando @nombre o “armar” el formato directamente en
esta celda, por ej: v100^a, ", "v100^n
El formato de impresión a interpretar debe responder a las especificaciones del Lenguaje de
Formateo de ISIS y las "Extensiones al Lenguaje” desarrolladas por Bireme
(www.bireme.br/format/E/fmt34E.htm).
IMPORTANTE: Si la columna debe aparecer vacía, indique esto insertando ' ' (apóstrofe blanco
apóstrofe )
IMPORTANTE:Para insertar los apóstrofes, recuerde que Word debe tener desactivada la opción
"reemplazar comillas rectas por tipográficas" en el menú Herramientas/Autocorrección.
Encabezado/Pié de página
El utilitario tomará el texto tipiado es esta fila y lo interpretará como Encabezado y Píe de página del
listado a crear.
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
5. Wparcol 2 – Generador de Informes
Como se ejecuta Wparcol
Una vez completada la tabla, para ejecutar la macro:
1. Ubique el cursor en la Fila1/Columna1 de la Tabla a interpretar (Base/Ancho/Alto/Orientación)
2. Seleccione Herramientas/Macro/Macros (o presione Alt+F8) y ejecute la macro wparcol
3. Imprima o almacene el listado generado y regrese a Wparcol2.doc
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
6. Wparcol 2 – Generador de Informes
Ejemplos:
1. Emitir un informe con los datos contenidos en los primeros 20 registros de la base CDS.
• La información a desplegar es:
Columna 1: Título de la Obra (en Azul, Arial 10 ptos. )
Columna 2: 1er. Autor (en Rojo, Tahoma, 12 ptos.)
Columna 3: Otros Autores (Verde, Times, 10 ptos.)
Tamaño de la Hoja: Ancho: 27,90 cm.; Alto: 21,60 cm.
Orientación: Horizontal (Landscape)
• El archivo wparcol.cip, ubicado en la raíz del disco c: debe contener:
cds.*=c:winisisdatacds.*
• La tabla en WPARCOL2.DOC debe contener:
Base/Ancho/Alto/Orientación cds 27,90 21,60 h
Archivo/Rango/Búsqueda -- 1/20 --
1: Título/Ancho/Formato Título de la Obra 12,40 Mhl,v24
2: Título/Ancho/Formato Autor Principal 6,20 V70[1]
3: Título/Ancho/Formato Otros Autores 6,20 V70[2..LAST]+| - |
4: Título/Ancho/Formato -- -- --
5: Título/Ancho/Formato -- -- --
Encabezado/Pie Página Listado de Obras en CDS Informe preliminar
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
7. Wparcol 2 – Generador de Informes
2. Emitir un informe con los datos de la base CDS de obras que posean ilustraciones (campo v30^b:'illus').
• La información a desplegar es:
Columna 1: Datos de la Obra (Arial, 12 ptos.)
Columna 2: Controlado por (Arial, 12 ptos.)
Tamaño de la Hoja: Ancho: 21,60 cm.; Alto: 27,90 cm.
Orientación: Vertical (Portrait)
• El archivo wparcol.cip, ubicado en la raíz del disco c: debe contener
cds.*=c:winisisdatacds.*
• Este tipo de búsquedas de información que no se encuentra en el diccionario de datos NO ES
POSIBLE realizarla "directamente" desde wparcol, para ello podemos utilizar WinISIS o ISIS
3.07 para generar un archivo ASCII (opcionalmente puede usar MX).
Desde WinISIS seguir los siguientes pasos:
1. Abrir la base CDS
2. Ejecutar la "búsqueda libre": ? v30^b:'illus'
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
8. Wparcol 2 – Generador de Informes
3. Desplegar el resultado de búsqueda
4. Desde el módulo de impresión indicar
a. Formato de Impresión: mfn/
b. Imprimir en Archivo DOS
Al final de este proceso debe existir un archivo c:ilus.txt conteniendo los MFN de los registros que
responden a la búsqueda.
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
9. Wparcol 2 – Generador de Informes
• Generado el archivo de MFN, ahora desde WPARCOL2.DOC completar la tabla:
Base/Ancho/Alto/Orientación cds 21,60 27,90 v
Archivo/Rango/Búsqueda Ilus.txt -- --
1: Título/Ancho/Formato Datos de la Obra 12,6 @cds
2: Título/Ancho/Formato Controlado por 3,10 ''
3: Título/Ancho/Formato -- --
4: Título/Ancho/Formato -- -- --
5: Título/Ancho/Formato -- -- --
Encabezado/Pie Página Listado de Obras en CDS con Informe preliminar
ilustraciones
3. Emitir un informe de las obras que se encuentran en la base de datos CDS cuyos autores sean SIOLI,
HAROLD o MIKHAILOV, V.N.
La información a desplegar es:
Columna 1: Título de la Obra (en Azul, Arial 10 ptos. )
Columna 2: 1er. Autor (en Rojo, Tahoma, 12 ptos.)
Columna 3: Otros Autores (Verde, Times, 10 ptos.)
Tamaño de la Hoja: Ancho: 27,90 cm.; Alto: 21,60 cm.
Orientación: Vertical (Portrait)
El archivo wparcol.cip, ubicado en la raíz del disco c: debe contener:
cds.*=c:winisisdatacds.*
Esta búsqueda, al tratarse de información que se encuentra en el diccionario de términos de la
base de datos, se puede efectuar directamente desde WPARCOL2.DOC, sin abrir WinIsis.
Base/Ancho/Alto/Orientación cds 21,59 35,56 v
Archivo/Rango/Búsqueda -- -- SIOLI, HAROLD +
MIKHAILOV$
1: Título/Ancho/Formato Título de la Obra 4 Mhl,v24
2: Título/Ancho/Formato Autor Principal 3,20 V70[1]
3: Título/Ancho/Formato Otros Autores 3,20 V70[2..LAST]+| - |
4: Título/Ancho/Formato -- -- --
5: Título/Ancho/Formato -- -- --
Encabezado/Pie Página Listado de Obras en CDS Informe preliminar
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA
10. Wparcol 2 – Generador de Informes
Otros ejemplos:
• Emitir listados que involucren a campos en más de una base de datos:
Esto es posible utilizando las funciones REF y REF(L()) de Cisis Extensions de Bireme (cuidado: no
se implementan igual que en winISIS 1.4)
Por ejemplo, para consultar la base ALU desde la lectura de la base MOVIM (por ejemplo para
obtener un listado de morosos de préstamos), el formato de extracción de datos es:
if p(v4) and (f(val(date),1,0) > v4) then REF(['alu']L(['alu']v2),v2/|Tel: |v4/|E-mail: |v7) fi
Las bases MOVIM y ALU deben ser declaradas en el archivo WPARCOL.CIP para poder ser
accedidas por el utilitario.
FIN DEL MANUAL DE WPARCOL2
Autor: Luis Alberto Olguín lolguin@iinfo.unsj.edu.ar
Instituto de Informática – Facultad de Ciencias Exactas Físicas y Naturales
Universidad Nacional de San Juan - ARGENTINA