Está en la página 1de 9

La Biblioteca Central "Dr. Luis F.

Leloir" de la Facultad de Ciencias Exactas y Naturales de la Universidad de Buenos Aires se complace en anunciar la liberacin del cdigo fuente del OPAC (catlogo en lnea) desarrollado en esta misma casa bajo licencia LGPL (GNU Lesser General Public License). El "OpenOPAC", como decidimos llamarlo, es un conjunto de IsisScripts combinados con HTML y JavaScripts que funcionan sobre el CGI desarrollado por BIREME: WXIS. El catlogo de nuestra Biblioteca funciona con una adaptacin de estos scripts : www.opac.bl.fcen.uba.ar. El puntapi inicial de este proyecto fue generar un catlogo eficiente para uso interno de la Biblioteca, requeramos que fuese cliente/servidor, accesible via Web y de uso sencillo. La evolucin de este desarrollo se ha dado en paralelo a la idea que los integrantes de la Biblioteca tenemos de ir tendiendo hacia el cdigo abierto, con nimos de compartir experiencias y aportar soluciones. Lo invitamos a ver ms detalles del OpenOPAC. Para obtener una copia de OpenOPAC, enve un correo electrnico solicitndolo, aclarando la Institucin donde se desempea, a openopac@bl.fcen.uba.ar. Para ms informacin sobre WXIS de Bireme, vea http://productos.bvsalud.org/html/es/home.html. Para ms informacin sobre la GNU Lesser General Public License, vea http://www.gnu.org/copyleft/lesser.html (en ingls). La Biblioteca "Dr. Luis F. Leloir" se complace en distribuir OpenOPAC, pero NO BRINDA APOYO TCNICO ALGUNO.

Detalles del open opac


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 catlogo 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. INTRODUCCIN SOFTWARE NECESARIO SOFTWARE UTIL FUNCIONAMIENTO GENERAL INSTALACIN DE PRUEBA (BAJO WINDOWS) PRUEBA DEL OPAC AJUSTES Y MEJORAS LOCALES BAJO LINUX

CRDITOS Y AGRADECIMIENTOS ACLARACIONES IMPORTANTES MARCAS REGISTRADAS INTRODUCCIN: Usted debera 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 visualizacin *.pft Archivos de parmetros *.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 ARTCULO 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 debera poder funcionar sobre las mismas plataformas en las que funciona WXIS, consulte el sitio de Bireme para saber cules 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 versin 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 bsquedas por campos especficos y para la visualizacin 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 .

Bajadas de software:

OMNIHTTPD http://www.omnicron.ca/httpd/download.html Recomendamos para el testeo bajar la version v1.01. Si bien dice que la version 1.01 es para Windows 95 solamente, ha sido probada con xito bajo Windows 98, y es freeware). Sitio de APACHE: http://www.apache.org/ NETSCAPE http://www.netscape.com/ INTERNET EXPLORER http://www.microsoft.com/windows/ie/default.asp Sitio de Bireme: http://www.bireme.br/ Listado de Productos de Bireme: Links a herramientas de Bireme WXIS (WWWIsis) Download WXIS Download tutoriales de WXIS Herramientas CISIS Download MX (con las dems herramientas CISIS)

Lista de inters de WWWIsis (WXIS): http://listas.bireme.br/mailman/listinfo/wwwisis-l wwwisis-l@bireme.br

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 bsqueda, la ejecuta siguiendo lo establecido en los IsisScripts (interpretados por WXIS), consultando la base de datos Isis, y enva los resultados al marco de resultados. Se mantiene un registro de las bsquedas realizadas en un "transaction log" en el archivo tlog.txt. El ndice es el resultado de otro IsisScript, cuya nica funcin es recorrer el archivo invertido de la base de datos Isis. Al hacer click un alguno de los trminos del ndice, el JavaScript ah incluido lo enva al formulario. Se mantiene un registro del uso del ndice en un "transaction log" en el archivo indilog.txt.

