OpenOPAC, V3.0. Un conjunto de scripts (desarrollados en IsisScript y JavaScript) para poder consultar via Web (cliente/servidor) una base de datos ISIS como un catálogo de una biblioteca.

OpenOPAC, V3.0. A set of scripts (developed with IsisScript and JavaScript) to query via WEB (client/server) an ISIS database, as a library OPAC.

Copyright (C) 2002 Ignacio Cavalieri, Nicolas Rucks.
Contacto: openopac@bl.fcen.uba.ar
2002/12/19.

INTRODUCCIÓN
SOFTWARE NECESARIO
SOFTWARE UTIL
FUNCIONAMIENTO GENERAL
INSTALACIÓN DE PRUEBA (BAJO WINDOWS)
PRUEBA DEL OPAC
AJUSTES Y MEJORAS LOCALES
BAJO LINUX
CRÉDITOS Y AGRADECIMIENTOS
ACLARACIONES IMPORTANTES
MARCAS REGISTRADAS

INTRODUCCIÓN:

Usted debería haber recibido una serie de archivos:
  • Este instructivo readme.txt
  • La licencia LGPL (Lesser General Public License) LPGL.txt
  • IsisScripts *.xis
  • Formularios y documentos HTML *.html
  • Formatos de visualización *.pft
  • Archivos de parámetros *.cip y *.in
  • Un "gizmo" oa2c.*
  • Archivos de bases de datos ISIS *.fst y *.stw
  • Un listado de variables variables.txt
  • Una lista de sitios web de donde bajar los softwares necesarios bajadas.txt

Es importante leer las condiciones de la Licencia: ahí figuran sus obligaciones y sus derechos.
TENGA EN CUENTA QUE LAS "library or other program which contains a notice" MENCIONADAS EN EL ARTÍCULO 0 DE LA LGPL COMPRENDEN LOS SCRIPTS (IsisScripts y JavaScripts) PROTEGIDOS POR EL CORRESPONDIENTE COPYRIGHT.




SOFTWARE NECESARIO:

Este OpenOPAC supone la (pre)existencia de lo siguiente:

