Difference between revisions of "OPAC-ABCD configuración"
(→Bases de datos disponibles) |
|||
Line 24: | Line 24: | ||
Existe una serie de archivos de configuración los cuales definen el comportamiento del Opac. Estos archivos se actualizan a través de una serie de scripts localizados en la carpeta '''config''' del opac. Para acceder al módulo de configuración acceda a la carpeta '''config''' del directorio donde está instalado el Opac. Se presentará una ventana para solicitar las credenciales del usuario las cuales, una vez validadas, le darán acceso al menú de opciones de configuración. | Existe una serie de archivos de configuración los cuales definen el comportamiento del Opac. Estos archivos se actualizan a través de una serie de scripts localizados en la carpeta '''config''' del opac. Para acceder al módulo de configuración acceda a la carpeta '''config''' del directorio donde está instalado el Opac. Se presentará una ventana para solicitar las credenciales del usuario las cuales, una vez validadas, le darán acceso al menú de opciones de configuración. | ||
− | [[File:Config index.png|izquierda]] | + | [[File:Config index simple.png|izquierda]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | El Id del usuario y la contraseña deben corresponder a un administrador de ABCD. | ||
'''Nota importante'''. Todos los scripts del OPAC leen la configuración establecida en el script | '''Nota importante'''. Todos los scripts del OPAC leen la configuración establecida en el script | ||
'''config.php''' y '''config_extended.php''' del módulo '''central''' | '''config.php''' y '''config_extended.php''' del módulo '''central''' | ||
Line 46: | Line 38: | ||
<big>'''Opciones de configuración'''</big> | <big>'''Opciones de configuración'''</big> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==<font color=darkred>Parámetros globales</font>== | ==<font color=darkred>Parámetros globales</font>== | ||
Line 126: | Line 68: | ||
Estos parámetros se almacenan en ''[carpeta bases]''/opac_conf/opac_abcd.def | Estos parámetros se almacenan en ''[carpeta bases]''/opac_conf/opac_abcd.def | ||
− | |||
− | + | ==<font color=darkred>Idiomas disponibles</font>== | |
+ | |||
+ | Se define una carpeta para cada idioma disponible. Bajo esas carpetas existe el archivo '''lang.tab''' el cual puede modificarse utilizando esta opción de menú de configuración. | ||
+ | |||
+ | [[File:Lang tab.png|ninguna]] | ||
+ | |||
+ | |||
+ | ==<font color=darkred>Bases de datos disponibles</font>== | ||
+ | |||
+ | Define las bases de datos que van a ser utilizadas en la meta-búsqueda o accedidas individualmente (bases.dat) | ||
− | [[File: | + | [[File:Bases dat.png|ninguna]] |
+ | Nombre interno de la base de datos | ||
+ | Nombre externo de la base de datos | ||
+ | Breve descripción del contenido | ||
+ | |||
Line 145: | Line 99: | ||
El ejemplo corresponde la formulario para la meta-búsqueda que se almacenará bajo el nombre de '''avanzada.tab'''. Si se hubiera solicitado una base de datos, '''biblo''' por ejemplo, el formulario se almacenará con el nombre '''biblo_avanzada.tab'''. | El ejemplo corresponde la formulario para la meta-búsqueda que se almacenará bajo el nombre de '''avanzada.tab'''. Si se hubiera solicitado una base de datos, '''biblo''' por ejemplo, el formulario se almacenará con el nombre '''biblo_avanzada.tab'''. | ||
+ | |||
+ | ==<font color=darkred>Formatos de despliegue</font>== | ||
+ | |||
+ | ==<font color=darkred>Facetas</font>== | ||
+ | Las facetas permiten cruzar la búsqueda realizada con otra expresión previamente definida. Para definir facetas seleccione la opción '''Facetas''' del menú de configuración, suministre un nombre a la faceta e inserte la expresión de búsqueda que recupera los registros correspondientes: | ||
+ | [[File:Facetas.png|ninguna]] | ||
+ | |||
+ | Puede existir una definición de facetas a nivel global, o específica para cada base de datos. Si no se proveen facetas específicas para una base de datos se aplica la correspondiente a nivel global (metabúsqueda). Si no desea aplicar facetas sobre una base de datos grabe el archivo correspondiente en blanco. | ||
+ | |||
+ | Cuando existen facetas definidas en la ventana de presentación de resultados se muestra un botón que permite mostrar la usuario los cruces que puede realizar | ||
+ | |||
+ | [[File:Facetas boton.png|ninguna]] | ||
+ | |||
+ | Al dar clic sobre el botón ser muestran las facetas definidas para esa base de datos | ||
+ | |||
+ | [[File:Facetas menu.png|ninguna]] | ||
+ | |||
+ | Al seleccionar una faceta de constfruye una nueva expresión agregando a la expresión de búsqueda existente, con el operador '''and''', la expresión asociada a la faceata seleccionada | ||
+ | |||
+ | |||
+ | ==<font color=darkred>Mensajes del sistema</font>== | ||
+ | |||
+ | |||
+ | ==<font color=darkred>Estilos, encabezado, pie de página</font>== | ||
+ | |||
+ | Algunos elementos del archivo de estilos '''styles.css''' pueden ser alterados para modificar colores, tipos de letra y tamaño de las mismas. los elementos que pueden modificarse se indican a continuación: | ||
+ | |||
+ | [[File:Estilos 2.png|ninguna]] | ||
+ | |||
+ | |||
+ | |||
Line 187: | Line 172: | ||
Una vez indizada la base de datos acceda a la opción '''Búsqueda avanzada - Tipos de registro''' y llene el formulario correspondiente | Una vez indizada la base de datos acceda a la opción '''Búsqueda avanzada - Tipos de registro''' y llene el formulario correspondiente | ||
[[File:Configuracion busquedaav tiposregistro.png|ninguna]] | [[File:Configuracion busquedaav tiposregistro.png|ninguna]] | ||
+ | |||
+ | ==<font color=darkred>Formato de despliegue</font>== | ||
==<font color=darkred>Índices alfabéticos</font>== | ==<font color=darkred>Índices alfabéticos</font>== | ||
Line 206: | Line 193: | ||
Si se selecciona un tipo de material, la lista alfabética se forma a partir de los términos correspondientes a ese tipo de material. De ahí la necesidad de crear en la FST la indización mencionada en '''Búsqueda avanzada - Tipos de registro''' | Si se selecciona un tipo de material, la lista alfabética se forma a partir de los términos correspondientes a ese tipo de material. De ahí la necesidad de crear en la FST la indización mencionada en '''Búsqueda avanzada - Tipos de registro''' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | '''Nota: para configuración avanzada''' | |
+ | |||
+ | La '''Carpeta de Bases de Datos''' nos provee la opción de acceder a diferentes carpetas '''bases''' para verificar el comportamiento del OPAC. Para definir la lista de carpetas '''bases''' disponibles, coloque en la carpeta '''php''' de la carpeta '''opac_abcd''', el archivo '''opac_dbpath.dat''' con el siguiente contenido: | ||
+ | |||
+ | /websites/prueba_opac/bases/|Versión en ANSI | ||
+ | /websites/prueba_opac_utf8/bases/|Versión en UTF-8 | ||
+ | |||
+ | La información que está antes del signo '''|''' corresponde la ruta hacia la carpeta bases identificada con el valor ubicado a la derecha del signo '''|'''. | ||
+ | |||
+ | Si el archivo '''opac_dbpath.dat''' no existe entonces se usa como carpeta de bases de datos aquella identificada en el script '''config.php''' del módulo '''central''' | ||
+ | |||
+ | ==Juego de caracteres disponibles== | ||
+ | |||
+ | Para bases de datos mantenidas en ABCD, permite definir la secuencia ascendente del juego de caracteres que componen la lengua en la cual se mantienen los registros. El Opac de ABCD identifica dos juegos de caracteres: | ||
+ | ISO-8859-1 | ||
+ | UTF-8 | ||
+ | Los cuales están representados en las subcarpetas respectivas de la carpeta '''alpha''' | ||
+ | |||
+ | [[File:Carpeta alpha.png|none]] | ||
+ | |||
+ | El parámetro '''$charset''' de '''config.php''' define la carpeta donde se van a almacenar las tablas de juego de caracteres. Esta opción presenta la siguiente ventana de captura de información: | ||
+ | |||
+ | [[File:Charset.png|none]] | ||
+ | |||
+ | Para cada juego de caracteres disponibles se debe suministrar su nombre y la secuencia ascendente de los caracteres que componen el idioma. Posteriormente esta información se utilizará para asociar estas tablas a las bases de datos y presentar la secuencia el los índices alfabéticas y el diccionario de términos para navegar en ellos: | ||
+ | [[File:Goto character.png|none]] | ||
+ | |||
+ | El menú desplegable contendrá la lista de lenguajes vinculados a la base de datos. | ||
+ | |||
+ | |||
+ | |||
+ | Juego de caracteres a utilizar en los registros | ||
+ | |||
+ | Los juegos de caracteres son aquellos definidos en [[OPAC-ABCD_configuración#Juego_de_caracteres_disponibles|Juego de caracteres disponibles]] | ||
+ | |||
+ | Las columnas '''nombre interno''' y '''nombre externo''' se almacenan en el archivo '''bases.dat''' | ||
+ | |||
+ | La '''breve descripción del contenido''' se almacena en ''[dbn]''.def | ||
+ | |||
+ | Los juegos de caracteres asignados se almacenan en ''[dbn]'.lang | ||
+ | |||
+ | ''[dbn]'' es el nombre de la base de datos. | ||
− | + | De no asignarse un juego de caracteres se asume la secuencia alfabética LATIN | |
+ | 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z | ||
− | + | Estos recursos se almacenan en la carpeta del idioma actualmente seleccionado. |
Revision as of 10:13, 23 January 2020
Estructura de carpetas y archivos de configuración
Para configurar el OPAC debe definir unas ciertas tablas y archivos de configuración que almacenan en una carpeta denominada opac_conf que debe definirse en la carpeta donde se almacenan las bases de datos de ABCD. Las tablas se guardarán en la carpeta correspondiente al lenguaje que esté seleccionado
Configuración del OPAC
Existe una serie de archivos de configuración los cuales definen el comportamiento del Opac. Estos archivos se actualizan a través de una serie de scripts localizados en la carpeta config del opac. Para acceder al módulo de configuración acceda a la carpeta config del directorio donde está instalado el Opac. Se presentará una ventana para solicitar las credenciales del usuario las cuales, una vez validadas, le darán acceso al menú de opciones de configuración.
El Id del usuario y la contraseña deben corresponder a un administrador de ABCD.
Nota importante. Todos los scripts del OPAC leen la configuración establecida en el script config.php y config_extended.php del módulo central
Una vez validadas las credenciales del usuario se accede al menú para establecer/configurar las opciones del OPAC. Desde el menú desplegable Idiomas puede seleccionar la carpeta en la cual se almacenarán los archivos de configuración
Nota: Se puede realizar toda la configuración en un idioma. Luego, al cambiar de idioma Se provee una opción para poder copiar los archivos de configuración ya definidos en otro idioma, siendo solo necesario traducir los textos descriptivos
Opciones de configuración
Contents
- 1 Parámetros globales
- 2 Idiomas disponibles
- 3 Bases de datos disponibles
- 4 Búsqueda avanzada
- 5 Formatos de despliegue
- 6 Facetas
- 7 Mensajes del sistema
- 8 Estilos, encabezado, pie de página
- 9 Tipos de registro
- 10 Búsqueda avanzada - Tipos de registro
- 11 Formato de despliegue
- 12 Índices alfabéticos
- 13 Juego de caracteres disponibles
Parámetros globales
Contiene parámetros generales del Opac, como son:
URL donde está ubicado el logo | Url desde el cual se obtiene el logo de la página. Si está localizado en la carpeta images de opac_abcd se puede suministrar como direccionamiento relativo: ../images/circulos.png, de otra forma, debe suministar el URL completlo |
Página a visualizar al dar clic sobre el logo | Página a acceder si el usuario da clic sobre el logo |
Título de la página HTML | Corresponde al tag <title> de la sección <head> de la página HTML |
Pie de página | Es la información que aparecerá al final de cada página HTML desplegada (a menos que exista el archivo footer.info en la carpeta bases/opac_conf/lang |
Http al módulo central (http://xxx.xxx) | Utilizado para poder acceder a scripts del módulo central cuando sea requerido (especialmente en el caso de préstamos y reservas) |
Camino de acceso a la carpeta Bases | Si no se quiere usar la carpeta bases establecida en el config.php de ABCD entonces se usa esta carpeta bases, a menos que se haya leído una diferente desde el archivo 'opac_dbpath.dat seleccionado en el index.php |
Juego de caracteres de la página | Indica el juego de caracteres con el que todas las páginas, archivos de configuración, bases de datos, etc. están ingresados para establecer el tag <meta http-equiv="content-type" content="text/html; charset=UTF-8" /> así como las directrices que hay que suministrar al PHP para la correcta interpretación de la información a ser enviada header('Content-Type: text/html; charset=UTF-8')
Nota: charset puede ser UT-8 o ISO-8859-1 dependiendo de la codificación de las páginas, archivos de configuración y bases de datos |
Estos parámetros se almacenan en [carpeta bases]/opac_conf/opac_abcd.def
Idiomas disponibles
Se define una carpeta para cada idioma disponible. Bajo esas carpetas existe el archivo lang.tab el cual puede modificarse utilizando esta opción de menú de configuración.
Bases de datos disponibles
Define las bases de datos que van a ser utilizadas en la meta-búsqueda o accedidas individualmente (bases.dat)
Nombre interno de la base de datos Nombre externo de la base de datos Breve descripción del contenido
Búsqueda avanzada
Esta opción permite editar el formulario de búsqueda avanzada. Presenta a su vez un menú con los diferentes niveles de búsqueda: meta-búsqueda o una base de datos individual:
La selección de una opción presentará el formulario para la búsqueda avanzada:
El ejemplo corresponde la formulario para la meta-búsqueda que se almacenará bajo el nombre de avanzada.tab. Si se hubiera solicitado una base de datos, biblo por ejemplo, el formulario se almacenará con el nombre biblo_avanzada.tab.
Formatos de despliegue
Facetas
Las facetas permiten cruzar la búsqueda realizada con otra expresión previamente definida. Para definir facetas seleccione la opción Facetas del menú de configuración, suministre un nombre a la faceta e inserte la expresión de búsqueda que recupera los registros correspondientes:
Puede existir una definición de facetas a nivel global, o específica para cada base de datos. Si no se proveen facetas específicas para una base de datos se aplica la correspondiente a nivel global (metabúsqueda). Si no desea aplicar facetas sobre una base de datos grabe el archivo correspondiente en blanco.
Cuando existen facetas definidas en la ventana de presentación de resultados se muestra un botón que permite mostrar la usuario los cruces que puede realizar
Al dar clic sobre el botón ser muestran las facetas definidas para esa base de datos
Al seleccionar una faceta de constfruye una nueva expresión agregando a la expresión de búsqueda existente, con el operador and, la expresión asociada a la faceata seleccionada
Mensajes del sistema
Estilos, encabezado, pie de página
Algunos elementos del archivo de estilos styles.css pueden ser alterados para modificar colores, tipos de letra y tamaño de las mismas. los elementos que pueden modificarse se indican a continuación:
Tipos de registro
Opcionalmente, se pueden establecer sub-conjuntos de registros al interior de la base de datos utilizando tipos de registro o cualquier otro valor indizable en la FST. Esto proveerá al usuario de un nivel de búsqueda más restringido agrupando solo el sub-conjunto seleccionado:
Esta lista se despliega al tocar el botón MENU de la barra superio.
Para activar esta opción debe:
- Codificar en la FST el prefijo y valores que construyen los sub-conjuntos de registros. Ejm:
2 0 'TM_',v2,v4
- Llenar el formulario de configuración correspondiente
De esta forma, al hacer clic sobre un tipo de registro se utilizará el prefijo y el código para realizar una búsqueda y recuperar el subconjunto de información solicitado
Búsqueda avanzada - Tipos de registro
Para que esta opción funcione debe definirse los tipos de registro en el paso anterior.
Opcionalmente, puede definir un formulario de búsqueda avanzada que contemple sólo los términos de un tipo de registro. Para ello, debe definir en la FST un conjunto de claves que incorporen el tipo de registro en el prefijo. Ejemplo:
245 0 (if p(v245) then 'X', v2[1],v4[1],'TI_',v245^a fi '%'/) 100 0 (if p(v100^a) then 'X', v2[1],v4[1],'AU_',v100^a fi '%'/) 1773 0 (if p(v773^t) then 'X', v2[1],v4[1],'TR_',v773^t fi,'%'/) 650 0 (if p(v650^a) then 'X', v2[1],v4[1],'MA_',v650^a,fi,'%'/), 651 0 (if p(v651^a) then 'X', v2[1],v4[1],'DG_',v651^a,fi,'%'/),
Estas claves tienen la siguiente característica:
- El prefijo debe comenzar con la letra X
- A continuación debe especificarse el tipo de material. Note la construcción v2[1],v4[1] ya que el tipo de registro (no repetible) está incluido en un grupo repetible
- Coloque luego el prefijo que identifica el campo que se indiza y a continuación el valor del campo
Una vez indizada la base de datos acceda a la opción Búsqueda avanzada - Tipos de registro y llene el formulario correspondiente
Formato de despliegue
Índices alfabéticos
Los indices alfabéticos representan una forma alternativa de localizar información en la base de datos utilizando listas alfabéticas del contenido de algunos campos:
La selección de una opción presentará la lista alfabética del campo solicitado:
Al igual que las Listas de autoridades del módulo central de ABCD para la extracción de los índices se requiere un archivo especial denominado autoridades_opac.pft que tiene la misma función del equivalente del módulo de ingreso (ver Control de terminología: Listas de autoridades). Este archivo puede ubicarse en la misma carpeta de los formatos de despliegue y ser referido a través del dbn.par de cada base de datos (puede construirse un solo autoridades_opac.pft y hacer referencia al mismo en el dbn.par)
Si no se selecciona alguna base de datos, entonces la lista alfabética representa un consolidado de las listas alfabéticas del campo de cada base de datos incluida en el archivo bases.dat. Al hacer clic sobre una entrada del índice, se presentarán los registros extraídos de la base de datos a la cual pertenecen.
Si se selecciona una base de datos en particular, la lista alfabética se forma a partir de los términos de ella.
Si se selecciona un tipo de material, la lista alfabética se forma a partir de los términos correspondientes a ese tipo de material. De ahí la necesidad de crear en la FST la indización mencionada en Búsqueda avanzada - Tipos de registro
Nota: para configuración avanzada
La Carpeta de Bases de Datos nos provee la opción de acceder a diferentes carpetas bases para verificar el comportamiento del OPAC. Para definir la lista de carpetas bases disponibles, coloque en la carpeta php de la carpeta opac_abcd, el archivo opac_dbpath.dat con el siguiente contenido: /websites/prueba_opac/bases/|Versión en ANSI /websites/prueba_opac_utf8/bases/|Versión en UTF-8
La información que está antes del signo | corresponde la ruta hacia la carpeta bases identificada con el valor ubicado a la derecha del signo |.
Si el archivo opac_dbpath.dat no existe entonces se usa como carpeta de bases de datos aquella identificada en el script config.php del módulo central
Juego de caracteres disponibles
Para bases de datos mantenidas en ABCD, permite definir la secuencia ascendente del juego de caracteres que componen la lengua en la cual se mantienen los registros. El Opac de ABCD identifica dos juegos de caracteres:
ISO-8859-1 UTF-8
Los cuales están representados en las subcarpetas respectivas de la carpeta alpha
El parámetro $charset de config.php define la carpeta donde se van a almacenar las tablas de juego de caracteres. Esta opción presenta la siguiente ventana de captura de información:
Para cada juego de caracteres disponibles se debe suministrar su nombre y la secuencia ascendente de los caracteres que componen el idioma. Posteriormente esta información se utilizará para asociar estas tablas a las bases de datos y presentar la secuencia el los índices alfabéticas y el diccionario de términos para navegar en ellos:
El menú desplegable contendrá la lista de lenguajes vinculados a la base de datos.
Juego de caracteres a utilizar en los registros
Los juegos de caracteres son aquellos definidos en Juego de caracteres disponibles
Las columnas nombre interno y nombre externo se almacenan en el archivo bases.dat
La breve descripción del contenido se almacena en [dbn].def
Los juegos de caracteres asignados se almacenan en [dbn]'.lang
[dbn] es el nombre de la base de datos.
De no asignarse un juego de caracteres se asume la secuencia alfabética LATIN
0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Estos recursos se almacenan en la carpeta del idioma actualmente seleccionado.