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

From ABCD Wiki
Jump to: navigation, search
 
(39 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
==Instalación==
 
==Instalación==
* 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]
* 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''' de ABCD, el camino de acceso hacia la carpeta central y el url para acceder al 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:   
+
#:    Ejm:   
          include ("/abcd/www/htdocs/central/config.php");  //CAMINO DE ACCESO HACIA EL CONFIG.PHP DE ABCD
+
#:          include ("/abcd/www/htdocs/central/config.php");  //CAMINO DE ACCESO HACIA EL CONFIG.PHP DE ABCD
          $ABCD_scripts_path="/abcd/www/htdocs/";            //path donde están instalados los scripts de abcd
+
#: <br>
          $server_url="http://127.0.0.1:9001";              //El url que se usa para acceder al opac
+
#; Si está instalando el OPAC con la versión 1.6 modifique en php/config_opac.php los parámetros
+
#: <br>
* 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
+
#:          $ABCD_scripts_path="/abcd/www/htdocs/";            //path donde están instalados los scripts de abcd
* Bajo '''opac_conf''' agregue una sub-carpeta para cada lenguaje que vaya utilizar (ejm: es, fr, pt, en ...)
+
#:          $server_url="http://127.0.0.1:9001";              //El url que se usa para acceder al módulo central
* Ejecute el módulo de configuración desde donde haya instalado el OPAC (ejm: http://localhost:9091/opac_abcd/config/). Se ejecutará la configuración de la carpeta establecida en '''config.php''' de ABCD.
+
#: <br>
* Proporcione el login y el password del administrador de ABCD. La tabla de mensajes que se utiliza en esta entrada es aquella definida en el módulo central de ABCD
+
#: colocando los valores correspondientes a su instalación
* Se presentará la página de '''Configuración general''' donde debe llenar cada una de las opciones solicitadas. El botón de ayuda le proporcionará explicaciones adicionales sobre la información solicitada
+
# 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
      Nota: se recomienda definir primero una sola bases de datos y luego ir agregando una a una a la
+
# Bajo '''opac_conf''' agregue una sub-carpeta para cada lenguaje que vaya utilizar (ejm: es, fr, pt, en ...)
            lista de bases de datos disponibles    
+
# 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)
* Una vez completada la configuración general el menú principal presentará las opciones para configurar las bases de datos
+
 
      Nota: Se recomienda definir una sola base de datos para comenzar y luego ir
+
==Entrada al módulo de configuración==
==Configurar bases de datos==
+
# 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
===Configuración básica===
+
# Si el login y password están correctos se presentará el menú principal con las opciones 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>
+
# 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:
* Si no tiene clara la definición de facetas no tiene por qué llenarla<br><br>
+
#: Mostrar/Esconder la ayuda  / Traducir la ayuda
* 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>
+
#: 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.
* 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>
+
===Configuración General===
* 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>
+
Ejecute las opciones que se encuentran bajo '''Configuración General''':
* 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>
+
*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==
 
==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