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

From ABCD Wiki
Jump to: navigation, search
 
(16 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
# 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])
 
# 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])
 
# 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 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
+
# 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
 
# 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'''.
 
# 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:   
 
#:    Ejm:   
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/). En ese momento se realiza la verificación del camino de acceso hacia el config.php de ABCD (ver punto 5)
# 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 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 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á 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 el login y password están correctos se presentará el menú principal con las opciones de configuración.
# Una vez completada la configuración general, el menú principal presentará las opciones para configurar las bases de datos
+
# 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:
      Nota: Se recomienda configurar una primera base de datos para comenzar. Luego ir agregando progresivamente el resto de  
+
#: Mostrar/Esconder la ayuda  / Traducir la ayuda
            las bases de dato.
+
#: 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.
            Tenga en cuenta que al agregar una segunda base de datos se activará la meta-búsqueda. Si no la ha configurado
+
 
            entonces usará la configuración de búsqueda avanzada definida para la primera base de datos
+
===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
  
==Configurar bases de datos==
+
===Configuración de las bases de datos===
===Configuración básica===
+
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'''
* Llenar el formulario de búsqueda libre
+
  Nota importante:
* Llenar el formulario de búsqueda avanzada
+
  Esta configuración corresponde al idioma seleccionado. Por lo tanto los archivos generados
* Seleccionar o preparar los formatos de despliegue
+
  se almacenarán en la carpeta correspondiente a dicho idioma
* 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:
+
====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
 
       formato.pft=%path_database%dbn/pfts/%lang%/formato.pft
 
       donde:
 
       donde:
Line 39: Line 52:
 
       dbn            es el nombre de la base de datos
 
       dbn            es el nombre de la base de datos
 
       %lang%          es el nombre del parámetro que será reemplazado al momento de
 
       %lang%          es el nombre del parámetro que será reemplazado al momento de
                       ejecución por el lenguaje activo
+
                       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
+
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.
* 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.
+
====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.
 
* 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===
+
 
 +
====Configuración 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==

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