Difference between revisions of "OPAC-ABCD Tutorial de configuración"

From ABCD Wiki
Jump to: navigation, search
(Instalación)
 
(47 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
==Instalación==
 
==Instalación==
* Descompacte el archivo '''opac_dist.zip''' descargado y obtenga la estructura de carpetas que se detalla en [http://wiki.abcdonline.info/OPAC-ABCD_scripts Estructura de carpetas del OPAC]
+
# Leer la [http://wiki.abcdonline.info/OPAC-ABCD_Descripci%C3%B3n descripción general del opac]
* Leer la [http://wiki.abcdonline.info/OPAC-ABCD_Descripci%C3%B3n descripción general del opac] en http://abcdwiki.net
+
# Cree la carpeta donde se va a instalar el Opac y descomprima el archivo '''opac_dist.zip''' descargado. Esta carpeta puede estar bajo ABCD o en cualquier lugar dentro del directorio Web y para efectos de esta explicación la llamaremos '''opac_abcd''' (ver [http://wiki.abcdonline.info/OPAC-ABCD_scripts Estructura de carpetas])
* Crear la carpeta donde se va a instalar el Opac y descomprimir los archivos. Esta carpeta puede estar bajo ABCD o en cualquier lugar dentro del directorio Web y para efectos de esta explicación la llamaremos '''opac_abcd''' (ver [http://wiki.abcdonline.info/OPAC-ABCD_scripts Estructura de carpetas])
+
# Mover la carpeta '''opac.xis''' a '''central/dataentry/wxis/'''  y cambiarle el nombre a opac
* Mover la carpeta '''opac.xis''' a '''central/dataentry/wxis/'''  y cambiarle el nombre a opac
+
# Copiar los  archivos contenidos en '''lang/00''', '''lang/es''','''lang/pt''' y cualquier otra actualización a la carpeta de lenguajes de la carpeta de bases de datos (Ejm: /bases/lang/00). Este archivo contiene los mensajes del OPAC y estado de cuenta, renovación y reserva en línea
* Copiar el archivo '''opac.tab''' contenido en '''lang.00''' a la carpeta de lenguajes de la carpeta bases (/bases/lang/00). Este archivo contiene los mensajes del OPAC
+
# Modifique las primeras líneas el script '''''[directorio-del-opac]''/php/config_opac.php''' para colocar el camino de acceso hacia '''config.php''' de ABCD  que está localizado en la carpeta '''central'''.
 +
#:    Ejm: 
 +
#:          include ("/abcd/www/htdocs/central/config.php");  //CAMINO DE ACCESO HACIA EL CONFIG.PHP DE ABCD
 +
#: <br>
 +
#; Si está instalando el OPAC con la versión 1.6 modifique en php/config_opac.php los parámetros
 +
#: <br>
 +
#:          $ABCD_scripts_path="/abcd/www/htdocs/";            //path donde están instalados los scripts de abcd
 +
#:          $server_url="http://127.0.0.1:9001";              //El url que se usa para acceder al módulo central
 +
#: <br>
 +
#: colocando los valores correspondientes a su instalación
 +
# Agregue una nueva sub-carpeta denominada  '''opac_conf''' en la carpeta '''bases''' establecida en '''config.php''' de ABCD. '''opac_conf'''  se utilizará para almacenar los archivos de configuración de las bases de datos. Estos archivos se crean desde el módulo de configuración contenido en la carpeta '''config''' del OPAC
 +
# Bajo '''opac_conf''' agregue una sub-carpeta para cada lenguaje que vaya utilizar (ejm: es, fr, pt, en ...)
 +
# Ejecute el módulo de configuración desde donde haya instalado el OPAC (ejm: http://localhost:9091/opac_abcd/config/). En ese momento se realiza la verificación del camino de acceso hacia el config.php de ABCD (ver punto 5)
  
==Configuración básica==
+
==Entrada al módulo de configuración==
* Preparar los formatos de despliegue que deben ser diferentes a los del módulo central por cuanto hay que agregar una barra de herramientas de registro. Puede copiar los formatos que seleccione y darles otro nombre<br><br>
+
# Proporcione el login y el password del administrador de ABCD. La tabla de lenguajes que se utiliza en esta entrada es aquella definida en el módulo central de ABCD. Si se produce algún error verifique que el punto 5 de la instalación haya sido ejecutado correctamente
* Para utilizar la opción de meta-búsqueda los campos que van a intervenir deben estar indizados con el mismo prefijo<br><br>
+
# Si el login y password están correctos se presentará el menú principal con las opciones de configuración.
* Leer la [http://wiki.abcdonline.info/OPAC-ABCD_Descripci%C3%B3n descripción general del opac] en http://abcdwiki.net<br><br>
+
# Cuando se entra por primera vez al módulo de configuración, con cada menú u hoja de entrada se presenta una ventana con ayuda obtenida de abcdonline.info. Además podrá observar 2 enlaces:
* Crear la carpeta donde se va a instalar el Opac y descomprimir los archivos. Esta carpeta puede estar bajo ABCD o en cualquier lugar dentro del directorio Web y para efectos de esta explicación la llamaremos '''opac_abcd''' (ver [http://wiki.abcdonline.info/OPAC-ABCD_scripts Estructura de carpetas])<br><br>
+
#: Mostrar/Esconder la ayuda  / Traducir la ayuda
 +
#: El primer enlace le esconde temporalmente la página de ayuda y el segundo enlace envía la página de ayuda a Google translator y abre una nueva ventana con la traducción al inglés. Puede esconder permanentemente la ayuda usando la opción '''Parámetros''' del menú de configuración y marcando su preferencia en el parámetro correspondiente a '''Mostrar páginas de ayuda'''. Luego puede usar en enlace Mostrar/esconder ayuda para ver la ayuda cuando la necesite.
  
 +
===Configuración General===
 +
Ejecute las opciones que se encuentran bajo '''Configuración General''':
 +
*Parámetros
 +
*Idiomas disponibles
 +
*Bases de datos disponibles
 +
*Barra de herramienta de registros
 +
:La explicación de cada una se muestra en el formulario de entrada correspondiente
  
* Editar el script  '''opac_abcd/php/config_opac.php''' y modificar la primera línea para colocar el camino de acceso hacia el archivo '''config.php''' del módulo central. Ejm: <big><font color=blue>include ("/abcd2.2/www/htdocs/central/config.php");</font></big> '''No olvidar las comillas ni el ; (punto y coma) al final ya que se podría generar un error de sintaxis'''<br><br>
+
===Configuración de las bases de datos===
* Si no está trabajando con la versión 2.2 entonces el '''include''' mencionado anteriormente debe apuntar a la carpeta donde tiene instalado ABCD actualmente. Además, debe editar agregar a config_opac.php las instrucciones
+
Seleccione la base de datos que desea configurar. Esta lista se genera a partir del archivo bases.dat creado en la opción '''Bases de datos disponibles''' de '''Configuración general'''  
 +
  Nota importante:
 +
  Esta configuración corresponde al idioma seleccionado. Por lo tanto los archivos generados
 +
  se almacenarán en la carpeta correspondiente a dicho idioma
 +
====Configuración Básica====
 +
Debe llenar los formularios:
 +
*Búsqueda Libre
 +
*Búsqueda Avanzada
 +
*Formatos de despliegue
 +
*Verificar y actualizar el dbn.par.
 +
:Esta opción verifica que los formatos definidos estén incluidos en el dbn.par y en caso de no estarlo, los agrega.
 +
:Tenga en cuenta que para agregar un formato en el dbn.par debe seguir el siguiente esquema:
 +
      formato.pft=%path_database%dbn/pfts/%lang%/formato.pft
 +
      donde:
 +
      %path_database% es el nombre del parámetro que será reemplazado al momento de
 +
                      ejecución por la ruta hacia la carpeta bases
 +
      dbn            es el nombre de la base de datos
 +
      %lang%          es el nombre del parámetro que será reemplazado al momento de
 +
                      ejecución por el lenguaje activo
  
      //Estos dos comandos se tienen que quitar si está instalada la version 2.2
+
Puede utilizar la ventana '''Copiar archivos de configuración''' para replicar la configuración en otro lenguaje de modo tal que solo tenga que modificar los títulos de las tablas y formatos.
      $ABCD_scripts_path="/abcd1/www/htdocs/";  //para hacerlo compatible con la versión 1.6
+
====Metabúsqueda====
      $server_url="http://127.0.0.1:9001";      //para hacerlo compatible con la versión 1.6
+
* Terminada la configuración básica de las bases de datos debe configurar la '''meta-búsqueda''' llenando el formulario de búsqueda avanzada. Recuerde que para que un campo sea parte de la metabúsqueda debe estar indizado en la FST de todas las bases de datos con el mismo prefijo.
    //
+
* Una vez que esté lista la configuración básica para un lenguaje entrar al Opac y realizar pruebas.
Sustituyendo por los valores que estén de acuerdo con su instación.  Si la tiene instalada la nueva version 2.2 elimine estas dos instrucciones. Esto es un pequeño truco para poder utilizar el opac con la versión  1.5 o superior.
+
 
* Crear en la carpeta '''bases''' la sub-carpeta  '''opac_conf''' <br><br>
+
 
* Bajo '''opac_conf''' crear tantas sub-carpetas como lenguajes vayan a estas disponibles para el usuario. Ejm:  es, en, fr, etc..<br><br>
+
====Configuración Avanzada====
* Acceder la carpeta '''config''' desde el url donde se haya instalado el opac. Ejm:<br><nowiki>http://localhost:9091/opac_abcd/config/</nowiki><br><br>
 
* Suministrar el login y password del administrador de ABCD y seleccionar el lenguaje que se desea configurar. Si tiene problemas de entrada verifique el paso 5 y si el login y password suministrados son los adecuados. La lista de lenguajes que se presenta en ese momento corresponde a la tabla a la cual apunta el parámetro '''$msg_path''' y el lenguaje por defecto '''$lang''' fijado ambos en  '''central/config.php'''<br><br>
 
* Se presenta un menú con la configuración general ya que para proceder con el resto de las opciones hace falta crear la lista de lenguajes disponibles y la lista de bases de datos disponibles<BR><BR>.
 
* Una vez cumplido el paso anterior proceda a realizar la  configuración básica de las bases de datos definidas en la '''Lista de bases de datos disponibles'''. S tiene dudas, puede usar el botón de '''ayuda''' que se muestra en cada una de las páginas. A la derecha de la hoja de solicitud de información se mostrará la definición existente en el módulo '''central''' para ese proceso y esa base de datos. Siempre podrá regresar al módulo de configuración para realizar algún ajuste.<br><br>
 
* Si no tiene clara la definición de facetas no tiene por qué llenarla<br><br>
 
* Terminada la configuración básica de las bases de datos debe configurar la '''meta-búsqueda''' llenando el fórmulario de búsqueda avanzada y los formatos de despliegue los cuales se usarán por defecto cuando una base de datos no esté configurada. Si este paso se omite se generará un error al intentar aplicar las opciones de meta-búsqueda.<br><br>
 
* Una vez que esté lista la configuración básica para un lenguaje entrar al Opac y realizar pruebas .<br><br>
 
* Agregar a los formatos la '''barra de herramientas de registros''' la cual se encuentra en el menú de configuración bajo '''Recursos para el formateo de registros -> Barra de herramientas del registro'''. Lo único que tiene que hacer es dar clic sobre el botón '''Guardar''' y agregar la línea indicada al dbn.par de todas las bases de datos disponibles.  Consulte la ayuda para obtener una explicación sobre como modificar el formato para agregar la barra de herramientas.<br><br>
 
* Construir los formatos '''opac_print.pft''' y '''opac_mail.pft''' para imprimir o enviar resultados por correo electrónico. Agregarlos al dbn.par<br><br>
 
* Puede utilizar la opción '''Copiar archivos de configuración''' del menú para generar la configuración en otro lenguaje.  Al copiar los archivos de configuración solo tendrá que traducir los títulos al lenguaje correspondiente.<br><br>
 
  
 
==Modificar la página de inicio del opac y las páginas de inicio de cada base de datos==
 
==Modificar la página de inicio del opac y las páginas de inicio de cada base de datos==

Latest revision as of 11:37, 26 February 2021

Instalación

  1. Leer la descripción general del opac
  2. Cree la carpeta donde se va a instalar el Opac y descomprima el archivo opac_dist.zip descargado. Esta carpeta puede estar bajo ABCD o en cualquier lugar dentro del directorio Web y para efectos de esta explicación la llamaremos opac_abcd (ver Estructura de carpetas)
  3. Mover la carpeta opac.xis a central/dataentry/wxis/ y cambiarle el nombre a opac
  4. Copiar los archivos contenidos en lang/00, lang/es,lang/pt y cualquier otra actualización a la carpeta de lenguajes de la carpeta de bases de datos (Ejm: /bases/lang/00). Este archivo contiene los mensajes del OPAC y estado de cuenta, renovación y reserva en línea
  5. Modifique las primeras líneas el script [directorio-del-opac]/php/config_opac.php para colocar el camino de acceso hacia config.php de ABCD que está localizado en la carpeta central.
    Ejm:
    include ("/abcd/www/htdocs/central/config.php"); //CAMINO DE ACCESO HACIA EL CONFIG.PHP DE ABCD

    Si está instalando el OPAC con la versión 1.6 modifique en php/config_opac.php los parámetros

    $ABCD_scripts_path="/abcd/www/htdocs/"; //path donde están instalados los scripts de abcd
    $server_url="http://127.0.0.1:9001"; //El url que se usa para acceder al módulo central

    colocando los valores correspondientes a su instalación
  6. Agregue una nueva sub-carpeta denominada opac_conf en la carpeta bases establecida en config.php de ABCD. opac_conf se utilizará para almacenar los archivos de configuración de las bases de datos. Estos archivos se crean desde el módulo de configuración contenido en la carpeta config del OPAC
  7. Bajo opac_conf agregue una sub-carpeta para cada lenguaje que vaya utilizar (ejm: es, fr, pt, en ...)
  8. Ejecute el módulo de configuración desde donde haya instalado el OPAC (ejm: http://localhost:9091/opac_abcd/config/). En ese momento se realiza la verificación del camino de acceso hacia el config.php de ABCD (ver punto 5)

Entrada al módulo de configuración

  1. Proporcione el login y el password del administrador de ABCD. La tabla de lenguajes que se utiliza en esta entrada es aquella definida en el módulo central de ABCD. Si se produce algún error verifique que el punto 5 de la instalación haya sido ejecutado correctamente
  2. Si el login y password están correctos se presentará el menú principal con las opciones de configuración.
  3. Cuando se entra por primera vez al módulo de configuración, con cada menú u hoja de entrada se presenta una ventana con ayuda obtenida de abcdonline.info. Además podrá observar 2 enlaces:
    Mostrar/Esconder la ayuda / Traducir la ayuda
    El primer enlace le esconde temporalmente la página de ayuda y el segundo enlace envía la página de ayuda a Google translator y abre una nueva ventana con la traducción al inglés. Puede esconder permanentemente la ayuda usando la opción Parámetros del menú de configuración y marcando su preferencia en el parámetro correspondiente a Mostrar páginas de ayuda. Luego puede usar en enlace Mostrar/esconder ayuda para ver la ayuda cuando la necesite.

Configuración General

Ejecute las opciones que se encuentran bajo Configuración General:

  • Parámetros
  • Idiomas disponibles
  • Bases de datos disponibles
  • Barra de herramienta de registros
La explicación de cada una se muestra en el formulario de entrada correspondiente

Configuración de las bases de datos

Seleccione la base de datos que desea configurar. Esta lista se genera a partir del archivo bases.dat creado en la opción Bases de datos disponibles de Configuración general

  Nota importante:
  Esta configuración corresponde al idioma seleccionado. Por lo tanto los archivos generados 
  se almacenarán en la carpeta correspondiente a dicho idioma

Configuración Básica

Debe llenar los formularios:

  • Búsqueda Libre
  • Búsqueda Avanzada
  • Formatos de despliegue
  • Verificar y actualizar el dbn.par.
Esta opción verifica que los formatos definidos estén incluidos en el dbn.par y en caso de no estarlo, los agrega.
Tenga en cuenta que para agregar un formato en el dbn.par debe seguir el siguiente esquema:
     formato.pft=%path_database%dbn/pfts/%lang%/formato.pft
     donde:
     %path_database% es el nombre del parámetro que será reemplazado al momento de
                     ejecución por la ruta hacia la carpeta bases
     dbn             es el nombre de la base de datos
     %lang%          es el nombre del parámetro que será reemplazado al momento de
                     ejecución por el lenguaje activo 

Puede utilizar la ventana Copiar archivos de configuración para replicar la configuración en otro lenguaje de modo tal que solo tenga que modificar los títulos de las tablas y formatos.

Metabúsqueda

  • Terminada la configuración básica de las bases de datos debe configurar la meta-búsqueda llenando el formulario de búsqueda avanzada. Recuerde que para que un campo sea parte de la metabúsqueda debe estar indizado en la FST de todas las bases de datos con el mismo prefijo.
  • Una vez que esté lista la configuración básica para un lenguaje entrar al Opac y realizar pruebas.


Configuración Avanzada

Modificar la página de inicio del opac y las páginas de inicio de cada base de datos