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

From ABCD Wiki
Jump to: navigation, search
 
(65 intermediate revisions by the same user not shown)
Line 1: Line 1:
# Leer la [http://wiki.abcdonline.info/OPAC-ABCD_Descripci%C3%B3n descripción general del opac] en http://abcdwiki.net<br><br>
+
==Instalación==
# 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>
+
# Leer la [http://wiki.abcdonline.info/OPAC-ABCD_Descripci%C3%B3n descripción general del opac]
# Bajo la carpeta '''central/dataentry/wxis/''' crear una subcarpeta denominada '''opac''' y colocar ahí los scripts '''.xis''' que se encuentran en el archivo comprimido '''scripts.zip'''<br><br>
+
# 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 en la carpeta de mensajes ('''bases/lang/xx''') una nueva carpeta denominada '''opac''' y colocar ahí los archivos de mensaje
+
# Mover la carpeta '''opac.xis''' a '''central/dataentry/wxis/''' y cambiarle el nombre a opac
# 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:<br>  include ("/abcd/www/htdocs/central/config.php"); <br><br>
+
# 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
# Crear en la carpeta '''bases''' la sub-carpeta '''opac_conf''' <br><br>
+
# 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'''.
# Bajo '''opac_conf''' crear tantas sub-carpetas como lenguajes vayan a estas disponibles para el usuario. Ejm:  es, en, fr, etc..<br><br>
+
#:    Ejm:  
# Colocar el formato ''' [http://wiki.abcdonline.info/Select_record.pft select_record.pft]''' en la carpeta bases. Este formato construye los enlaces con opciones para tratamiento de los registros. Agregarlo en el dbn.par y en los formatos de despliegue  (ver [[Agregar_select_record|Ejemplo]]).<br><br>
+
#:          include ("/abcd/www/htdocs/central/config.php");   //CAMINO DE ACCESO HACIA EL CONFIG.PHP DE ABCD
# Agregar en el archivo '''dbn.par''' las líneas con las rutas de los formatos que se van a utilizar (ver [http://wiki.abcdonline.info/OPAC-ABCD_formatos Formatos de salida])<br><br>
+
#: <br>
# 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>
+
#; Si está instalando el OPAC con la versión 1.6 modifique en php/config_opac.php los parámetros
# Suministrar el login y password del administrador de ABCD y seleccionar el lenguaje que se desea configurar<br><br>. Si tiene problemas de entrada verifique el paso 3 y si el login y password suministrados son los adecuados.
+
#: <br>
# Se presenta un menú con la configuración básica. Ir a cada una de las opciones del menú y llenar los formularios presentados. Si observa que los caracteres acentuados se muestran incorrectamente entre a la opción parámetros y seleccione el '''juego de caracteres de la página''' adecuado. Se recomienda llenar una primera base de datos y probar;  luego que estén todas las bases de datos llenar las secciones de meta-búsqueda.<br><br>
+
#:          $ABCD_scripts_path="/abcd/www/htdocs/";            //path donde están instalados los scripts de abcd
# Una vez que esté lista la configuración para un lenguaje, 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>
+
#:          $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)
 +
 
 +
==Entrada al módulo de configuración==
 +
# 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
 +
# Si el login y password están correctos se presentará el menú principal con las opciones de configuración.
 +
# 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==

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