Para el servidor:
  • Una plataforma sobre la cual pueda correr el ejecutable WXIS.EXE de Bireme
    (en principio el OpenOPAC debería poder funcionar sobre las mismas plataformas en las que funciona WXIS, consulte el sitio de Bireme para saber cuáles son:
    http://productos.bvsalud.org/html/es/home.html , link WWWIsis)
    Ha sido probado con éxito bajo Windows98, Windows Me, y Linux SuSe7;
  • Un programa servidor web, como por ejemplo OmniHTTPd o Apache;
  • El ejecutable WXIS.EXE de Bireme en su versión 5.x o posterior;
  • La correspondiente LICENCIA de WXIS que se debe tramitar con Bireme
    (no es necesaria para hacer pruebas localmente);
  • Una base de datos ISIS (el formato de la base "solo" es importante a los efectos de las búsquedas por campos específicos y para la visualización de los resultados);

Para el cliente:
-un browser HTML que acepte JavaScript, como Netscape (version 4.6 o posterior), Internet Explorer (version 5 o posterior).

Lista de sitios web de donde bajar los softwares necesarios .





SOFTWARE UTIL:

-Son recomendables las herramientas CISIS de Bireme, en particular MX
http://productos.bvsalud.org/d-center/list.php?&lang=es&product=cisis&graphic=yes





FUNCIONAMIENTO GENERAL:

Hay cuatro marcos (frames) HTML en el OpenOPAC:
  • el "Inicial";
  • el "Índice";
  • el "Formulario";
  • los "Resultados" (marco que inicialmente contiene las ayudas o bienvenidas)

Al llenar el formulario y enviar los datos,
el JavaScript hace un preprocesamiento en el cliente,
el Servidor recibe el pedido de búsqueda,
la ejecuta siguiendo lo establecido en los IsisScripts (interpretados por WXIS),
consultando la base de datos Isis,
y envía los resultados al marco de resultados.
Se mantiene un registro de las búsquedas realizadas en un "transaction log" en el archivo tlog.txt.

El Índice es el resultado de otro IsisScript, cuya única función es recorrer el archivo invertido de la base de datos Isis. Al hacer click un alguno de los términos del Índice, el JavaScript ahí incluido lo envía al formulario.
Se mantiene un registro del uso del índice en un "transaction log" en el archivo indilog.txt.





INSTALACIÓN DE PRUEBA (BAJO WINDOWS):

Puede configurar la ubicación de los archivos como lo desee, sin embargo, a los efectos de poder probar cómo funciona el OPAC, se recomienda utilizar la configuración que se detalla a continuación.

Suponiendo que haga pruebas sin la licencia de WXIS de Bireme, la misma PC actuará al mismo tiempo de cliente y de servidor.


-UBICACIÓN DE LOS ARCHIVOS Y DIRECTORIOS
c:\www\
- cgi-bin\
- - wxis.exe
- - openopac\
- - - acansi0t.tab
- - - bases.cip
- - - detalles.pft
- - - dico.xis
- - - indilog.txt
- - - libros.xis
- - - oa2c.mst
- - - oa2c.xrf
- - - oa2c.iso
- - - tlog.txt
- - - todo1a999.pft
- - - base\
- - - - base.cnt
- - - - base.ifp
- - - - base.l01
- - - - base.l02
- - - - base.mst
- - - - base.n01
- - - - base.n02
- - - - base.stw
- - - - base.xrf
- - - - basegizmo.in
- - - - baseinv.in
- - - - baseopac.fst
- - - - mx.exe
- www_openopac\
- - creditos.html
- - helplibros.html
- - helprevistas.html
- - index.html
- - indexrevistas.html
- - inicial.html
- - libros.html
- - revistas.html


-CONFIGURACIÓN DE "OMNIHTTPD V1.01 FOR WINDOWS 95" :
No es necesario que el software de servidor web sea OmniHTTPd, pero la V1.01 es de fácil utilización y configuración, por lo que se recomienda para hacer pruebas. Puede bajarlo del sitio de Omnicron:
http://www.omnicron.ca/httpd/download.html
Se recomienda la siguiente configuración:
Standard CGI
Virtual: /CGI-BIN
Actual: C:\www\cgi-bin
Server
Site Address: 127.0.0.1
Server Root: C:\www
Default index: index.html
Lookup Site Address (Dynamic) SIN MARCAR
Enable DNS Name Resolution SIN MARCAR
Send Version Information MARCADO
Los demás son los valores por defecto


-CARACTERES ANSI
Para la correcta visualización de los caracteres acentuados y la correcta generación del archivo invertido, es necesario que los datos de la base estén en ANSI. Como lo más probable es que una base creada con MicroISIS esté en "OEM", es necesario hacer un cambio general de caracteres de OEM a ANSI en la base;
(sin entrar en mayores detalles, esto transforma de la tabla de caracteres CP 850 a la tabla CP 1252, muy parecida a ISO-8859-1).
Importante: esta operación debe realizarse ANTES de generar el archivo invertido.

Puede realizar este cambio con MX, desde el prompt de DOS:
c:\www\cgi-bin\openopac\base>mx in=basegizmo.in now
(Debe tener el ejecutable mx.exe en ese directorio o poder ejecutarlo desde ese directorio)


-GENERACIÓN DEL ARCHIVO INVERTIDO
El OpenOPAC supone que el archivo invertido de la base responda a ciertas características.
Recuerde que la base debe estar en ANSI (ver "-CARACTERES ANSI", el paso anterior).
Se adjunta una FST modelo: baseopac.fst
Ese y otros parámetros necesarios se encuentran en el archivo baseinv.in

Para generar el archivo invertido, se puede ejecutar, desde el prompt de DOS:
c:\www\cgi-bin\openopac\base>mx in=baseinv.in
(Debe tener el ejecutable mx.exe en ese directorio o poder ejecutarlo desde ese directorio)


-CONFIGURACIÓN DEL BROWSER:
Es necesario que esté permitido el uso de JavaScript.
En el caso de que su browser esté configurado con proxy, configúrelo para que no use proxy para direcciones locales.





PRUEBA DEL OPAC:

Una vez hechas las instalaciones indicadas, no queda más que testear la base de datos con el OpenOPAC.
Si utilizó la configuración propuesta, y el software servidor (OmniHTTPd por ejemplo) está encendido, con el browser debe ir al siguiente sitio:
http://127.0.0.1/www_openopac/index.html
o
http://localhost/www_openopac/index.html

El índice a la izquierda debería dar cuenta de los primeros términos del archivo invertido (a partir de la "a").





AJUSTES Y MEJORAS LOCALES:

En tanto software libre, Usted puede modificar como quiera el OpenOPAC.
Probablemente quiera modificar el formato de visualización (archivo *.pft)
Tambien puede modificar la interfase gráfica en los archivos *.HTML.
Probablemente tenga que modificar los IsisScripts y/o los HTML y la FST para adecuar
-la selección por campos determinados (como AUTOR, TÍTULO, etc.) y
-el ranking de los registros encontrados
a la estructura de su base de datos y a sus preferencias.
Puede incluir otras bases de datos.





BAJO LINUX:

Tenga en cuenta que
-tiene que utilizar el WXIS en su versión para Linux, la cual puede bajar del sitio de Bireme,
-la base de datos debe ser "reconstruida" de DOS a Linux, esto por la diferencia de saltos de línea entre DOS y Linux.





CRÉDITOS Y AGRADECIMIENTOS:

OpenOPAC ha sido desarrollado (inicialmente) como uno de los objetivos propuestos dentro del proyecto de "Desarrollo de la Biblioteca Central y bibliotecas departamentales de la Facultad de Ciencias Exactas y Naturales de la Universidad de Buenos Aires" y luego mejorado y optimizado hasta la versión que se distribuye por

-Ignacio Cavalieri y
-Nicolas Rucks.
El código incial es de
-Pablo De Natale.

Agradecimientos especiales a :
-Nancy D. Gómez, Directora de la Biblioteca Central "Dr. Luis F. Leloir" de la Facultad de Ciencias Exactas y Naturales de la Universidad de Buenos Aires, por el apoyo constante y el espacio, físico e intelectual que nos brindó y sigue brindando.
-Fernando Gómez, de la Universidad Nacional del Sur, por ideas y sugerencias dentro y fuera del código, y por el testeo.
-Dave Turner, Licensing Guru de la Free Software Foundation por la orientación respecto de la LGPL.





ACLARACIONES IMPORTANTES:

Recuerde que como software libre, OpenOPAC no cuenta con ninguna garantía.
Se adjunta la Licencia LGPL, puede encontrar traducciones no oficiales en
http://www.gnu.org/licenses/translations.html
Sus comentarios y sobre todo las mejoras al código son bienvenidos: quizás sean incluidos en una versión posterior.

La Biblioteca "Dr. Luis F. Leloir" se complace en distribuir OpenOPAC,
pero NO BRINDA APOYO TÉCNICO ALGUNO.

Sin embargo, puede contactarse con nosotros (Ignacio Cavalieri, Nicolas Rucks) a
openopac@bl.fcen.uba.ar





MARCAS REGISTRADAS:

Windows, OmniHTTPd, Apache, WWWIsis, WXIS, Linux, SuSE, Netscape, Internet Explorer, JavaScript
son marcas registradas de sus respectivos dueńos.





OpenOPAC, V3.0. Un conjunto de scripts (desarrollados en IsisScript y JavaScript)
para poder consultar via Web (cliente/servidor)
una base de datos ISIS como un catálogo de una biblioteca.
OpenOPAC, V3.0. A set of scripts (developed with IsisScript and JavaScript)
to query via WEB (client/server)
an ISIS database, as a library OPAC.
Copyright (C) 2002 Ignacio Cavalieri, Nicolas Rucks.
Contacto: openopac@bl.fcen.uba.ar

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

ESPAŃOL, traducción orientadora
OpenOPAC, V3.0. Un conjunto de scripts (desarrollados en IsisScript y JavaScript)
para poder consultar via Web (cliente/servidor)
una base de datos ISIS como un catálogo de una biblioteca.
Copyright (C) 2002 Ignacio Cavalieri, Nicolas Rucks.
Contacto: openopac@bl.fcen.uba.ar

Esta librería es software libre; usted puede redistribuirlo y/o modificarlo
bajo los términos de la GNU Lesser General Public License ("Licencia
Pública General Menor de GNU") tal como la publica la Free Software
Foundation; ya se la versión 2.1 de la Licencia, o (a su elección)
cualquier versión posterior.

Esta librería se distribuye con la esperanza de que sea útil,
pero SIN NINGÚN TIPO DE GARANTÍA; ni siquiera la garantía implícita de
COMERCIABILIDAD o de ADECUACIÓN A UNA FINALIDAD PARTICULAR. Vea la GNU
Lesser General Public License para más detalles.

Usted debería haber recibido una copia de la GNU Lesser General Public
License junto con esta librería; si no es así, escriba a Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA