Bonsai Manual v 40

8/11/2019 Bonsai Manual v 40

1/11

Bonsai: consulta web del

catlogo de la biblioteca

Manual de instalacin,configuracin y uso

Versin 4.0 Agosto 2008

Fernando Posada

http://www.canaltic.com


2/11

Bonsai 4.0: consulta web del catlogo de la biblioteca2008. Fernando Posada. http://www.canaltic.com

Pgina 2 de 11

ndice

1.

Qu es Bonsai? ................................................................................. 3

2.

Requisitos del programa ...................................................................... 3

3.Instalacin....................................................................................... 4

4.Cmo iniciar el programa? ................................................................... 4

5.Comprobar conexin........................................................................... 5

6.Instalar en el servidor ......................................................................... 7

7.Publicar datos .................................................................................. 7

8.Pgina web de consulta ....................................................................... 9

9.Delegacin de la publicacin............................................................... 10

10.Desinstalacin de la aplicacin Bonsai.................................................... 11


3/11


Pgina 3 de 11

1. QU ES BONSAI?

Bonsai es una pequea aplicacin que permite crear y mantener en la web del centro unsistema de consultas del catlogo de libros de la biblioteca. Esto se consigue con 3 sencillospasos: Conectar, Instalary Publicar.

Bonsai utiliza una base de datos propia que importa los registros bibliogrficos introducidosen la base de datos del programa Abies.

2. REQUISITOS DEL PROGRAMA

Bonsai se suele instalar en el mismo equipo que Abies. Permite importar y subir al servidorweb los registros bibliogrficos almacenados en el programa Abies y adems publicar unsistema de pginas activas PHP que una vez situadas en el servidor ofrecen a otros usuarios laconsulta de este catlogo utilizando solamente su navegador web.

Los requisitos del ordenador donde se instala Bonsai son:

WindowsXP SP 2o Vista. Conexin a Internet. Acceso a la base de datos Abies.mdb que contiene la gestin de la biblioteca con el

programa Abies 2. No funciona con versiones inferiores de Abies.

El sistema de pginas web que muestran elcatlogo requiere disponer de una cuentaen un servidor web con los siguientesservicios:

FTP que permita subir archivos alservidor remoto.

PHP para interpretar el cdigo delas pginas activas que utilizaBonsai.

MySQL que proporciona la base dedatos donde se guardar la

informacin de los libros.

Antes de continuar conviene asegurarse que se dispone de una cuenta de alojamiento depginas web con las correspondientes credenciales FTP y MySQL.


4/11


Pgina 4 de 11

3. INSTALACIN

1. Descarga y ejecuta el instalador de Bonsai: BonsaiSetupv40.exe. Asegrate de que elprograma Abies 2 est cerrado.

2. Se propone instalar por defecto el programa en una carpeta llamada Bonsai en la unidadC:\ Es aconsejable respetar esta configuracin. Otra posibilidad es instalarlo en otraunidad o particin: D:\ ,etc. Clic en el botn OK

3. A continuacin pulsa en el botn OK para cerrar la ventana donde se indica que lainstalacin se ha completado con xito.

4. Tras concluir la instalacin se inicia el programa Bonsai.

4. CMO INICIAR EL PROGRAMA?

Existen tres procedimientos alternativos para iniciar el programa:

Doble clic sobre el icono Bonsai 4.0 que aparece en el escritorio deWindows.

Selecciona Inicio > Todos los programas > Bonsai > Bonsai 4.0 Utiliza el explorador de Windows para situarte en la carpeta C:\Bonsai y

haz doble clic sobre el archivo bonsai.exe


5/11


6/11


Pgina 6 de 11

Carpeta remota. Es importante conocer en qu carpeta nos sita el servidor FTPcuando nos conectamos a su URL y con esas credenciales. Para comprobarlo bastautilizar un cliente como Filezilla (http://filezilla-project.org/). En ocasiones la sesinse inicia en la carpeta principal o raz de esa cuenta. En este caso no ser necesariointroducir ningn valor en el cuadro de texto Carpeta. Sin embargo si el inicio desesin se produce en una carpeta superior entonces ser necesario indicar el nombre

de la subcarpeta que contiene los archivos del espacio web (por ejemplo www o bienpublic_html)

MySQL Servidor. Es la URL del servidor de bases de datos MySQL que utilizar la aplicacin

web para cargar los registros bibliogrficos, leerlos y mostrarlos. Generalmente sesuele utilizar la direccin localhost para indicar que el servidor MySQL se encuentraen la misma mquina que el servidor web pero en otras ocasiones es otra URL por loque es necesario comprobar este dato en nuestro proveedor de alojamiento web.

Base de datos. Es el nombre de la base de datos en la que se crear y utilizar latabla tlibros con los registros bibliogrficos a consultar. Es necesario asegurarse quetenemos permisos de creacin de tablas, lectura y escritura sobre esta base de datoscon el usuario y contrasea disponibles.

Usuario y contrasea. Son las credenciales de acceso al servidor MySQL quepermitir manejar la tabla en la base de datos.

Otros Centro. El nombre del centro se mostrar en el pie de la pgina web de consultas. Email. Se incluir un enlace a la cuenta de correo electrnico del centro.

Nota importante: NO actives todava la casilla Conexin automtica slo publicacin. Estaoperacin se reserva para la delegacin de la gestin (ver apartado Delegacin de lapublicacin de este documento).

4.

Pulsa sobre el botn Conectar.

5.

Si los datos introducidos son correctos y existe conexin a Internet, en el registro deactividad se mostrarn los mensajes OK correspondientes a las conexiones FTP y HTTPo Web. Al cabo de unos instantes los botones Instalar y Publicar sern accesibles.

Si la conexin ha tenido xito, los datos introducidos se guardarn encriptados en el archivobonsai.cfgdentro de la carpeta de la aplicacin: C:\Bonsai. Si borras este archivo, tendrsque introducirlos de nuevo la prxima vez que se inicie Bonsai.


7/11


Pgina 7 de 11

6. INSTALAR EN EL SERVIDOR

1. Pulsa sobre el botn Instalar en Servidor. Con esta operacin se suben al espacio delcentro todos las pginas PHP y archivos grficos necesarios para el sistema de consultasva web.

2.

En el registro de actividad se pueden leer los distintos ecos de la subida de archivos.

3. Una vez finalizada esta operacin, si accedes a tu espacio utilizando un programa clienteFTP como Filezilla (http://filezilla-project.org/) podrs comprobar que en el directorioraz existe una nueva carpeta llamada biblio y dentro de ella todos los archivos subidos.

Este paso es necesario repetirlo si se decide actualizar la denominacin o email del centroas como las credenciales de acceso al servidor MySQL.

Una vez subidos los archivos *.php se pueden descargar en local con Filezilla, editarlos yvolver a subirlos para personalizar su aspecto. Otra posibilidad es editar previamente lacopia en local que se guarda en la carpeta archives dentro de la carpeta de instalacin deBonsai. La edicin de estos archivos requiere ciertos conocimientos de programacin PHP yCSS.

Cada vez que se realiza el paso de instalacin en el servidor se sobrescriben los archivos delmismo con los guardados en local en la carpeta archives.

7. PUBLICAR DATOS

1. Clic sobre el botn Publicar datos. Mediante esta operacin se inicia el proceso de subidade las registros bibliogrficos contenidos en la base de datos de Abies 2 a una tabla de labase de datos MySQL del hosting del centro.

2. Si en el equipo est instalado Abies con las opciones por defecto, es decir, en la ruta:C:\Archivos de Programa\Abies 2 el proceso de publicacin se realizarautomticamente. En caso contrario se mostrar un cuadro de dilogo ImportarABIES.MDB donde el usuario deber navegar por el disco duro local para indicarle a Bonsai

donde se encuentra el archivo Abies.mdba partir del cual se extraern los datos.


8/11


Pgina 8 de 11

3. En el cuadro del registro de actividad se visualizarn los ecos de esta operacin. Eltiempo invertido en el proceso de subida de los datos est condicionado por el nmero deregistros bibliogrficos y por el ancho de banda disponible para acceder a Internet. Enfuncin de estos factores este proceso se puede alargar varios minutos .

4. Al finalizar con xito este proceso se abrir el navegador configurado por defecto en elequipo mostrando la pgina del sistema de consulta.

Cada vez que se pulsa en el botn Publicar datos se actualizarn todos los registrosbibliogrficos en el servidor dando oportunidad a subir tambin los cambios realizados en losprimeros registros.

Para funcionar correctamente Bonsai necesita disponer de 2 3 Mb de espacio libre temporalen la cuenta FTP del servidor web. En caso contrario se producir un error al tratar depublicar los datos.

Antes de publicar es necesario comprobar que disponemos de un ancho de banda suficientepara que el proceso se realice en un tiempo razonable y con xito. No existe lmite en elnmero de registros a subir.

Aunque es recomendable no es imprescindible que Bonsai se instale en el mismo equipodonde se gestiona la biblioteca con Abies. Se puede instalar Bonsai en otro equipo. Luegodebes copiar por red o usando una memoria USB el archivo Abies.mdb situado por defecto enC:\Archivos de programa\Abies 2\Datos donde est instalado Abies y replicar esta mismaestructura de carpetas para situarlo en esa misma subcarpeta en el equipo donde seencuentra Bonsai. De esta forma esta aplicacin encontrar la base de datos en este lugar ypodr completar con xito el paso 3 de publicacin de registros.

Bonsai realiza una operacin de slo lectura en la base de datos de Abies. Por este motivo nopuede daar ni alterar la informacin que maneja Abies. No obstante es posible realizar unacopia de seguridad del archivo Abies.mdb antes de utilizar Bonsai.

De todos los datos que maneja Abies (ejemplares, prstamos, devoluciones, etc), Bonsai sloutiliza algunos campos de la tabla de ejemplares. Por este motivo no es posible recuperar labase de datos de Abies a partir de Bonsai.

El paso 3 de publicacin de registros se contempla realizarlo con cierta periodicidad(quincenal, mensual o trimestral) y slo si se han catalogado ms ejemplares con Abies. Serla forma de publicar en la web estas nuevas adquisiciones.


9/11


10/11


Pgina 10 de 11

8.5 Detalles del ejemplar.

1. Pulsa sobre el Ttulode un ejemplar.2.

Se desplegar una ventana emergente mostrando la principal informacin del mismo.

8.6 Fecha de la ltima actualizacin.

Se indica la fecha de la ltima Actualizacin realizada en la base de datos quecontiene el catlogo de libros de la biblioteca.

9. DELEGACIN DE LA PUBLICACIN

Cuando has completado con xito los 3 pasos descritos con anterioridad (Conectar, Instalar yPublicar) se puede delegar las posteriores actualizaciones de datos en un profesor/a oencargado de biblioteca.

1. Pulsa sobre el botn Comprobar conexin.

2. En el cuadro de dilogo Datos de la conexin activa la casilla Conexin automticaslo publicacin.

3. Pulsa en el botn Conectar

A partir de esta operacin Bonsai se comporta de la siguiente forma:

Cuando se pulsa en el botn Comprobar conexinno se muestra el cuadro Datos dela conexin. Se chequea directamente la conexin ocultando los datos de la misma.

El botn Instalar en Servidor se deshabilita no permitiendo actualizar en el servidorremoto los archivos grficos y pginas.

De esta forma el responsable de la bibliotecaslo tendr que realizar cada cierto tiempo dossencillas operaciones: Comprobar Conexiny Publicar Datos.

Para restaurar la situacin inicial de Bonsai basta con eliminar el archivo bonsai.cfgque se hacreado dentro de la carpeta C:\Bonsai . Al acceder de nuevo a esta aplicacin y pulsar en elbotn Conectar se solicitarn de nuevo las credenciales de conexin.


11/11


Pgina 11 de 11

10. DESINSTALACIN DE LA APLICACIN BONSAI

10.1 Desinstalacin del equipo local

1. Desde el Explorador de Windows, haz clic sobre la carpeta C:\Bonsaiy pulsa la teclapara eliminar el programa.

2.

Clic sobre el icono de Bonsai en el escritorio y pulsa la tecla 3. Desde el escritorio de Windows, selecciona Inicio > Todos los programas > Bonsai,haz clic derecho sobre esta carpeta y elige la opcin Eliminar en el men secundarioque aparece.

10.2 Desinstalacin en el servidor remoto.

1. Conecta con un programa cliente FTP al espacio de la web de tu centro.2. En el directorio raz haz clic sobre la carpeta biblio y pulsa la tecla 3. Utiliza phpMyAdmin para acceder por web a la administracin de tu cuenta de

MySQL.4. En la columna izquierda del interfaz de administracin, selecciona la base de datos

que has configurado para Bonsai y dentro de ella localiza y haz clic sobre la tabla

tlibros

5. En la barra de herramientas superior del marco derecho haz clic en el botn Eliminar.

6. Confirma esta operacin de borrado de tabla (DROP) pulsando en el botn Aceptar.

Documents

Bonsai Manual v 40