Pagina principal del proyecto BasesPágina general de consultasOtros enlacesInformación Técnica

Información Técnica

Centro de Documentación Instituto Luis Carlos Galán Búsquedas en CD Instituto Luis Carlos Galán Información Técnica

Estructura de la base de datos

Sistema utilizado

Programas requeridos

Instalación de Websis

.Configuración de Websis

Instalación de CDS/ISIS

Instalación del formulario de búsqueda

Ventajas

Desventajas

Estructura de la base de datos

A continuación se presenta la estructura de la base de datos según el archivo de definición de campos de Isis:

W:ILCG DILCG
F:ILCG
S:ILCG
***

ISBN 20 80 0 0
ISSN 22 20 0 0
Número de Clasificación 92 40 0 0
Autor Personal abcd 100 240 0 0
Autor Corporativo Institucional 110 320 0 1
Autor Congreso-Conferencia 111 320 0 1
Título y Subtítulo ab 245 320 0 0
Tipo Publicación 246 12 0 0
Edición 250 160 0 0
Pie de Imprenta abc 260 240 0 0
Descripción Física Material ab 300 240 0 0
Nombre de la Serie 440 160 0 0
Notas Generales y de Contenido 500 720 0 0
Descriptores 600 240 0 1
Número, Fecha, Volumen Seriada ab 650 1650 0 0
Autores Secundarios ab 700 400 0 1
Número de Ejemplares 750 5 2 0
Forma de Adquisición 4000 40 0 0
Valor 4010 15 2 0
Canje con 4020 80 0 0
Donado por 4030 160 0 0

Sistema utilizado

Para el montaje de la base de datos del Centro de Documentación del Instituto Luis Carlos Galán se utilizó la interface Websis desarrollada por The Infocentre.  Websis es una aplicación CGI que permite acceder a bases de datos CDS/ISIS a través de Internet.

Se encuentra disponible la versión Websis 3.0 para Linux y para FreeBSD 2.2.2. El programa consta básicamente de un archivo de configuración (cds.cfg) y un archivo ejecutable (websis) que realiza la consulta en la base de datos.

Usted también puede copiar la versión de Websis 3.0 para Linux desde nuestro servidor.

Programas requeridos

Servidor Web. El servidor Web utilizado en este ejercicio es Apache. Cerciórese de instalar Apache con su distribución de Linux. Tenemos en nuestro servidor una copia del manual de uso de Apache en inglés.

CDS/ISIS. Desarrollado por Unesco. Websis solamente funciona si CDS/ISIS está instalado en su servidor. La versión del programa para Linux puede bajarse de: ftp://ftp.unesco.org/pub/winisis/unix.

Instalación de Websis

Una vez obtenido el archivo websis30.linux.tgz, este debe ser descomprimido en un directorio temporal. Una vez creado el directorio temporal descompacte el paquete así:

gunzip websis30.linux.tgz
y
tar -xvf  websis30.linux.tar

Una vez descomprimidos los archivos de instalación, el directorio debe contener los siguientes archivos:

readme.txt

Archivo de información general.

INSTALLATION

Contiene todos los pasos a seguir en la instalación.

websis

Archivo ejecutable de Websis3.00.

SYSPAR.PAR

Ejemplo del archivo SYSPAR.PAR para CDS/ISIS.

WEBSIS.PCD

Programa en Pascal para Websis.

cds.cfg

Ejemplo del archivo de configuración de Websis, para la base de datos de Unesco.

CDSTI.PFT

Ejemplo del archivo de impresión en formato corto para la base de datos de Unesco.

CDSFU.PFT

Ejemplo del archivo de impresión en formato largo para la base de datos de Unesco.

cds.html

Ejemplo de formulario en HTML para consultar bases de CDS/ISIS con Websis.

El primer paso es copiar el archivo websis en el directorio cgi-bin de su servidor. Usualmente el directorio CGI se encuentra en "/usr/local/etc/httpd/cgi-bin"

Luego debe crear un archivo con extensión cfg para cada una de las bases que desea consultar. Puede utilizar como base el archivo cds.cfg que se encuentra en la distribución de Websis. Es conveniente utilizar el nombre de la base de datos para identificar más fácilmente los archivos. Por ejemplo, ens.cfg para nuestra experiencia.  La información acerca de la configuración de los archivos .cfg para Websis, la encontrará en Configuración de Websis.

Elabore un archivo llamado SYSPAR.PAR para CDS/ISIS y ubíquelo en su directorio cgi-bin. Si lo desea puede modificar el archivo SYSPAR.PAR que viene con la distribución de Websis de acuerdo a la instalación de CDS/ISIS realizada en su servidor.

Copie el archivo WEBSIS.PCD en el directorio de programas (prog) de su instalación de CDS/ISIS. Este directorio está definido en el campo 1 del archivo SYSPAR.PAR.

La distribución de Websis contiene los archivos CDSTI.PFT y CDSFU.PFT que pueden utilizarse como modelo para diseñar los formatos de salida de datos de su base de datos. Los archivos que Usted genere deberán quedar instalados en el directorio de datos (data) de su instalación de Isis. Este directorio esta definido en el campo 5 del archivo SYSPAR.PAR. El archivo CDSTI.PFT muestra un ejemplo del formato de salida para mostrar el título del documento y el archivo CDSFU.PFT muestra el registro completo. No olvide que puede copiar estos archivos y darles el nombre de su base de datos de tal modo que sean fáciles de reconocer en el directorio de datos de CDS/ISIS, los cual se analizarán más detenidamente en Configuración de Websis.

.Configuración de Websis

El archivo de configuración es la parte más importante en Websis. En él se puede determinar el modo de presentación de la salida de registros de su base de datos, el idioma en el cual se presenta la información y llegar incluso a poder combinar diferentes idiomas en la presentación de la base de datos.

Cada archivo de configuración debe tener un nombre diferente por cada base (o por cada presentación) que utilice por medio de Websis.

En el archivo de configuración existen parámetros de una sola línea y parámetros multilínea en los cuales puede colocar toda la información que requiera. A continuación se explicarán los parámetros que deben ser configurados en su archivo .cfg :

Parámetro WebsisMode

#Defines Websis mode. Please see INSTALLATION file for #details.
WebsisMode 0

Aunque en el archivo de ayuda para la instalación, INSTALLATION, del paquete original viene información acerca del modo en el que se muestran los resultados, la experiencia nuestra con la base de datos de la Escuela Nacional  Sindical y el Centro de Documentación del Instituto Luis Carlos Galán, nos demostró las siguientes funciones del parámetro WebsisMode:

Este campo puede tomar 4 valores (0, 1, 2 y 3).

WebsisMode=0. Si asigna 0 puede utilizar operadores lógicos (and, or y not) en sus consultas y puede seleccionar varios ítems en la primera entrega de resultados.

WebsisMode=1. Si esta variable toma el valor 1 puede utilizar conectores lógicos, pero no podrá seleccionar varios ítems en la primera entrega de resultados sino que tendrá que consultarlos uno por uno.

WebsisMode=2. Al asignar el valor 2 tendrá la oportunidad de seleccionar múltiples resultados pero no podrá utilizar conectores lógicos, es decir si incluye la palabra and en sus claves de búsquedas Websis buscará los registros que contengan la palabra and.

WebsisMode=3. El valor 3 es igual que el anterior pero sin la posibilidad de realizar una selección múltiple de resultados.

Parámetro ISISDir

#Directory name where CDS/ISIS is installed.
ISISDir /isis/

En este campo debe colocar la ubicación en su servidor del programa CDS/ISIS

Parámetro ISISDbName

#Name of ISIS database to be accessed using this configuration file.
ISISDbName cds

Nombre de la base de datos que será consultada por este archivo de configuración a través de Websis

Parámetro DisplayLimit

#Maximum number of search results Websis will display.
DisplayLimit 300

Número máximo de resultados que serán mostrados al usuario en una consulta. Websis muestra los resultados de consulta en grupos de 20 ítems.

Parámetro NoSearchString

#Message to display if user tries to search without search #string.
NoSearchString <b><center>You have not entered any search words!<br><font color="#008080">Please type something to search and try again.</font></b></center>

Mensaje que es enviado si el usuario intenta hacer una búsqueda sin palabras claves. Este NO es un campo multilínea, por ello debe colocar todo el mensaje en una sola línea.

Parámetro NoTruncate

#Message to display if user just type $ to truncate without search #string.
NoTruncate <b><center>Right truncation without search word!<br><font color="#008080">Please truncate after a few search characters.</font></b></center>

Mensaje que es enviado si el usuario intenta realizar una búsqueda utilizando solamente el comodín $ para truncar términos. Este NO es un campo multilínea, por ello debe colocar todo el mensaje en una sola línea.

Parámetro MaxLimitMessage

#Message for maximum display limit.
MaxLimitMessage Display limited to first

Mensaje que se muestra si el número de ítems encontrados supera el establecido en el parámetro DisplayLimit.

Parámetro SearchFound

#Message string for successful search results.
SearchFound <b>documents found from your search</b>

Línea que informa si el resultado de una búsqueda ha tenido éxito.

Parámetro SearchNotFound

#Message string for unsuccessful search results.
SearchNotFound <b>Sorry, no documents found from your search</b>

Línea que informa si el resultado de una búsqueda no ha tenido éxito. Este NO es un campo multilínea, por ello debe colocar todo el mensaje en una sola línea.

Parámetro SummaryPageAttr

#Screen attributes for Summary Page.
SummaryPageAttr bgcolor="#ffffff" text="#0000ff" link="#0000ff" vlink="#ff0000"

Este parámetro determina los atributos de la primera página de entrega de resultados (Formato corto). Estos atributos son los mismos que se incluyen normalmente en el tag <BODY>. Este NO es un campo multilínea, por ello debe colocar todo el mensaje en una sola línea.

Parámetro SummaryPageHeader

#Header for Summary Page. This is multi line parameter.
<SummaryPageHeader>
<center>
<font color="#0000ff">
<b>Please Change This to Whatever You Think Right<br>
You Are The BOSS!</b>
</font>
</center>
</SummaryPageHeader>

Esta variable define el encabezado de la página que muestra los resúmenes de los ítems encontrados. Este es un parámetro multilínea en el que Usted tiene todo el espacio determinado por las dos líneas en negrilla para escribir, en código HTML, la forma en que se verá este encabezado.

Parámetro DisplayPagesMessage

#Message to be displayed alongside pages of display.
DisplayPagesMessage Displaying page

Mensaje que indica la página que se está mostrando. Recuerde que Websis muestra los resultados en grupos de 20 registros.

Parámetro DisplaySelectTab

#Label string for multiple documents display tab.
DisplaySelectTab Display Selected Documents

Mensaje del botón utilizado para desplegar los datos cuando se utiliza   múltiple selección de resultados.

Parámetro DisplayClearTab

#Label string for multiple documents clear tab.
DisplayClearTab Clear Selections

Mensaje del botón utilizado para desmarcar los ítems seleccionados cuando se utiliza la  selección múltiple de resultados.

Parámetro SelectionMessage

#Message for selection of multiple documents display.
SelectionMessage <b>Please select title check boxes to display multiple documents.</b>

Mensaje que aparece para indicar que el usuario debe marcar las casillas si desea ver los resultados de un grupo de documentos. Este NO es un campo multilínea, por ello debe colocar todo el mensaje en una sola línea.

Parámetro NoSelectionMessage

#Message to display if user displays records without selection.
NoSelectionMessage <center><b>You have not selected records!<br><font color="#008080">Please select records first before display.</font></b></center>

Mensaje que aparece si el usuario solicita ver un grupo de documentos sin haber seleccionado alguno. Este NO es un campo multilínea, por ello debe colocar todo el mensaje en una sola línea.

Parámetro SummaryPft

#Display PFT to be used for Summary Page.
SummaryPft cdsti

Nombre del archivo que contiene el formato de impresión, con extensión pft, que muestra el resumen de documentos encontrados. Este archivo debe estar en el directorio DATA de su instalación de CDS/ISIS.

Parámetro SummaryPageFooter

#Message to be displayed after displaying summary of search results.
SummaryPageFooter <center><b>End of List</b></center>

Esta variable contiene la información que va al final de la muestra resumida de resultados.

Parámetro SummaryPageNotes

#Notes to be displayed at the end of the summary page. Multiline parameter.
<SummaryPageNotes>
<br>
<center>
<b>This is additional notes from you.</b>
<br>
You can enter here additional information that you want
your users to know.
<br>
I hope that you like it!
</center>
</SummaryPageNotes>

Notas que van al final de la página que muestra el resumen de los documentos encontrados. Este es un parámetro multilínea en el que Usted tiene todo el espacio determinado por las dos líneas en negrilla para escribir, en código HTML, la forma en que se verá este pie de página.

Parámetro DisplayPageAttr

#Screen attributes for display page.
DisplayPageAttr bgcolor="#ffffff" text="#0000ff" link="#0000ff" vlink="#ff0000"

Atributos de la página que muestra los resultados completos, estos son los mismos atributos que se incluyen normalmente en el tag <BODY>. Este NO es un campo multilínea, por ello debe colocar todo el mensaje en una sola línea.

Parámetro DisplayPageHeader

#Header for display page. This is multi line parameter.
<DisplayPageHeader>
<center>
<b>Please Change This to Whatever You Think Right<br>
You Are The BOSS!</b>
</center>
<br>
</DisplayPageHeader>

Esta variable define el encabezado de la página que muestra la información completa de los ítems encontrados. Este es un parámetro multilínea en el que Usted tiene todo el espacio determinado por las dos líneas en negrilla para escribir, en código HTML, la forma en que se verá este encabezado.

Parámetro DisplayPft

#Display PFT to be used for display page.
DisplayPft cdsfu

Nombre del archivo que contiene el formato de impresión, con extensión pft, de la página que muestra la información completa de los documentos encontrados. Este archivo debe estar en el directorio DATA de su instalación de CDS/ISIS.

Parámetro DisplayPageFooter

#Message to be displayed after displaying selected records.
DisplayPageFooter <center><b>End of Display</b></center>

Esta variable contiene la información que va al final de la muestra completa de resultados.

Parámetro DisplayPageNotes

#Notes to be displayed at the end of display page. Multiline parameter.
<DisplayPageNotes>
<br><br>
<center>
<b>This is additional notes from you.</b>
<br>
You can enter here additional information
that you want your users to know.
<br>
I hope that you like it!
</center>
</DisplayPageNotes>

Notas que van al final de la página que muestra la información completa de los documentos encontrados. Este es un parámetro multilínea en el que Usted tiene todo el espacio determinado por las dos líneas en negrilla para escribir, en código HTML, la forma en que se verá este pie de página.

Si desea ver nuestro archivo de configuración utilizado en la base de datos de la Escuela Nacional Sindical puede obtenerlo en el siguiente enlace.

Instalación de CDS/ISIS

Este programa corre bajo Linux solamente con el emulador iBCS2, por lo que es necesario cargarlo como un módulo (lo más recomendable es cargarlo en el momento de iniciar Linux). En nuestro servidor lo instalamos utilizando el archivo /etc/rc.d/rc.ibcs2 el cual se ve así en nuestro servidor:

#!/bin/sh
#
echo "Loading the iBCS module..."
/sbin/insmod iBCS


Si no se carga el módulo iBCS, CDS/ISIS no se podrá ejecutar.

A continuación se realiza un resumen de la instalación de CDS/ISIS para Linux. El texto acá presentado fue elaborado tomando como base el siguiente documento:

ftp://ftp.unesco.org/pub/winisis/unix/readme.txt

Exceptuando el sistema operativo la versión UNIX de CDS/ISIS es idéntica y completamente compatible con la versión 3.0 para MSDOS.

Una vez copiado el archivo cds-isis.tar en su servidor descompáctelo utilizando:

tar xvf cds-isis.tar

El sistema quedará ubicado en los siguientes directorios:

Isis   (archivo READ.ME)
Isis/menu   (menús y lugares de trabajo)
Isis/msg   (archivo de mensajes)
Isis/data   (ejemplos de bases de datos)
Isis/prog   (ejemplos de programas en PASCAL)
ore   (archivos ejecutables de isis y sistema de utilidades doscopy)

Restricciones del sistema

Terminales

El único tipo de terminal soportado por esta versión es VT100 o una terminal compatible. Si el sistema es usado con otra terminal, el usuario puede observar la aparición de caracteres extraños en el monitor, las cuales son de hecho secuencias de escape de VT100 no reconocidas por la terminal. Por ejemplo, si utiliza un emulador de terminal, algunas teclas de función pueden no responder del modo esperado si el emulador transmite la correspondiente secuencia de escape VT100.

Usted debe tener a la vez cuidado con los cambios que hace CDS/ISIS sobre las
características de la terminal mientras que se encuentra trabajando. Estos son restaurados a sus valores iniciales cuando CDS/ISIS termina normalmente. Si,  por cualquier circunstancia, CDS/ISIS termina de un modo anormal (por ejemplo en el caso de una condición de error durante la ejecución no verificada por Pascal), entonces la terminal puede no reiniciarse apropiadamente. En particular, no existirá eco en los caracteres escritos en el monitor. Para solucionar este problema, debe entrar el siguiente comando:

    stty sane

Note que, debido al hecho de que el eco en los caracteres esta suprimido, no verá el comando mientras lo escribe, pero la terminal se comportará normalmente una vez que el comando es ejecutado. Adicionalmente, usted debe crear un pequeño script en el shell al correr CDS/ISIS en el que se incluya lo siguiente:

    isis
    stty sane

La versión adquirida colocará el monitor en el modo 'Texto oscuro, fondo brillante'. Si usted prefiere trabajar en el modo 'Texto brillante, fondo oscuro', debe reiniciar el atributo standard de CDS/ISIS -2 (con la opción ISISUTL en A) a 0/1. Un 0/7 cambiará el monitor otra vez al modo 'Texto oscuro, fondo brillante'. Note que al salir CDS/ISIS dejará el monitor de acuerdo a como haya quedado el atributo -2.

Nombres de archivos.

Todos los nombre de archivos en CDS/ISIS deben estar en mayúscula, de otro modo no serán reconocidos. Sin embargo, los nombres de los directorios pueden estar tanto en mayúscula como en minúscula. En SYSPAR.PAR y en dbn.PAR usted debe colocar el nombre de los directorios en minúsculas si los ha definido en minúsculas. Si CDS/ISIS reporta que no encuentra un archivo o una base de datos, la razón puede ser, probablemente, un problema con nombres de archivos que no empiezan en mayúsculas o que se encuentra en modo incorrecto el nombre del directorio.

Bloqueo de la base de datos.

El bloqueo de los archivos y de los registros esta completamente soportado y esta implementado como en la versión 3.0 para MSDOS de CDS/ISIS. Como en esta versión, usted debe recordar que en caso de una terminación anormal, los bloqueos no serán removidos automáticamente. La opción R de el menú ISISDEF esta provista para remover bases de datos y registros bloqueados cuando esta situación ocurre.

Transferencia de bases de datos desde la versión CDS/ISIS para MSDOS

Para transferir bases de datos desde la versión CDS/ISIS para MSDOS, proceda del modo siguiente:

1. Exporte la base de datos utilizando la versión PC.

2. Copie el archivo ISO en UNIX utilizando las utilidades normales del sistema provistas en el sistema UNIX (especifique la opción que suprime el retorno de carro  (ASCII 13) en el final de cada línea); también puede utilizar la utilidad del sistema doscopy provista en el paquete). En nuestra experiencia transferimos todos los archivos a nuestro servidor utilizando protocolo ASCII y no tuvimos que utilizar doscopy.

3. Copie del mismo modo todos los archivos ASCII de la base de datos:
*.PFT,  *.FMT,  *.FST, *.ANY, *.STW;

4. Llame a la versión UNIX;

5. Seleccione la opción DE en el menú principal (No trate de abrir la base de datos en esta etapa);

6. Seleccione la opción I del menú de definición de bases de datos y entre el nombre de la base de datos en este punto (ISIS creará entonces un maestro vacío y el archivo invertido).

7. Importe el archivo producido en el paso 2;

8. Regenere el archivo invertido (opción F del menú de servicios del archivo invertido).

Usted deberá poder ejecutar todas las funciones de CDS/ISIS en este momento. Si no funciona adecuadamente Websis no podrá ejecutarse, revise toda la configuración del sistema.

Problemas

Los problemas con la versión UNIX debe ser reportados a:

Mr. G Del Bigio
Programme Manager
Division of Information and Informatics
UNESCO
1, rue Miollis
75015 Paris
France
E-mail: g.delbigio@unesco.com

Instalación del formulario de búsqueda

La instalación de Websis 3.0 viene con un formulario de búsqueda llamado cds.html que sirve como base para la creación de su formulario de búsqueda.

Lo único que se debe tener en cuenta es cambiar el valor del parámetro from y asignarle el nombre dado al archivo de configuración, .cfg de su base de datos, en nuestro caso el formulario se llama ilcg.cfg:

<input type="hidden" name="from" value="ilcg">

Puede consultar en el formulario de búsqueda de la Escuela Nacional Sindical en:  http://bases.colnodo.org.co/enals/busqueda.html.

Si ha colocado el archivo ejecutable websis, que viene en la instalación, en una carpeta de su directorio cgi-bin, tenga en cuenta de modificar el valor del parámetro action del tag <FORM>.

Ventajas

Es una herramienta muy sencilla de instalar y de configurar.

Puede presentar la  información de un grupo de documentos en una sola página

Presenta una interface en la cual es muy fácil orientarse para la consulta de resultados.

Desventajas

Aunque es posible determinar hasta cierta parte la configuración de la pagina de resultados, Websis decide ciertas formas de presentar los resultados, tales como la numeración de las páginas.

No es posible seleccionar los campos en los cuales se realizará la búsqueda sino que depende del diccionario de términos definido en Isis.

No encontró la información que buscaba?, tiene comentarios?, contáctenos!