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

From ABCD Wiki
Jump to: navigation, search
(Entrada al módulo de configuración)
Line 16: Line 16:
 
# 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
 
# 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 ...)
 
# Bajo '''opac_conf''' agregue una sub-carpeta para cada lenguaje que vaya utilizar (ejm: es, fr, pt, en ...)
# En este momento puede verificar la configuración general ejecutando en el browser el script '''[directorio-del-OPAC]/config/diagnostico.php''' desde donde haya instalado el OPAC (ejm: http://localhost:9091/opac_abcd/config/diagnostico.php).  Este script revisará si los parámetros y directorios iniciales han sido establecidos correctamente.
 
 
# Ejecute el módulo de configuración desde donde haya instalado el OPAC (ejm: http://localhost:9091/opac_abcd/config/).  
 
# Ejecute el módulo de configuración desde donde haya instalado el OPAC (ejm: http://localhost:9091/opac_abcd/config/).  
 
==Entrada al módulo de configuración==
 
==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 algun error verifique que el punto 5 de la instalación '''''(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)''''' haya sido ejecutado correctamente
 
# 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 algun error verifique que el punto 5 de la instalación '''''(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)''''' haya sido ejecutado correctamente
# Si desea que se abra la página de ayuda documentada en abcdwiki marque la casilla identificada como '''Mostrar páginas de ayuda'''
+
# Si el login y password están correctos se presentará el menú principal con las opciones de configuración.
# Si el login y password están correctos se presentará la página de '''Configuración general''' donde debe llenar cada una de las opciones establecidas. El botón de ayuda le proporcionará explicaciones adicionales sobre la información solicitada
+
# Si desea que con cada menú u hoja de entrada se abra la página de ayuda documentada en wiki.abcdonline.info, seleccione la opción Parámetros del menú principal y luego marque su preferencia en el parámetro correspondiente a '''Mostrar páginas de ayuda'''
# Una vez completada la configuración general, el menú principal presentará las opciones para configurar las bases de datos
+
===Configuración General===
      Nota: Se recomienda configurar una primera base de datos para comenzar. Luego ir agregando progresivamente el resto de  
+
# Ejecute las opciones que se encuentran bajo '''Configuración General'''.
            las bases de dato.
+
#*Parámetros
            Tenga en cuenta que al agregar una segunda base de datos se activará la meta-búsqueda. Si no la ha configurado
+
#*Idiomas disponibles
            entonces usará la configuración de búsqueda avanzada definida para la primera base de datos
+
#*Bases de datos disponibles
 +
#*Barra de herramienta de registros
 +
#;La explicación se muestra en el formulario de entrada correspondiente a cada opción
 +
===Configuración de las bases de datos===
 +
====Básica====
 +
# Configure las base de datos tomadas del archivo bases.dat creado en la opción '''Bases de datos disponibles''' de '''Configuración general'''. Debe llenar los formularios:
 +
#*Búsqueda Libre
 +
#*Búsqueda Avanzada
 +
#*Formatos de despliegue
 +
#*Verificar y actualizar el dbn.par.  
 +
#::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
 +
#;Esta opción agregará al dbn.par los formatos definidos en formatos.dat
 +
#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 con el mismo prefijo.
 +
* Una vez que esté lista la configuración básica para un lenguaje entrar al Opac y realizar pruebas.
  
==Configurar bases de datos==
 
===Configuración básica===
 
* Llenar el formulario de búsqueda libre
 
* Llenar el formulario de búsqueda avanzada
 
* Seleccionar o preparar los formatos de despliegue
 
* Editar el archivo .par de la base de datos agregando los formatos y la referencia a la barra de herramientas del registro la cual se almacenó en el directorio '''opac_conf''' a través de la opción '''Configuración General''' -> '''Barra de herramientas del registro''' localizada en el menú principal de la configuracion. 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
 
* La barra de herramienta de registros se coloca en el dbn.par de la siguiente manera:
 
    select_record.pft=%path_database%select_record.pft
 
* 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.
 
* Una vez que esté lista la configuración básica para un lenguaje entrar al Opac y realizar pruebas.
 
* Puede utilizar la opción '''Copiar archivos de configuración''' del menú de configuración de las bases de datos 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>
 
  
===Configuración Avanzada===
+
====Avanzada====
  
 
==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==

Revision as of 22:46, 8 October 2020

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 el archivo opac.tab contenido en lang/00 a la carpeta de lenguajes de la carpeta de bases de datos (Ejm: /bases/lang/00). Este archivo contiene los mensajes del OPAC
  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/).

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 algun error verifique que el punto 5 de la instalación (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) 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. Si desea que con cada menú u hoja de entrada se abra la página de ayuda documentada en wiki.abcdonline.info, seleccione la opción Parámetros del menú principal y luego marque su preferencia en el parámetro correspondiente a Mostrar páginas de ayuda

Configuración General

  1. 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 se muestra en el formulario de entrada correspondiente a cada opción

Configuración de las bases de datos

Básica

  1. Configure las base de datos tomadas del archivo bases.dat creado en la opción Bases de datos disponibles de Configuración general. Debe llenar los formularios:
    • Búsqueda Libre
    • Búsqueda Avanzada
    • Formatos de despliegue
    • Verificar y actualizar el dbn.par.
    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
    Esta opción agregará al dbn.par los formatos definidos en formatos.dat
  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.

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 con el mismo prefijo.
  • Una vez que esté lista la configuración básica para un lenguaje entrar al Opac y realizar pruebas.


Avanzada

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