INSTALACIN DE PRUEBA (BAJO WINDOWS): Puede configurar la ubicacin de los archivos como lo desee, sin embargo, a los efectos de poder probar cmo funciona el OPAC, se recomienda utilizar la configuracin que se detalla a continuacin. Suponiendo que haga pruebas sin la licencia de WXIS de Bireme, la misma PC actuar al mismo tiempo de cliente y de servidor. -UBICACIN 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 -CONFIGURACIN DE "OMNIHTTPD V1.01 FOR WINDOWS 95" : No es necesario que el software de servidor web sea OmniHTTPd, pero la V1.01 es de fcil utilizacin y configuracin, 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 configuracin: 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 dems son los valores por defecto -CARACTERES ANSI Para la correcta visualizacin de los caracteres acentuados y la correcta generacin del archivo invertido, es necesario que los datos de la base estn en ANSI. Como lo ms 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 operacin 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) -GENERACIN DEL ARCHIVO INVERTIDO El OpenOPAC supone que el archivo invertido de la base responda a ciertas caractersticas. Recuerde que la base debe estar en ANSI (ver "-CARACTERES ANSI", el paso anterior). Se adjunta una FST modelo: baseopac.fst Ese y otros parmetros 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) -CONFIGURACIN DEL BROWSER: Es necesario que est permitido el uso de JavaScript. En el caso de que su browser est configurado con proxy, configrelo para que no use proxy para direcciones locales.

PRUEBA DEL OPAC: Una vez hechas las instalaciones indicadas, no queda ms que testear la base de datos con el OpenOPAC. Si utiliz la configuracin 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 debera dar cuenta de los primeros trminos 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 visualizacin (archivo *.pft) Tambien puede modificar la interfase grfica en los archivos *.HTML. Probablemente tenga que modificar los IsisScripts y/o los HTML y la FST para adecuar

-la seleccin por campos determinados (como AUTOR, TTULO, 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 versin 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 lnea entre DOS y Linux.

CRDITOS 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 versin que se distribuye por -Ignacio Cavalieri y -Nicolas Rucks. El cdigo incial es de -Pablo De Natale. Agradecimientos especiales a : -Nancy D. Gmez, 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, fsico e intelectual que nos brind y sigue brindando. -Fernando Gmez, de la Universidad Nacional del Sur, por ideas y sugerencias dentro y fuera del cdigo, y por el testeo. -Dave Turner, Licensing Guru de la Free Software Foundation por la orientacin respecto de la LGPL.

ACLARACIONES IMPORTANTES: Recuerde que como software libre, OpenOPAC no cuenta con ninguna garanta. 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 cdigo son bienvenidos: quizs sean incluidos en una versin posterior.

La Biblioteca "Dr. Luis F. Leloir" se complace en distribuir OpenOPAC, pero NO BRINDA APOYO TCNICO 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 dueos.

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 catlogo 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 ESPAOL, traduccin 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 catlogo de una biblioteca. Copyright (C) 2002 Ignacio Cavalieri, Nicolas Rucks. Contacto: openopac@bl.fcen.uba.ar Esta librera es software libre; usted puede redistribuirlo y/o modificarlo

bajo los trminos de la GNU Lesser General Public License ("Licencia Pblica General Menor de GNU") tal como la publica la Free Software Foundation; ya se la versin 2.1 de la Licencia, o (a su eleccin) cualquier versin posterior. Esta librera se distribuye con la esperanza de que sea til, pero SIN NINGN TIPO DE GARANTA; ni siquiera la garanta implcita de COMERCIABILIDAD o de ADECUACIN A UNA FINALIDAD PARTICULAR. Vea la GNU Lesser General Public License para ms detalles. Usted debera haber recibido una copia de la GNU Lesser General Public License junto con esta librera; si no es as, escriba a Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA