Documentación de usuario¶
Introducción¶
En este apartado se pretende dotar al usuario de la información necesaria para la correcta utilización de la aplicación. En primer lugar, se especificarán los requisitos software con los que el usuario debe contar para acceder a la aplicación. Posteriormente, se explicará paso a paso el proceso de instalación y, finalmente, se mostrará el manual de usuario.
Requisitos de usuario¶
Los requisitos de usuario varían en función del modo de instalación que vaya a llevar a cabo el usuario. Existen tres modos de instalación: Manual, Docker y Kubernetes.
Como es lógico, además de los requisitos que se van a mostrar a continuación, se debe contar con un navegador web desde el que se pueda acceder a la aplicación web.
Manual¶
Si se escoge la opción manual hay que estar seguro de que el servidor cumple con todos y cada uno de los siguientes requisitos:
Sistema Operativo Linux
Apache HTTP Server (con el módulo rewrite activado)
MySQL / MariaDB v5.0 o superior.
PHP v5.4 o superior con las sisguientes extensiones instaladas:
- mysqli
- exif
- curl
- mbstring
ImageMagick (Tratamiento de imágenes)
Ver también
Docker¶
En este caso, solo es necesario un único requisito:
- Docker (Probado con la versión 19.03.6).
Ver también
Kubernetes¶
Si se pretende utilizar Kubernetes para el despliegue de la infraestructura se requiere:
- Docker
- La herramienta de línea de comandos de Kubernetes, kubectl (Probado en v1.18.2).
- Kustomize (probado en v3.1.0)
Ver también
Instalación¶
Como se ha comentado en el apartado anterior, existen tres posibilidades distintas para instalar la aplicación en un servidor: Manual, Docker o Kubernetes.
Manual¶
Nota
Para el siguiente tutorial se ha utilizado como S.O Ubuntu 19.10
Advertencia
¡ Es muy importante comprobar que se cumplen todos los Requisitos de usuario !
El primer paso consiste en configurar el servidor. Para ello, hay que seguir una serie de indicaciones:
Crear la base de datos (DB) MySQL desde un usuario con permisos suficientes como para poder realizar operaciones sobre ella.
Durante el proceso, conviene apuntar los siguientes datos:
- Hostname donde se encuentra alojada la DB.
- Nombre de la DB.
- Nombre del usuario de la DB.
- Contraseña de usuario de la DB.
La base de datos ha de estar codificada en
utf8.
sudo mysql -u root -p
CREATE DATABASE omekadb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'usuario'@'localhost' IDENTIFIED BY 'contraseña';
GRANT ALL ON omekadb.* TO 'usuario'@'localhost' IDENTIFIED BY 'contraseña' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;
- Descargar la version 2.7.1 de Omeka, desde su web oficial o desde su repositorio oficial en GitHub.
cd /tmp && wget https://github.com/omeka/Omeka/releases/download/v2.7.1/omeka-2.7.1.zip
- Descomprimir el fichero
.ziprecién descargado sobre un directorio desde donde podamos trabajar.
unzip omeka-2.7.1.zip -d <directorio_de_trabajo>
- Desde el directorio escogido, buscar el fichero
db.iniy sustituir los valores “XXXXX” por los datos de la base de datos (anotados en el paso 1).
cd <directorio_de_trabajo>/omeka-2.7.1
nano db.ini
No es necesario modificar los parámetros ``prefix`` o ``port``.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; Database Configuration File ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;
; Omeka requires MySQL 5 or newer.
;
; To configure your database, replace the X's with your specific
; settings. If you're unsure about your database information, ask
; your server administrator, or consult the documentation at
; <http://omeka.org/codex/Database_Configuration_File>.
[database]
host = "localhost"
username = "usuario"
password = "contraseña"
dbname = "omekadb"
prefix = "omeka_"
charset = "utf8"
;port = ""
- Descargar el contenido del repositorio del proyecto.
cd /tmp && wget https://github.com/gcm1001/TFG-CeniehAriadne/archive/master.zip
- Descomprimir las carpetas
/omeka/pluginsy/omeka/themesdel fichero.ziprecién descargado.
unzip master.zip 'TFG-CeniehAriadne-master/omeka/plugins/*' 'TFG-CeniehAriadne-master/omeka/themes/*' -d <*directorio_de_trabajo*>
- Desde el directorio de trabajo, reemplazar las carpetas originales plugins y themes por las previamente descargadas.
cd <directorio_de_trabajo>
rm -rf ./omeka-2.7.1/plugins ./omeka-2.7.1/themes
sudo cp -r ./TFG-CeniehAriadne-master/omeka/* ./omeka-2.7.1
rm -rf ./TFG-CeniehAriadne-master
- Mover todo el contenido del directorio de trabajo a la carpeta del servidor Apache.
mv <*directorio_de_trabajo*>/omeka-2.7.1/* <*directorio_del_servidor*>
- Dar permisos de lectura y escritura sobre el directorio /files/ de la aplicación.
sudo chown -R www-data:www-data <directorio_del_servidor>/files
sudo chmod -R 755 <directorio_del_servidor>/files
- Configurar el servidor Apache:
10.1. Crear el archivo de configuración correspondiente a la aplicación.
nano /etc/apache2/sites-available/omeka.confCambiar los valores entre comillas (» «).
<VirtualHost *:80> ServerAdmin "correo_administrador" DocumentRoot "directorio_del_servidor" ServerName "nombre_del_servidor" <Directory /var/www/> Options FollowSymlinks AllowOverride All Require all granted </Directory> ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined </VirtualHost>
- Activar el sitio y el módulo rewrite y reiniciar el servidor para aplicar los cambios.
a2dissite 000-default.conf a2ensite omeka.conf a2enmod rewrite systemctl restart apache2.service
Desde este instante, la aplicación será accesible desde el navegador (puerto 80). El último paso consiste en completar la instalación guiada desde el navegador, disponible en el directorio /install (e.g http://aplicacion.es/install).
Una vez instalada la aplicación, para poder disfrutar de todas las mejoras propuestas en este proyecto, se deben instalar tanto los plugins como el tema propuesto (ver Instalar complementos (plugins) e Instalar temas (themes))
Advertencia
Por temas de seguridad, conviene eliminar la carpeta /install/ del directorio raíz una vez terminada la instalación de la aplicación.
Ver también
Docker¶
Advertencia
¡ Es muy importante comprobar que se cumplen todos los Requisitos de usuario !
Nota
Para el siguiente tutorial se ha utilizado como S.O Ubuntu 19.10
Para proceder al despliegue se deben descargar, del repositorio del proyecto, los siguientes ficheros:
/Dockerfile/docker-compose.yml/ConfigFiles/*.modificar/omeka/plugins/*
Advertencia
Mantén los subdirectorios intactos.
A continuación debes compilar la imagen. Para ello, desde el directorio donde hayas almacenado la descarga anterior, ejecuta el siguiente comando:
docker build -t nombre_imagen:tag .
Recuerda muy bien el nombre de la imagen y el tag que pongas porque será necesario para el siguiente paso, que consiste en configurar el archivo docker-compose.yml.
En él, solo tenemos que cambiar la etiqueta image del servicio omeka_app con el nombre y el tag de la imagen recién compilada:
...
omeka_app:
image: nombre_imagen:tag
Si se ha publicado la imagen en DockerHub, se puede hacer referencia a esta indicando el nombre de usuario seguido de la imagen (e.g. username/nombre_de_mi_imagen:tag).
Advertencia
Elimina el servicio omeka-db-admin si tu servidor está destinado a producción. Este servicio incorpora la herramienta PhpMyAdmin a la infraestructura, la cual tiene un alto grado de vulnerabilidades.
Por último, se crean los secrets correspondientes a las contraseñas de la base de datos:
echo 'contraseña_usuario_db' | docker secret create omeka_db_password -
echo 'contraseña_root_db' | docker secret create omeka_db_root_password -
cp configFiles/db.ini.modificar configFiles/db.ini
cp configFiles/mail.ini.modificar configFiles/mail.ini
Advertencia
Debes modificar los ficheros recién creados (db.ini y mail.ini con los datos relacionados con la base de datos y el protocolo IMAP. Ten en cuenta que la contraseña que introduzcas en el fichero tiene que coincidir con la del secret omeka_db_password.
Ahora ya se puede desplegar la infraestructura ejecutando el siguiente comando desde el directorio de trabajo (donde se encuentra la descarga del primer paso).
docker stack deploy -c docker-compose.yml nombre_del_entorno
Desde este instante la aplicación es accesible desde el navegador (puerto 80). Los siguientes pasos son los mismos que en la instalación manual.
Kubernetes¶
Advertencia
¡ Es muy importante comprobar que se cumplen todos los Requisitos de usuario !
Nota
Para el siguiente tutorial se ha utilizado como S.O Ubuntu 19.10
El primer paso para desplegar la aplicación mediante Kubernetes es montar nuestra imagen Docker (Sigue los primeros pasos del punto anterior, hasta la compilación de la imagen).
El siguiente paso consiste en desplegar la aplicación. Para esta tarea utilizo el gestor de objetos Kustomize. Por ello, deberás contar con dicha herramienta. Además debes estar en posesión de los siguientes ficheros alojados en este repositorio:
/kustomization.yaml/patch.yaml/gke-mysql/*/gke-omeka/*/configFiles/*.gke
Se deben definir en el servidor los secrets y configMaps utilizados por los ficheros de configuración .yaml.
Para ello se ejecutan los siguientes comandos:
Advertencia
Sustituir los <valores> por los datos apropiados.
- omeka-db: secretos relacionados con la base de datos.
kubectl create secret generic omeka-db \
--from-literal=user-password=<contraseña_db_usuario> \
--from-literal=root-password=<contraseña_db_root> \
--from-literal=username=<nombre_usuario>\
--from-literal=database=<nombre_bd>
- omeka-snmp: secretos relacionados con el protocolo SNMP.
kubectl create secret generic omeka-snmp \
--from-literal=host=<host_snmp> \
--from-literal=username=<correo_electronico> \
--from-literal=password=<contraseña_correo> \
--from-literal=port=<puerto_snmp> \
--from-literal=ssl=<protocolo_seguridad_snmp>
- omeka-imap: secretos relacionados con el protocolo IMAP.
kubectl create secret generic omeka-imap \
--from-literal=host=<host_imap> \
--from-literal=username=<correo_electronico> \
--from-literal=password=<contraseña_correo> \
--from-literal=port=<puerto_imap> \
--from-literal=ssl=<protocolo_seguridad_imap>
- db-config: mapa de configuración para la base de datos.
kubectl create configmap db-config \
--from-file=./configFiles/db.ini.gke
- snmp-config: mapa de configuración para el protocolo SNMP.
kubectl create configmap snmp-config \
--from-file=./configFiles/config.ini.gke
- imap-config: mapa de configuración para el protocolo IMAP.
kubectl create configmap imap-config \
--from-file=./configFiles/mail.ini.gke
Por último, debemos indicar el identificador de nuestra imagen Docker en el fichero /gke-omeka/deployment.yaml.
...
spec:
containers:
- image: nombre_imagen:tag
...
Tras esto, solo faltaría ejecutar, desde el directorio raíz, el siguiente comando:
kustomize build . | kubectl apply -f -
Desde este instante la aplicación es accesible desde el navegador (puerto 80). Los siguientes pasos son los mismos que en la instalación manual.
Manual de usuario¶
Advertencia
Este manual de usuario no es válido para la versión original de Omeka Classic. Ciertos aspectos de la aplicación han sido alterados por los complementos/plugins instalados y el tema escogido. Por lo tanto, antes de seguir leyendo, comprueba que se ha instalado el tema y todos los plugins indicados en el apartado Instalación.
Nota
Para acceder al manual de usuario original, pulsa aquí.
Área de administración¶
La zona de administración es el lugar desde donde el cual se gestionan los conjuntos de datos almacenados en la plataforma y, además, se pueden configurar otros aspectos de la aplicación como, por ejemplo, su diseño, seguridad, usuarios, etc.
Este área se encuentra ubicado en la ruta /admin desde la raíz del directorio donde se encuentra la aplicación. Si, por ejemplo, hemos accedido desde la URL www.aplicacion.es, al acceder a www.aplicacion.es/admin se nos mostrará la pantalla de inicio de sesión al sistema.
Después de introducir un nombre de usuario y contraseña válidos, se debe pulsar sobre el botón «Login». Si todo es correcto, accederemos al interior de la zona de administración.
Gestionar complementos (plugins)¶
La principal ventaja de esta aplicación es que puedes añadir nuevas funciones a través de los complementos o plugins. A través de la entrada Plugins del menú global, se accede al gestor de plugins (/admin/plugins), lugar donde se llevan a cabo todas las tareas de gestión relacionadas con este tipo de aplicaciones.
Instalar complementos (plugins)¶
Advertencia
Si se siguieron a rajatabla los pasos de la Instalación, la aplicación ya cuenta con los plugins propuestos dentro de la carpeta /plugins/. Por lo tanto, puedes saltarte el primer paso que ves a continuación e ir directamente a los puntos de instalación. Para obtener más información de los complementos propuestos, ver el apartado Complementos (plugins) .
El primer paso para instalar cualquier complemento, es descargarlo. Actualmente existen dos sitios desde donde se pueden obtener plugins:
Una vez descargado, se debe transportar la carpeta del plugin correspondiente a la carpeta /plugins/ del directorio raíz de la aplicación.
Con los plugins ya almacenados en la aplicación, se puede llevar a cabo el proceso de instalación desde la plataforma.
Para instalar un complemento (plugin):
- Desde el gestor de plugins (
/admin/plugins). - Localizar el nombre del complemento que se desea instalar.
- Hacer clic sobre el botón «Install».
- En caso de que el plugin sea configurable, rellenar el formulario de configuración y hacer clic en el botón «Save Changes».
Configurar complementos (plugins)¶
Algunos complementos ofrecen la posibilidad de configurar la funcionalidad que implementan.
Para configurar un complemento (plugin):
- Desde el gestor de plugins (
/admin/plugins). - Localizar el nombre del complemento que se desea configurar.
- Hacer clic sobre el botón «Configure».
- Modificar el formulario de configuración y hacer clic en el botón «Save Changes».
Activar/Desactivar complementos (plugins)¶
Al desactivar un complemento, todas las funciones que incluía en la aplicación desaparecen.
Para activar/desactivar un complemento (plugin):
- Desde el gestor de plugins (
/admin/plugins). - Localizar el nombre del complemento que se desea configurar.
- Hacer clic sobre el botón «Deactivate» para desactivar o sobre el botón «Activate» para activar.
Desinstalar complementos (plugins)¶
Los complementos pueden ser desinstalados de la aplicación. Al desinstalar un complemento o plugin este puede volver a ser instalado siempre y cuando conservemos los ficheros correspondientes en la carpeta /plugins del directorio raíz de la aplicación.
Para desinstalar un complemento (plugin):
- Desde el gestor de plugins (
/admin/plugins). - Localizar el nombre del complemento que se desea desinstalar.
- Hacer clic sobre el botón «Uninstall».
- En la página actual (
/admin/plugins), leer las consecuencias de la desinstalación y, en caso de estar conforme, marcar la casilla «Yes, I want to uninstall this plugin.».
- Hacer clic sobre el botón rojo «Uninstall».
En caso de que deseemos realizar una desinstalación completa, es decir, eliminar por completo la extensión de la aplicación, despues de ejecutar los pasos previamente mencionados, podemos eliminar los ficheros asociados al plugin de la carpeta plugins del directorio raíz de la aplicación.
Diseño de la aplicación¶
Desde la entrada «Appearance» del menú global podemos configurar todos los aspectos de la aplicación relacionados con el diseño, que son:
- Themes: permite seleccionar y configurar el tema público de la aplicación.
- Navigation: permite gestionar la navegación pública de la aplicación ordenando, editando y añadiendo nuevas entradas. Además se puede seleccionar la página principal (homepage).
- Settings: permite configurar otros aspectos relacionados con el diseño de la aplicación.
Instalar temas (themes)¶
Advertencia
Si se siguieron a rajatabla los pasos de la Instalación, la aplicación ya cuenta el tema (theme) propuesto dentro de la carpeta /themes/. Por lo tanto, puedes saltarte el primer paso que ves a continuación e ir directamente a los puntos de instalación. El nombre del tema propuesto es «Curatescape».
El primer paso para instalar cualquier tema es descargarlo. Actualmente existen dos sitios desde donde se pueden obtener temas (themes):
Una vez descargado, se debe transportar la carpeta del tema correspondiente a la carpeta /themes/ del directorio raíz de la aplicación.
Con el tema ya almacenado en la aplicación, se puede llevar a cabo el proceso de instalación desde la plataforma.
Para instalar un tema (theme):
- Desde la página de configuración de diseño (
/admin/appearance/). - Hacer clic sobre la entrada «Themes» de la barra de navegación existente.
- Localizar el nombre del tema que se desea instalar.
- Hacer clic sobre el botón «Use this theme».
- En caso de que el tema sea configurable, rellenar el formulario de configuración y hacer clic en el botón «Save Changes».
Modificar otros aspectos del diseño de la aplicación¶
Existen ciertos aspectos del diseño de la aplicación que no están ligados ni a los temas ni a la navegación.
Para configurar estos aspectos:
- Desde la página de configuración de diseño (
/admin/appearance/). - Hacer clic sobre la entrada «Settings» de la barra de navegación existente.
- Realizar los cambios oportunos:
- Fullsize Image Size: modificar el tamaño máximo de las imágenes.
- Thumbnail Size: modificar el tamaño de las imágenes en miniatura.
- Thumbnail Size: modificar el tamaño de las imágenes en miniatura cuadradas.
- Use Square Thumbnails: usar imágenes en miniatura cuadradas para representar imágenes en la interfaz pública.
- Link to File Metadata: cuando un ítem tenga un fichero asociado, enlazar el fichero con sus metadatos.
- Results Per Page (admin): modificar el número de ítems mostrados por página en el gestor de ítems.
- Results Per Page (public): modificar el número de ítems mostrados por página en el buscador de ítems (interfaz pública).
- Show Empty Elements: mostrar metadatos vacíos.
- Show Element Set Headings: mostrar el nombre del esquema de metadatos junto a sus elementos.
- Hacer clic sobre el botón «Save changes».
Gestionar Usuarios¶
Para acceder al gestor de usuarios se utiliza la entrada «Users» del menú global de navegación.
Crear un nuevo usuario¶
Cuando se crea un usuario se envía un mensaje de confirmación al correo electrónico indicado durante su creación. Este no será activado hasta que se acceda al enlace de confirmación indicado en este mensaje. A través de este enlace se accede a una página donde el usuario debe establecer su contraseña.
Para crear un nuevo usuario:
Desde el gestor de usuarios (
/admin/users).Hacer clic sobre el botón «Add user» situado en la parte superior izquierda del gestor.
En la página actual, especificar:
3.1. Username: nombre de usuario. 3.2. Display Name: nombre que se mostrará a los demás usuarios. 3.3. Email: correo electrónico. 3.4. Role: rol de usuario. En función del rol un usuario cuenta con unos u otros permisos.
Hacer clic sobre el botón «Add User» situado en la parte derecha de la pantalla.
Eliminar un usuario¶
Al eliminar un usuario, no se eliminan ninguno de los objetos digitales (ítems, colecciones, tags, etc.) creados por dicho usuario, sin embargo, estos no podrán volver a ser asociados al usuario eliminado.
Para eliminar un usuario existente:
- Desde el gestor de usuarios (
/admin/users). - Buscar en la tabla de usuarios el usuario que se pretende eliminar.
- Una vez localizado, hacer clic sobre el hipertexto «Delete» situado justo debajo del nombre de usuario.
- Confirmar la eliminación haciendo clic sobre el botón rojo «Delete».
Advertencia
No es posible eliminar al usuario creado durante la instalación de la aplicación.
Editar un usuario¶
Todos los usuarios existentes en la plataforma pueden ser modificados.
Para editar un usuario existente:
Desde el gestor de usuarios (
/admin/users).Buscar en la tabla de usuarios el usuario que se pretende editar.
Una vez localizado, hacer clic sobre el bipertexto «Edit» situado justo debajo del nombre de usuario.
En la página actual (
/admin/users/edit/<idUser>), realizar las modificaciones oportunas.- Username: cambiar el nombre de usuario.
- Display Name: cambiar el nombre que se mostrará a los demás usuarios.
- Email: cambiar el correo electrónico.
- Role: cambiar el rol de usuario.
- Active?: activar/desactivar el usuario.
- Cambiar la contraseña.
- Establecer/Cambiar la clave API.
Configuración de la aplicación¶
Muchos de los elementos de la aplicación pueden ser configurados. Desde la entrada «Settings» del menú global se puede acceder a la página desde donde se realizan estas configuraciones.
A través de la barra de navegación podemos desplazarnos por las distintas zonas de configuración, cada una de las cuales abarca un aspecto determinado.
Configuración general¶
Desde la pestaña «General» de la barra de navegación existente en la página de configuración principal de la aplicación (/admin/settings/), se pueden llevan a cabo las siguientes configuraciones:
- Administrator Email: email de administración.
- Site Title: título del sitio.
- Site Description: descripción del sitio:
- Site Copyright Information: información de copyright del sitio.
- Site Author Information: información del autor del sitio.
- Tag Delimiter: caracter usado para delimitar los tags de la aplicación.
- ImageMagick Directory Path: directorio donde se encuentra instalada la aplicación ImageMagick.
Configuración de la seguridad¶
Desde la pestaña «Security» de la barra de navegación existente en la página de configuración principal de la aplicación (mi/admin/settings/), se pueden llevan a cabo las siguientes configuraciones:
File Validation: configuraciones relacionadas con la validación de ficheros.
Captcha: configuraciones relacionadas con el sistema Captcha.
HTML Filtering: configuraciones relacionadas con el filtro HTML.
Configuración de las búsquedas¶
Desde la pestaña «Search» de la barra de navegación existente en la página de configuración principal de la aplicación (/admin/settings/), se pueden llevan a cabo las siguientes configuraciones:
- Search Record Types: seleccionar que objetos digitales pueden ser buscados desde la aplicación.
- Index Records: clicar sobre el botón «Index Records» si se desea re-indexar todos los objetos digitales.
Configuración de los esquemas de metadatos¶
Desde la pestaña «Element Sets» de la barra de navegación existente en la página de configuración principal de la aplicación (/admin/settings/), se pueden llevan a cabo las siguientes configuraciones:
- Edit: editar el esquema de metadatos.
- Delete: eliminar el esque de metadatos.
Configuración de los metadatos usados en los tipos de ítem¶
Desde la pestaña «Item Type Elements» de la barra de navegación existente en la página de configuración principal de la aplicación (/admin/settings/), se pueden llevan a cabo las siguientes configuraciones:
Figura 78 Vista de la página de configuración principal de la aplicación, pestaña «Item Type Elements».
- x: eliminar el elemento (metadato) del esquema de metadatos utilizado por los tipos de ítem.
- Description: modificar/añadir una descripción al elemento (metadato) del esquema de metadatos utilizado por los tipos de ítem.
Configuración de la API¶
Desde la pestaña «API» de la barra de navegación existente en la página de configuración principal de la aplicación (/admin/settings/), se pueden llevan a cabo las siguientes configuraciones:
- Enable API: activar/desactivar la API.
- Filter Element Texts: activar/desactivar el filtro de esquemas de metadatos.
- Results per Page: establecer el número máximo de resultados por página.
Objetos digitales¶
Dentro de la aplicación nos podemos encontrar con cinco tipos de objetos digitales: ítems (Items), colecciones (Collections), etiquetas (Tags), ficheros (Files) y tipos de ítem (Item Types). En este apartado se explica la utilidad de cada uno de ellos y, además, se muestran algunos tutoriales de cómo gestionar estos objetos dentro de la aplicación.
Items¶
Los ítems son los elementos principales de la aplicación, utilizados para representar a cada uno de los objetos digitales almacenados en esta. A través de la entrada Items, dentro de la sección «Data Manager» del menú principal, se accede al gestor de ítems (/admin/items/), lugar donde se llevan a cabo todas las tareas de gestión relacionadas con este elemento.
Propiedades de un Item¶
Cada Item está formado por:
- 0 o más elementos de información (metadatos).
- 0 o más ficheros (Files).
- 0 o más etiquetas (Tags).
- 0 o 1 geolocalización (Geolocation).
Además, presenta tres valores especiales:
- Public: indica si el ítem es público o no.
- Feature: indica si el ítem será destacado o no.
- Collection: indica si el ítem pertenece a una colección de ítems.
Crear un ítem¶
Si se desean generar conjuntos de datos desde la aplicación, el primer paso es crear ítems.
Para crear un ítem:
- Desde el gestor de ítems (
/admin/items/). - Hacer clic sobre el botón «Add an Item» situado en la parte superior de la tabla (ver Figura 80).
- En la página actual (
/admin/items/add), se puede observar una barra de navegación (ver Figura 81). Desde ella se pueden configurar los elementos del ítem:- Dublin Core: metadatos del esquema de metadatos Dublin Core.
- Item Type Metadata: metadatos asociados al tipo de Item.
- Files: ficheros asociados.
- Tags: etiquetas asociadas.
- Map: geolocalización del ítem.
- Si queremos asignar el ítem a una colección:
- En la parte derecha de la página, debajo del botón «Add Item», hay un menú desplegable donde puede asignar el ítem actual a la colección seleccionada.
- Además, se pueden marcar las casillas «Public» y/o «Feature» en la parte derecha del formulario, justo debajo del botón «Add Item».
- Para finalizar, hacer clic sobre el botón «Add Item».
Editar un ítem¶
Existen numerosos motivos por los que pueden surgir la necesidad de editar un ítem como, por ejemplo, cambiar el contenido de sus metadatados, agregar/eliminar ficheros, agruparlo a una colección, publicarlo, etc.
Para editar un ítem existente:
- Desde el gestor de ítems (
/admin/items/). - Localizar la fila en la que se encuentra el ítem y hacer clic sobre el hipertexto «Edit» situado justo debajo del título del ítem (ver Figura 80).
- En la página actual (
/admin/item/edit/<itemid>), se puede observar una barra de navegación (ver Figura 82). Desde ella se pueden configurar los elementos del ítem:- Dublin Core: metadatos del esquema de metadatos Dublin Core.
- Item Type Metadata: metadatos asociados al tipo de ítem.
- Files: ficheros asociados.
- Tags: etiquetas asociadas.
- Map: geolocalización del ítem.
- Asignar el ítem a una colección:
- En la parte derecha de la página, debajo del botón «Add Item», hay un menú desplegable donde puede asignar el ítem actual a la colección seleccionada.
- Además, se pueden marcar las casillas «Public» y/o «Feature» situadas en la parte derecha del formulario, justo debajo del botón «Add Item».
- Public para publicar el ítem.
- Feature para destacar el ítem.
- Para finalizar, hacer clic sobre el botón «Save Changes».
Eliminar un ítem¶
El gestor de ítems ofrece múltiples formas de eliminar un ítem existente en la plataforma.
[Opción 1] Para eliminar un ítem existente:
- Desde el gestor de ítems (
/admin/items/). - Localizar la fila en la que se encuentra el ítem y hacer clic sobre el hipertexto «Delete» situado justo debajo del título del ítem.
- Confirmar la eliminación del ítem pulsando sobre el botón «Delete».
[Opción 2] Para eliminar un ítem existente:
- Desde el gestor de ítems (
/admin/items/). - Localizar la fila en la que se encuentra el ítem y hacer clic sobre el hipertexto «Edit» situado justo debajo del título del ítem.
- En la página actual (
/admin/item/edit/<itemid>), clicar sobre el botón «Delete» situado en la parte derecha del formulario. - Confirmar la eliminación del ítem pulsando sobre el botón «Delete».
[Opción 3] Para eliminar un ítem existente:
- Desde el gestor de ítems (
/admin/items/). - Localizar la fila en la que se encuentra el ítem y hacer clic sobre la casilla situada en la primera columna de la izquierda de la tabla.
- Hacer clic sobre el botón «Delete» situado en la parte superior derecha de la tabla.
- En la página actual (
/admin/items/batch-edit), hacer clic sobre el botón «Delete Items» situado en la parte derecha de la página.
Buscar ítems¶
Otro de los servicios que incluye este gestor es la búsqueda de ítems. Cuando entramos a este apartado a través de la sección «Data Manager» del menú principal, se nos muestra una lista de ítems ordenados según su fecha de creación (de más recientes a más antiguos).
Como se puede apreciar en la Figura 80, los ítems son mostrados en una tabla donde cada fila representa a un ítem y cada columna contiene información específica de dicho ítem (título, creador, tipo de ítem y fecha de creación). Existe una columna adicional, en la parte izquierda de la tabla, que se utiliza para seleccionar varios ítems en el caso de que se quieran ejecutar una o varias acciones sobre varios ítems. Para ordenar los ítems en funcion de los campos de la tabla (título, creador y fecha de modificación), se debe clicar sobre el elemento deseado.
Figura 83 Ítems especiales vistos desde el gestor de ítems: el primero es destacado, el segundo es privado y el tercero almacena un fichero (imagen).
Otra particularidad del gestor es que, en función de los valores especiales del ítem, se le da un formato u otro.
- Si al lado del título se encuentra el texto «(Private)» , el ítem no es público, es decir, solo será accesible desde la zona de administración.
- Si el fondo del título presenta una estrella, significa que el ítem es destacado (feature).
- Si el ítem tiene un archivo (File) asociado, se mostrará una miniatura del misma al lado del título.
Por defecto se muestran todos los ítems almacenados en la plataforma, sin embargo, es posible reducir su número ejecutando una búsqueda avanzada o aplicando filtros. De esta manera, se pueden enfocar las labores de gestión sobre unos ítems específicos.
Para buscar ítems mediante una búsqueda avanzada:
Desde el gestor de ítems (
/admin/items/).Hacer clic sobre el botón «Search items» situado justo encima/debajo de la tabla de ítems.
En la página actual (
/admin/items/search), rellenar el formulario con los datos de búsqueda.- Search for Keywords: buscar por una cadena de texto específica (en cualquier elemento).
- Narrow by Specific Fields: buscar por un elemento (metadato) específico que..
- contains: contenga una cadena de texto
- does not contain: no contenga una cadena de texto
- is exactly: sea exactamente una cadena de texto
- is not exactly: no sea exactamente una cadena de texto
- is empty: esté vacío
- is not empty: no esté vacío
- starts with: empiece por una cadena de texto
- ends with: acabe por una cadena de texto
- matches: coincida con una expresión
- does not match: no coincida con una expresión
- Search by a range of ID: buscar por rangos de identificadores.
- Search By Collection: buscar por colección asociada.
- Search By User: buscar por el usuario que lo creó/importó.
- Search By Tags: buscar por tags asociados.
- Public/Non-Public: buscar por su estado de publicación.
- Featured/Non-Featured: buscar por su estado de destacado.
- Geolocation Status: buscar por su estado de geolocalización.
- Geographic Address: buscar por la dirección geográfica.
- Geographic Radius: buscar por el radio geográfico.
Hacer clic sobre el botón «Search for items».
Para buscar ítems mediante filtros de búsqueda:
Desde el gestor de ítems (
/admin/items/).Hacer clic sobre el desplegable «Quick Filter» situado justo encima/debajo de la tabla de ítems.
Seleccionar el filtro que se desee aplicar.
- View all (por defecto): ver todos los ítems.
- Public: ver ítems públicos.
- Private: ver ítems privados.
- Featured: ver ítems destacados.
Editar/Eliminar varios ítems a la vez¶
La aplicación te permite modificar o eliminar varios ítems a la vez desde el gestor de ítems.
Para editar/eliminar varios ítems a la vez:
- Desde el gestor de ítems (
/admin/items/). - Buscar los ítems que se quieran eliminar/editar (ver Buscar ítems).
- Marcar la casilla situada en la parte izquierda de la tabla de todos los ítems que se pretenden editar/eliminar. Si se desean seleccionar todos los ítems, hacer clic sobre el botón «Select all results» situado en la parte superior izquierda de la tabla. Si se desean seleccionar todos los ítems de la página actual, marcar la casilla alojada en la cabecera de la tabla.
- Hacer clic sobre el botón «Edit» situado en la parte superior derecha de la tabla.
- Al pulsar el botón «Edit», desde la página actual (
/admin/items/batch-edit) podrás:- cambiar su accesibilidad (públicos / privados)
- cambiar su estado (descatados o no destacados)
- cambiar su tipo
- cambiar o asociar todos los ítems a una colección
- añadir etiquetas (tags)
- ordenar los ítems seleccionados por el nombre de su fichero (file)
- eliminar todos los ítems
- Comprobar en la lista de ítems que todos los ítems seleccionados son correctos. Desmarcar los que no.
- Hacer clic sobre el botón «Save Changes».
Visualizar un ítem completo¶
En la página principal del gestor de ítems (/admin/items/) solo se pueden visualizar los datos más característicos de cada ítem como su título o tipo. La aplicación te da la posibilidad de visualizar el ítem al completo, junto a todos sus metadatos, ficheros, tags, etc.
Para visualizar un ítem:
- Desde el gestor de ítems (
/admin/items/). - Buscar el ítem que se quiera visualizar (ver Buscar ítems).
- Hacer clic sobre el título del ítem, situado en la segunda columna de la tabla.
- Visualizar el ítem desde la página actual (
/admin/items/show/<idItem>).
Exportar ítems¶
A través de este gestor también se pueden exportar ítems almacenados en la plataforma. Desde la página principal (/admin/items/) se pueden exportar varios ítems a la vez, sin embargo, desde la página de visualización (/admin/items/show/<idItem>) solo es posible exportar un único ítem. Por este motivo, alguno de los formatos de exportación disponibles se encontrarán en una sola vista o en ambas, dependiendo de los requisitos del lenguaje.
| Formato | Extensión | Disponibilidad | Descripción |
|---|---|---|---|
| atom | none | /admin/items/ /admin/items/show/<idItem> |
Esquema de metadatos oficial de Omeka Classic |
| dc-rdf | .rdf | /admin/items/ /admin/items/show/<idItem> |
Serialización JsonML del esquema omeka-xml. |
| dcmes-xml | .xml | /admin/items/ /admin/items/show/<idItem> |
Instancia RDF/XML del modelo Dublin Core simple. |
| json | .json | /admin/items/ /admin/items/show/<idItem> |
JSON simplificado utilizado principalmente para solicitudes Ajax. |
| mobile-json | .json | /admin/items/ /admin/items/show/<idItem> |
Serialización JsonML del modelo omeka-xml. |
| omeka-xml | .xml | /admin/items/ /admin/items/show/<idItem> |
Esquema de metadatos oficial de Omeka Classic |
| rss2 | .xml | /admin/items/ | Segunda versión del modelo srss. |
| srss | .xml | /admin/items/ | Modelo de metadatos empleado para la distribución (o sindicación, del inglés syndication) de noticias o información liberada a intervalos de tiempo en sitios web y weblogs. |
| CENIEH | .xml | /admin/items/show/<idItem> | Esquema de metadatos empleado para el proceso de integración de datos entre el CENIEH y ARIADNEplus. |
| CSV | .csv | /admin/items/ | Formato abierto sencillo empleado para representar datos en forma de tabla. |
Para exportar un único ítem:
- Desde el gestor de ítems (
/admin/items/). - Buscar el ítem que se quiera exportar (ver Buscar ítems).
- Hacer clic sobre el título del ítem, situado en la segunda columna de la tabla.
- Desde la página de visualización del ítem (
/admin/items/show/<idItem>). - Hacer clic sobre el formato de exportación deseado existente en el panel «Output Formats» situado en la parte derecha de la pantalla (ver Figura 85).
Para exportar todos los ítems de una página:
- Desde el gestor de ítems (
/admin/items/). - Buscar los ítems que se quieran exportar (ver Buscar ítems).
- Hacer clic sobre el formato de exportación deseado de entre todos los que se encuentran en parte inferior de la pantalla, justo debajo de la tabla de ítems (ver Figura 80).
- Para exportar en formato CSV, hay que pulsar el botón situado justo debajo de los demás formatos de exportación.
Ver también
Files¶
Cuando se añaden nuevos ítems a la plataforma, es posible asociar ficheros (imágenes, documentos, etc.) a los mismos. Por cada uno de ellos se crea un elemento de tipo File, el cual contiene información detallada del fichero que se ha subido a la plataforma.
Estos elementos no tienen su propia página de gestión ya que son parte de los ítems, por lo que tiene más sentido que se gestionen desde el gestor de ítems (/admin/items/).
Tipos de ficheros admitidos¶
La aplicación acepta la gran mayoría de ficheros. Si se tiene algún error o inconveniente durante la subida de un fichero, consulta en este mismo manual cómo ajustar los tipos de fichero o extensiones permitidas en la aplicación.
Tamaño máximo de ficheros¶
Lamentablemente, no se puede configurar el tamaño máximo de los ficheros desde la aplicación. Para poder modificarlo, es necesario contactar con el administrador del servidor donde se encuentre alojada la aplicación.
Visualizar un fichero¶
A través de la página de visualización de ficheros (/admin/files/show/<idFile>) es posible obtener más informacion acerca de un determinado fichero.
Para visualizar un fichero:
- Desde el gestor de ítems (
/admin/items/). - Buscar el ítem que contenga al archivo involucrado (ver Buscar ítems).
- Hacer clic sobre el título del ítem, situado en la segunda columna de la tabla (ver Figura 80).
- Desde la página actual (
/admin/items/show/<idItem>). - Hacer clic sobre la miniatura del fichero (parte superior, justo encima de los metadatos) o bien clicar sobre su nombre (parte derecha, panel «File Metadata).
Añadir metadatos a un fichero¶
La aplicación permite asociar metadatos del esquema Dublin Core a los ficheros almacenados en la plataforma.
[Opción 1] Para añadir metadatos a un fichero:
- Desde el gestor de ítems (
/admin/items/). - Buscar el ítem que contenga al archivo involucrado (ver Buscar ítems).
- Hacer clic sobre el hipertexto «Edit» situado justo debajo del título del ítem (ver Figura 80).
- Desde la página actual (
/admin/items/edit/<idItem>), acceder a la pestaña «Files» (ver Figura 82). - Hacer clic sobre el hipertexto «Edit» situado en la parte derecha del nombre del fichero.
[Opción 2] Para añadir metadatos a un fichero:
- Desde el gestor de ítems (
/admin/items/). - Buscar el ítem que contenga al archivo involucrado (ver Buscar ítems).
- Hacer clic sobre el título del ítem, situado en la segunda columna de la tabla (ver Figura 80).
- Desde la página actual (
/admin/items/show/<idItem>). - En el panel «File Metadata», situado en la parte derecha de la pantalla, hacer clic sobre el nombre del fichero al que deseamos añadir metadatos (ver Figura 85)..
- Desde la página actual (
/admin/files/show/<idFile>), hacer clic sobre el botón «Edit».
Ver también
Collections¶
Las colecciones pueden ser usadas en una gran variedad de contextos en los que puede tener sentido utilizarlas para tus conjuntos de datos. En la aplicación, un ítem puede pertenecer a una única colección y, como es lógico, una colección puede contener múltiple ítems. A través de la entrada Collections, dentro de la sección «Data Manager» del menú principal, se accede al espacio (/admin/collections) donde se gestionan este tipo de elementos.
Crear una colección¶
Antes de poder agrupar ítems en una colección, esta debe ser creada.
Para crear una colección:
- Desde el gestor de colecciones (
/admin/collections/). - Hacer clic sobre uno de los dos botones «Add a Collection».
- En la página actual (
/admin/collections/add), se puede observar una barra de navegación. Desde ella se pueden configurar los elementos de la colección:- Dublin Core: metadatos del esquema Dublin Core.
- Files: ficheros asociados.
- Si se quiere hacer pública la colección, marcar la casilla Public situada justo debajo del botón «Add Collection». Además, si se quiere destacar la colección, marcar la casilla «Feature».
- Hacer clic sobre «Add Collection».
Añadir ítems a una colección¶
Las colecciones pueden agrupar un número ilimitado de ítems. Para añadir ítems a una colección existente se debe señalar a la colección en el valor especial «Collection» de cada ítem. Esta operación no se puede llevar a cabo desde el gestor de colecciones, debes editar ese campo desde el gestor de ítems (/admin/items/).
Para añadir un solo ítem a una colección:
- Desde el gestor de ítems (
/admin/items/). - Localizar la fila en la que se encuentra el ítem y hacer clic sobre el hipertexto «Edit» situado justo debajo del título del ítem.
- En la página actual (
/admin/item/edit/<itemid>), en la parte derecha de la pantala, justo debajo del botón «Add Item», selecciona la colección en el campo «Collection». - Hacer clic sobre el botón «Save Changes».
Para añadir varios ítems a una colección:
- Desde el gestor de ítems (
/admin/items/). - Buscar los ítems que se quieran añadir a la colección.
- Marcar la casilla situada en la parte izquierda de la tabla de todos los ítems que se pretenden añadir. Si se desean seleccionar todos los ítems, hacer clic sobre el botón «Select all results» situado en la parte superior izquierda de la tabla. Si se desean seleccionar todos los ítems de la página actual, marcar la casilla alojada en la cabecera de la tabla.
- Hacer clic sobre el botón «Edit» situado en la parte superior derecha de la tabla.
- Desde la página actual (
/admin/items/batch-edit), seleccionar la colección en el campo «Collection». - Hacer clic sobre el botón «Save Changes».
Editar una colección¶
Es posible modificar los datos exclusivos de la colección (no de sus ítems) una vez haya sido creada.
Para editar una colección existente:
- Desde el gestor de colecciones (
/admin/collections/). - Hacer clic sobre el hipertexto «Edit».
- En la página actual (
/admin/collections/edit/<collectionId>), realizar las modificaciones oportunas. - Hacer clic sobre el botón «Save Changes».
Eliminar una colección.¶
Al eliminar una colección los ítems que estaban asociados a esta no se eliminan, simplemente se desvinculan. Por tanto, si se pretende eliminar tanto los ítems como la colección asociada, elimina primero los ítems asociados a la colección y, posteriormente, elimina la colección.
Para eliminar una colección existente:
- Desde el gestor de colecciones (
/admin/collections/). - Hacer clic sobre el hipertexto «Edit».
- En la página actual (
/admin/collections/edit/<collectionId>), hacer clic sobre el botón «Delete». - Confirmar la eliminación haciendo de nuevo clic sobre el botón «Delete».
Visualizar una colección¶
Desde la página principal del gestor de colecciones (/admin/collections/) solo se muestran algunos datos de cada elemento. Si queremos conocer más información acerca de una colección, tendremos que acceder a su página de visualización.
Para visualizar una colección:
- Desde el gestor de colecciones (
/admin/collections/). - Buscar la colección que se quiera visualizar.
- Hacer clic sobre el título de la colección, situado en la segunda columna de la tabla.
- Visualizar la colección desde la página actual (
/admin/collections/show/<idItem>).
Ver también
Tags¶
Desde la entrada «Tags», dentro de la sección «Data Manager» del menú principal, se accede al gestor de etiquetas o tags (/admin/tags/). Las etiquetas son palabras clave o frases utilizadas para describir los datos almacenados en la plataforma. Permiten clasificar el contenido de los datos para facilitar su búsqueda. Estas se pueden asociar a ítems.
Desde el gestor de etiquetas, en la parte derecha se pueden observar todos los tags empleados en cada uno de los ítems existentes en la plataforma, mientras que en la parte izquierda, al lado del menú principal, hay un buscador y una explicación de cómo están representados los tags.
Ordenar tags¶
Es posible ordenar las etiquetas en función de su nombre, número de apariciones, o fecha en la que se creó.
Para ordenar etiquetas:
- Desde el gestor de etiquetas (
/admin/tags/). - Hacer clic sobre alguno de los botones que se encuentran encima del conjunto de etiquetas.
- Name: se ordenan alfabéticamente por el nombre de cada etiqueta.
- Count: se ordenan en función del número de ítems asociado a cada etiqueta.
- Date created: se ordenan por fecha de creación. Por defecto más antiguos primero.
Buscar tags¶
Se pueden buscar etiquetas por su nombre.
Para buscar etiquetas:
- Desde el gestor de etiquetas (
/admin/tags/). - Escribir el nombre de la etiqueta que se está buscando sobre el cuadro de texto situado en la parte izquierda de la pantalla.
- Hacer clic sobre el botón «Search tags».
Para volver al estado de búsqueda inicial:
- Desde el gestor de etiquetas (
/admin/tags/). - Hacer clic sobre el botón «Reset results».
Editar tags¶
Una vez creada una etiqueta, se puede modificar el nombre de esta. Este cambió se aplicará en todos los ítems que contengan a dicha etiqueta.
Para editar una etiqueta:
- Desde el gestor de etiquetas (
/admin/tags/). - Buscar la etiqueta que se desea editar dentro del conjunto de etiquetas situado en la parte derecha de la pantalla.
- Hacer clic sobre el nombre de la etiqueta.
- Introducir el nuevo valor en el campo de texto emergente.
- Pulsar la tecla “Enter” o clicar sobre cualquier punto externo.
Eliminar tags¶
Es posible eliminar una o varias etiquetas a la vez. Es importante recalcar que, cuando se elimina una etiqueta, los ítems que están asociados no no se eliminan, simplemente se desvinculan de esta.
Para eliminar una sola etiqueta:
- Desde el gestor de etiquetas (
/admin/tags/). - Buscar la etiqueta que se desea eliminar dentro del conjunto de etiquetas situado en la parte derecha de la pantalla.
- Hacer clic sobre botón «x» situado en la parte derecha de la etiqueta.
- Confirmar la eliminación haciendo clic sobre el botón «Delete».
Para eliminar varias etiquetas a la vez:
- Desde el gestor de etiquetas (
/admin/tags/). - Buscar las etiquetas que se desean eliminar haciendo uso del buscador. Si se desean eliminar todas las etiquetas, ignorar este paso.
- Hacer clic sobre botón rojo «Delete results» en caso de haber hecho una búsqueda, sino, hacer clic sobre el botón «Delete all».
- Confirmar la eliminación haciendo clic sobre el botón «Yes».
Ver ítems asociados a una etiqueta¶
Se pueden obtener todos los ítems asociados a una determinada etiqueta.
Para ello:
- Desde el gestor de etiquetas (
/admin/tags/). - Buscar la etiqueta que se desea eliminar dentro del conjunto de etiquetas situado en la parte derecha de la pantalla.
- Hacer clic sobre el contador situado en la parte izquierda de la etiqueta.
Ver también
Item Types¶
Cada ítem puede pertenecer a un determinado tipo, el cual aporta elementos extra al ítem. Por ejemplo, si un ítem hace referencia a una persona, puede resultar interesante indicar su fecha de nacimiento, fecha de muerte, ocupación, etc. Como el esquema de metadatos principal (Dublin Core) no contiene elementos que cubran esta información, atribuyendo un tipo al ítem se pueden incluir nuevos elementos que satisfazcan esa necesidad.
A través de la entrada «Item Types», dentro de la sección «Data Manager» del menú principal de administración, se puede acceder al gestor de tipos de ítem (/admin/item-types).
Tipos de ítem predefinidos¶
Cuando se accede al gestor de tipos de ítem (/admin/item-types) por primera vez se observan un conjunto de tipos de ítems ya definidos.
| Tipo de ítem | Descripción | Ejemplos |
|---|---|---|
| Text | Recurso cuyo principal contenido es texto | Poemas, libros, cartas, artículos, etc. |
| Moving Image | Conjunto de imágenes que puestas en sucesión imparten una sensación de movimiento | Animaciones, videos, películas, etc. |
| Oral History | Recurso que contiene datos históricos obtenidos a partir de conferencias, charlas o reuniones. | Charlas, conferencias, entrevistas, etc. |
| Sound | Recurso cuyo principal cometido es ser escuchado. | Audios de cualquier tipo |
| Still Image | Representación visual estática. | Pinturas, dibujos, planos, mapas, etc. |
| Website | Recurso almacenado en una o varias páginas web. | Página web |
| Event | Ocurrencia no persistente basada en el tiempo. | Conferencia, Workshop, Exhibición, etc. |
| Recurso cuyo contenido es el propio de un mensaje de correo electrónido (asunto, cuerpo, origen, destino, etc.) | Mensaje de correo electrónico | |
| Leson Plan | Recurso cuyo contenido ofrece una descripción detallada de un curso de formación. | Curso de formación |
| Hyperlink | Recurso existente en Internet. | Enlace, Referencia, etc. |
| Person | Un individuo. | Persona. |
| Interactive Resource | Recurso que requiere la interacción del usuario para ser entenido, ejecutado o experimentado | Formularios, Aplicaciones, Entornos virtuales, etc. |
| Dataset | Datos codificados en una determinada estructura. | Metadatos. |
| Physical Object | Objeto o sustancia inanimada. | Cualquier objeto físico (e.g una piedra). |
| Service | Sistema que provee una o más funciones. | Servicio de repostería, autentificación, bancario, etc. |
| Software | Programa de ordenador. | Archuvos .java, .exe, etc. |
| Curatescape Story | Historia narrativa que puede ser representada de forma especial por el tema Curatescape. | Rutas, viajes, etc. |
Editar un tipo de ítem¶
Se pueden modificar tipos de ítem existentes para modificar sus elementos (metadatos).
Para modificar un tipo de ítem existente:
- Desde el gestor de tipos de ítem (
/admin/item-types). - Localizar el tipo de ítem que se desea editar en la tabla donde se encuentran todos los tipos (ver Figura 98).
- Hacer clic sobre el hipertexto «Edit», situado justo debajo del nombre del tipo.
- En la página actual (
/admin/item-types/edit/<idItemType>), realizar las modificaciones oportunas (ver Crear un tipo de ítem). - Hacer clic sobre el botón «Save changes» situado en la parte superior derecha de la pantalla.
Crear un tipo de ítem¶
En caso de que ninguno de los tipos de ítem predefinidos (ver Tabla 12) cubra nuestras necesidades, se puede crear un nuevo tipo de ítem.
Para crear un tipo de ítem nuevo:
Desde el gestor de tipos de ítem (
/admin/item-types).Hacer clic sobre el botón «Add an Item Type», situado en la parte superior/inferior de la pantalla (ver Figura 98).
En la página actual (
/admin/item-types/add):3.1. Establecer un nombre
3.2. Establecer una descripción
3.3. Añadir un elemento existente.
3.4. Añadir un elemento nuevo
Hacer clic sobre el botón «Add Item Type» situado en la parte superior derecha de la pantalla.
Visualizar un tipo de ítem¶
Antes de realizar tareas de gestión sobre un determinado tipo de ítem, se puede comprobar el estado actual del mismo.
Para visualizar un tipo de ítem existente.
- Desde el gestor de tipos de ítem (
/admin/item-types). - Localizar el tipo de ítem que se desea eliminar en la tabla donde se encuentran todos los tipos (ver Figura 98).
- Hacer clic sobre el nombre del tipo de ítem.
- Visualizar el tipo de ítem en la página actual (
/admin/item-types/show/<idItemType>).
Eliminar un tipo de item¶
Al eliminar un tipo de ítem no se eliminan los elementos (metadatos) asignados al tipo de ítem. Sin embargo, todos los ítems que tengan asignado el tipo de ítem eliminado, perderán todos los metadatos especificados por el tipo de ítem.
[Opción 1] Para eliminar un tipo de ítem existente:
- Desde el gestor de tipos de ítem (
/admin/item-types). - Localizar el tipo de ítem que se desea eliminar en la tabla donde se encuentran todos los tipos (ver Figura 98).
- Hacer clic sobre el hipertexto «Edit», situado justo debajo del nombre del tipo.
- En la página actual (
/admin/item-types/edit/<idItemType>), hacer clic sobre el botón rojo «Delete» (ver Figura 101). - Confirmar la eliminación volviendo a pulsar sobre el botón «Delete».
[Opción 2] Para eliminar un tipo de ítem existente:
- Desde el gestor de tipos de ítem (
/admin/item-types). - Localizar el tipo de ítem que se desea eliminar en la tabla donde se encuentran todos los tipos (ver Figura 98).
- Hacer clic sobre el nombre del tipo de ítem.
- En la página actual (
/admin/item-types/show/<idItemType>), hacer clic sobre el botón rojo «Delete». - Confirmar la eliminación volviendo a pulsar sobre el botón «Delete».
Ver también
Complementos (plugins)¶
CSV Import+¶
Este complemento nos ofrece una herramienta que nos permite importar conjuntos de datos que están dispuestos en formato CSV. Se puede acceder a esta herramienta (/admin/csv-import-plus/) desde el menú principal de navegación a través de la entrada «CSV Import+», dentro de la sección «Import Tools».
Cuando se accede a esta herramienta, se nos muestra el primer paso a realizar para llevar a cabo la importación (ver Figura 102). Este es un formulario donde el usuario debe configurar los aspectos de la importación.
Figura 103 Vista correspondiente al paso 2 del proceso de importación de la herramienta CSV Import+.
Además, existe un segundo paso opcional, donde se lleva a cabo el mapeo de datos de forma manual (ver Figura 103).
Tras finalizar el recorrido de importación, es posible visualizar el registro de cada importación desde la misma herramienta (/admin/csv-import-plus/), dentro de la pestaña «Status».
Importar datos CSV¶
Antes de iniciar este proceso, es muy importante que el usuario que lo lleve a cabo conozca los datos que está importando para configurar adecuadamente el proceso de importación.
Para importar datos CSV:
- Desde el complemento CSV Import+ (
/admin/csv-import-plus/). - En la pestaña Import (ver Figura 102), rellenar el formulario correspondiente al paso 1 (Step 1: Select file and item settings). Es muy recomendable dejar los valores por defecto (ver Tabla 13).
- Hacer clic sobre el botón «Next».
- Al seleccionar la opción Perhaps, so the mapping should be done manually para el campo Contains extra data, se debe completar un segundo paso (ver Figura 103) :
- Establecer las relaciones entre los elementos de origen (e.g Localización) y los elementos de destino (e.g. Dublin Core:Spatial Coverage) haciendo uso de la columna Map To Element.
- Si alguno de los elementos tiene contenido HTML, indícalo en la columna Use HTML?.
- Si alguno de los elementos representa un valor especial (ver Tabla 14), selecciona dicho valor en la columna Special Values.
- Es obligatorio que el conjunto de datos cuente con un único elemento que contega el identificador de cada registro. Luego siempre existirá un elemento con el valor especial Identifier.
- Si alguno de los elementos no pertenece a ningún elemento estandarizado, sino que pertenece a otro elemento de otro tipo de objeto, se debe indicar en la casilla Extra Data?.
- Hacer clic sobre el botón Import CSV file.
- Puedes visualizar el progreso de la importación desde la pestaña Status (ver Figura 104).
Tablas de configuración¶
| Sección | Campo | Valor | Valor por defecto |
|---|---|---|---|
| Upload: adjuntar el fichero CSV a importar | Upload CSV file: fichero CSV que se pretende importar. | ||
| CSV Format: configurar el formato CSV del fichero adjuntado | Column Delimiter: caracter utilizado para separar las columnas. |
|
Coma |
| Enclosure: caracter utilizado para delimitar las columnas. |
|
double quote | |
| Element delimiter: caracter utilizado para separar metadatos dentro de una misma celda. |
|
Semi-colon | |
Tag delimiter: caracter utilizado para separar tags dentro de una misma celda. Si tus datos no contienen tags, puedes ignorarlo. |
comma | ||
File delimiter: caracter utilizado para separar rutas de archivos o URLs dentro de una misma celda. Si tus datos no referencian ficheros, puedes ignorarlo. |
comma | ||
| Default values: configurar los valores por defecto para todos los ítems a importar | Item type: tipo de ítem que pretendemos importar. |
|
No default item type |
Collection: colección a la que pertenecen los ítems. Si el fichero contiene muchos ítems, conviene agruparlos dentro de una colección previamente creada. |
|
No default collection | |
| Make records public: activado, se publicarán los ítems tras la importación |
|
Desactivado | |
| Feature: activado, se marcarán los ítems importados como feature. | |||
| Elements are html: activado, se considerará que el contenido de los ítems está en html. | |||
Process: configurar el proceso de importación. Las opciones por defecto son válidas para cualquier importación |
Identifier field: elemento que señala el identificador de cada ítem. |
|
No default identifier field |
Action: acción que se ejecutará en cada ítem. Para que estas acciones se ejecuten, el identificador del dato importado ha de coincidir con el identificador del ítem existente en la plataforma. |
|
No default action | |
Contains extra data: indicar si nuestro conjunto de datos contiene elementos que no siguen ningún estándar de metadatos, sino que se refieren a otro tipos de registros. Si no se tiene conocimientos de la aplicación, dejar el valor por defecto. |
|
Perhaps, so the mapping should be done manually |
| Valor especial | Significado |
|---|---|
| Tags | El elemento contiene tags. |
| Collection (for item) | El elemento contiene el identificador de la colección asociada al ítem. |
| Item (for file) | El elemento contiene el identificador del item asociado al fichero. |
| Files | El elemento contiene ficheros (rutas o URLs). |
| Public | El elemento contiene el valor que indica si el ítem es público o no (true/false). |
| Featured | El elemento contiene el valor que indica si el ítem es feature o no. |
| Action | El elemento contiene el valor que indica una acción (Delete, Update, Add, etc.). |
| Record type | El elemento contiene el tipo de registro que estamos importando (Collection/Item). |
| Item type | El elemento contiene el tipo de ítem que estamos importando (e.g dataset). |
| Identifier field | El elemento es un campo de identificación. |
| Identifier | El elemento contiene el identificador del registro. |
Ejemplos de importación¶
A continuación, se muestran diferentes conjuntos de datos de ejemplo:
Conjunto de datos A: cómo importar ítems simples que no siguen ningún esquema de metadatos. El formato CSV es normal.
- Descripción del conjunto: contiene información acerca de tres libros, cada uno de los cuales tiene asociado una imagen (fichero) de Wikipedia. La información (metadatos) no sigue ningún estándar.
- Fichero CSV:
Conjunto de datos A - CSV Format: Por defecto.
- Default values: Por defecto.
- Process: Por defecto.
- ¿ Contiene valores especiales ? : Sí, Tags y Files.
- ¿ Contiene contenido extra ? : No
Conjunto de datos B: cómo importar ítems simples con metadatos que siguen el esquema de metadatos Dublin Core. El formato CSV es normal.
- Descripción del conjunto: es el mismo que el conjunto de datos A solo que en este caso los elementos (metadatos) sí que siguen un estándar (Dublin Core) aceptado por la plataforma. En estos casos, no hará falta realizar un mapeo manual.
- Fichero CSV:
Conjunto de datos B - CSV Format: Por defecto.
- Default values: Por defecto.
- Process: Por defecto.
- ¿ Contiene valores especiales ? : Sí, Tags y Files.
- ¿ Contiene contenido extra ? : No
Conjunto de datos C: cómo importar ítems simples con metadatos que siguen el esquema de metadatos Dublin Core. El formato CSV presenta particularidades.
Descripción del conjunto: es el mismo que el conjunto de datos A o B solo que el formato CSV adopta delimitadores distintos a los que vienen por defecto.
Fichero CSV:
Conjunto de datos CCSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: custom ^^
- Tag delimiter: double space
- File delimiter: semi-colon
Default values: Por defecto.
Process: Por defecto …
- Contains extra data: puede adquirir tanto el valor de Perhaps … como de No, …. Si es este último, se automatiza el paso 2.
¿ Contiene valores especiales ? : Sí, Tags y Files.
¿ Contiene contenido extra ? : No
Conjuntos de datos D-1 y D-2: cómo importar ficheros con metadatos que siguen el esquema de metadatos Dublin Core. El formato CSV presenta particularidades.
Descripción del conjunto:
- D-1: contiene, además del mismo contenido de los conjuntos anteriores, información adicional (metadatos) de las imágenes (ficheros) asociadas a los ítems.
- D-2: requiere que alguno de los conjuntos de datos anteriores (A,B,C,D-1).
Ficheros CSV:
Conjunto de datos D-1yConjunto de datos D-2CSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process: Por defecto …
- Contains extra data: puede adquirir el valor de Perhaps … y de No, …. Si es este último, se salta el paso 2.
¿ Contiene valores especiales ? : Sí, Tags y Files.
¿ Contiene contenido extra ? : No
Conjunto de datos E: cómo importar metadatos de ítems y ficheros a la vez.
Descripción del conjunto: contiene metadatos tanto de ítems como de ficheros. Es importante tener en cuenta que las filas de los ficheros deben estar por debajo de las filas de los ítems, de lo contrario, se omitirían.
Fichero CSV:
Conjunto de datos ECSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process: Por defecto.
¿ Contiene valores especiales ? : Sí, Tags.
¿ Contiene contenido extra ? : No
Conjunto de datos F: cómo actualizar metadatos de ítems y ficheros existentes en la plataforma.
Descripción del conjunto: contiene el conjunto de datos E con nuevos datos. Para que la actualización funcione, debes importar antes el
conjunto de datos E.Fichero CSV:
Conjunto de datos FCSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process:
- Action: Update the record if exists, else create one.
¿ Contiene valores especiales ? : Sí, Tags.
¿ Contiene contenido extra ? : No
Conjunto de datos G: cómo importar una colección de ítems simples con metadatos que siguen o no un esquema de metadatos.
Descripción del conjunto: contiene metadatos de una colección y los metadatos de dos ítems que pertenecen a dicha colección.
Fichero CSV:
Conjunto de datos GCSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process: Por defecto.
¿ Contiene valores especiales ? : Sí, Record Type y Collection.
¿ Contiene contenido extra ? : No
Conjunto de datos H: cómo actualizar metadatos de una colección existente en la plataforma.
Descripción del conjunto: contiene el conjunto de datos G con nuevos datos. Para que la actualización funcione, debes importar antes el
conjunto de datos G.Fichero CSV:
Conjunto de datos GCSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process: Por defecto.
¿ Contiene valores especiales ? : Sí, Record Type y Collection.
¿ Contiene contenido extra ? : No
Conjunto de datos I: cómo añadir ítems a una colección existente en la plataforma desde el formulario.
Descripción del conjunto: contiene metadatos de un ítem. Para que la importación funcione, debes importar antes el
conjunto de datos G.Fichero CSV:
Conjunto de datos ICSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values
- Collection: collection-a
Process: Por defecto.
¿ Contiene valores especiales ? : Sí, Record Type.
¿ Contiene contenido extra ? : No
Conjunto de datos J: cómo importar contenido extra que no es gestionado como elementos, sino como datos de un objeto (tabla) específico. Los elementos existentes siguen un estándar.
Descripción del conjunto: contiene información (metadatos y valores especiales) de ítems y ficheros. Además, contiene contenido extra, en concreto, geolocalizaciones.
Fichero CSV:
Conjunto de datos JCSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process:
- Identifier Field: Dublin Core : Identifier
- Contains extra data: puede ser tanto Yes, … (paso 2 automatizado) como Perhaps, … (paso 2 manual).
¿ Contiene valores especiales ? : Sí, Record Type, Item Type, Public, Featured, Item y File.
¿ Contiene contenido extra ? : Sí, geolocation.
Conjunto de datos K: cómo importar contenido extra que no es gestionado como elementos, sino como datos de un objeto (tabla) específico. Los elementos existentes no siguen ningún estándar.
Descripción del conjunto: es igual al conjunto de datos J solo que en este caso el nombre de los elementos no sigue ningún estándar.
Fichero CSV:
Conjunto de datos KCSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process: Por defecto.
¿ Contiene valores especiales ? : Sí, Record Type, Item Type, Public, Featured, Item y File.
¿ Contiene contenido extra ? : Sí, geolocation.
Conjunto de datos L: cómo actualizar contenido extra existente en la plataforma.
Descripción del conjunto: es igual al conjunto de datos J solo que el contenido extra ha cambiado. Para que la actualización funcione, debes importar antes el
conjunto de datos J.Fichero CSV:
Conjunto de datos LCSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process: Por defecto.
¿ Contiene valores especiales ? : Sí, Record Type, Item Type, Public, Featured, Item y File.
¿ Contiene contenido extra ? : Sí, geolocation.
Conjuntos de datos M-1, M-2 y M-3: cómo gestionar el proceso de importación.
Descripción del conjunto:
- M-1: contiene información acerca de dos colecciones con ítems.
- M-2: similar al conjunto M-1 solo que este tiene contenido nuevo y actualizado ya que M-1 tiene algún error.
- M-3: se introduce un nuevo valor especial, Action, que permite actúar al fichero CSV como si fuera un script.
Ficheros CSV:
Conjunto de datos M-1,Conjunto de datos M-2yConjunto de datos M-3CSV format:
- Column delimiter: tabulation
- Enclosure: quotation mark «
- Element delimiter: pipe
- Tag delimiter: pipe
- File delimiter: pipe
Default values: Por defecto.
Process: Por defecto.
¿ Contienen valores especiales ? : Sí, Record Type, Item Type, Tags, Item, Collection y File. Además, en el caso del M-1, Action.
¿ Contienen contenido extra ? : Sí, geolocation.
Deshacer una importación CSV¶
Si por algún motivo se desea eliminar todos los elementos importados en una sesión, el complemento te permite realizar esta operación de forma sencilla.
Para deshacer una importación:
- Desde el complemento CSV Import+ (
/admin/csv-import-plus/). - En la pestaña Status (ver Figura 104), localizar la fila de la tabla que muestre la sesión desde la que se importaron los elementos que se desean eliminar.
- Hacer clic sobre el botón rojo «Undo import» situado bajo la columna «Action».
- Esperar a que el contador alojado en la columna «Imported records» esté a 0. Puedes actualizarlo recargando la página.
Eliminar un registro de una importación CSV desecha¶
- Desde el complemento CSV Import+ (
/admin/csv-import-plus/). - En la pestaña Status (ver Figura 104) , localizar la fila de la tabla que muestre la sesión asociada a la importación desecha.
- Hacer clic sobre el botón rojo «Clear History» situado bajo la columna «Action».
Ver también
OAI-PMH Harvester¶
A través de esta herramienta se pueden importar registros almacenados en otros repositorios on-line. Para ello, hace uso del protocolo OAI-PMH, el cual define un mecanismo para la recolección de registros que contienen los metadatos de los repositorios.
Recolectar metadatos de otros repositorios¶
Antes de empezar con el proceso de recolección, hay que cerciorarse de que el repositorio objetivo tenga implementado el protocolo OAI-PMH. Lamentablemente, no existe ningún procedimiento específico de cómo realizar esta operación. Por tanto, si queremos recolectar metadatos de un repositorio determinado, hay que ponerse en contacto con el administrador del sitio para preguntarle si el repositorio dispone de este servicio. En tal caso, se deberá pedir además el enlace a dicho servicio.
Para importar metadatos mediante el protocolo OAI-PMH:
Desde el complemento OAI-PMH Harvester (
/admin/oaipmh-harvester).Introducir el enlace del servicio OAI-PMH en el campo «Base URL de la sección «Data Provider» y hacer clic sobre el botón «View Sets».
- Si el enlace es correcto, se mostrará en la parte inferior todos los conjuntos de datos del repositorio objetivo (ver Figura 106).
En este punto se presentan dos opciones:
- Recolectar todos los metadatos existentes en el repositorio (sección «Harvest the entire repository»).
- Recolectar los metadatos de un conjunto de datos específico (sección «Harvest a set»).
Si se desea la opción a, localizar la fila correspondiente al conjunto de datos que se desea importar.
Seleccionar el esquema de metadatos en el que queremos obtener los metadatos.
Hacer clic sobre el botón «Go».
Actualizar una importación¶
Una de las ventajas de este protocolo es que nos permite realizar varios procesos de importación sobre un mismo repositorio, manteniendo así actualizados los metadatos recolectados de ese repositorio.
Después de que se haya completado el proceso de recolección de metadatos, aparecerá un botón con el nombre de «Re-harvest» en el registro de la tabla existente en la página principal del complemento (ver Figura 105).
Al hacer clic sobre ese botón se iniciará de nuevo el proceso de recolección, importando los nuevos ítems y aplicando cambios en los ya existentes.
Este proceso se puede hacer de forma manual volviendo a llevar a cabo los pasos del proceso de recolección.
Ver datos de una importación¶
Si queremos observar los acontecimientos que van sucediendo durante la importación, el complemento OAI-PMH Harvester lo permite.
Para visualizar los datos de una importación:
- Desde el complemento OAI-PMH Harvester (
/admin/oaipmh-harvester). - En la tabla que contiene todas las recolecciones efectuadas (ver Figura 105), clicar sobre el estado de la recolección que quieras visualizar.
- En la página actual (ver Figura 108), se mostrarán los datos de la importación.
Deshacer una importación¶
Existe la posibilidad de eliminar todos los ítems/colecciones recolectadas.
Para deshacer una importación:
- Desde el complemento OAI-PMH Harvester (
/admin/oaipmh-harvester). - En la tabla que contiene todas las recolecciones efectuadas (ver Figura 105), clicar sobre el estado (Complete) de la recolección que quieras deshacer.
- En la página actual (ver Figura 108), hacer clic sobre el hipertexto «Delete Items».
ARIADNEplus Tracking¶
El complemento ARIADNEplus Tracking incluye nuevas funciones que facilitan el proceso de integración en ARIADNEplus para cada conjunto de datos almacenado en la plataforma. Antes de iniciar cualquier proceso de integración, deben existir conjuntos de datos dentro de la plataforma con los que podamos trabajar (Ver Importar datos CSV , Recolectar metadatos de otros repositorios , Crear un ítem o Crear una colección).
Crear un ticket¶
Para someter una colección o ítem al proceso de integración de ARIADNEplus se debe crear antes un ticket. Este nos guiará y permitirá llevar un seguimiento del proceso.
Para crear un nuevo ticket:
- Desde el complemento ARIADNEplus Tracking (
/admin/ariadne-plus-tracking). - En la página principal, hacer clic sobre el hipertexto «create new one» situado bajo la tabla de tickets (ver Figura 109)..
- En la página actual (ver Figura 110), seguir los pasos indicados: a. Seleccionar el tipo de dato que se pretende gestionar, pudiendo escoger entre «Collection» o «Item», y hacer clic sobre el botón Continue. b. Seleccionar el dato específico que se pretende introducir en el proceso y hacer clic sobre el botón Continue. c. Seleccionar la categoría fundamental de ARIADNEplus a la que el elemento seleccionado pertenece y hacer clic sobre el botón Create.
- Aceptar el mensaje de confirmación haciendo clic sobre «Yes, create it».
Eliminar un ticket¶
Pueden darse diversos motivos por los que ya no interese seguir con el proceso de integración para un determinado conjunto de datos. En tal caso, es conveniente eliminar el ticket correspondiente.
Para eliminar un ticket existente:
- Desde el complemento ARIADNEplus Tracking (
/admin/ariadne-plus-tracking). - En la página principal, debemos visualizar una tabla con, al menos, una entrada (ver Figura 109).
- Localizar, en la tabla, la fila correspondiente al ticket que se quiere eliminar.
- Hacer clic sobre el botón circular «x» situado en la columna Action (última columna).
- Aceptar el mensaje de confirmación haciendo clic sobre «Yes, delete it».
Ver registros de un ticket¶
Cada vez que se solicita un cambio de fase, se genera un registro, el cual contiene un conjunto de mensajes informativos que indican los cambios que se van realizando. Puede resultar útil si queremos saber más acerca de lo que ocurre «por detrás» en cada cambio de fase.
Para someter una colección o ítem al proceso de integración de ARIADNEplus se debe crear antes un ticket. Este nos guiará y permitirá llevar un seguimiento del proceso.
Para visualizar los registros de un ticket existente:
- Desde el complemento ARIADNEplus Tracking (
/admin/ariadne-plus-tracking). - En la página principal, debemos visualizar una tabla con, al menos, una entrada.
- Localizar, en la tabla, la fila correspondiente al ticket que se quiere consultar.
- Hacer clic sobre el hipertexto situado en las columnas Type e Id (segunda columna por la izquierda).
Cambiar de fase dentro un ticket¶
El ciclo de vida de un ticket pasa por seis fases distintas, cada una de las cuales cuenta con sus propias reglas. Para pasar de una fase a otra, se deberán cumplir las reglas de la fase de partida. En la Tabla 15, se muestra el conjunto de reglas por fase.
| Fase | Reglas | Tipos de regla |
|---|---|---|
| 01 |
|
|
| 02 |
|
|
| 03 |
|
|
| 04 |
|
|
| 05 |
|
Además de cumplir con estas reglas, se deben tener en cuenta las siguientes condiciones:
El paso de fases es secuencial, esto implica que, por ejemplo, para pasar a la fase 03 hemos tenido que completar previamente las fases 01 y 02.
Para garantizar la consistencia de los datos, no se permite cambiar de fase en sentido contrario, por lo que si pasamos a la fase 02, no podremos retroceder hacia la fase 01.
- Existen algunas excepciones a esta limitación: en las fases 04 y 06 es posible retroceder hasta la fase 01. Estas excepciones vienen dadas por el propio proceso de integración al que estamos sometiendo los datos.
Cada vez que ejecuta satisfactoriamente un cambio de fase, se actualiza el estado del ticket.
Para cambiar de fase dentro de un ticket:
- Desde el complemento ARIADNEplus Tracking (
/admin/ariadne-plus-tracking). - En la página principal, debemos visualizar una tabla con, al menos, una entrada. Cada entrada es un ticket.
- Clicar sobre la fila correspondiente al ticket que se quiere gestionar.
- En la página actual (
/ariadne-plus-tracking/index/ticket), hacer clic sobre el botón «Next Phase» en caso de querer avanzar de fase o sobre el botón «Restart» en caso de querer retroceder hasta la primera fase. Ambos situados en la parte inferior central de la aplicación.
Configuración¶
La aplicación permite configurar ciertos aspectos que afectan al proceso de integración. Para acceder a la página de configuración, ver Configurar complementos (plugins)
A continuación se muestran todas las opciones posibles de configuración:
«Rights and Roles»: gestionar qué usuarios pueden utilizar la herramienta.
«ARIADNEplus contact details»: establece la información de contacto de la persona encargada de supervisar las importaciones del CENIEH.
«Elements»: gestiona aspectos relacionados con los elementos de los esquemas de metadatos existentes en la plataforma.
Campo «Display Remove Checkbox»: si se activa, se mostrará un checkbox en la página de configuración de elementos para eliminar cualquier elemento existente en el esquema de metadatos Monitor. Este esquema es el que recoge todos los campos relacionados con el proceso de integración (estado de los metadatos, categoría ARIADNEplus, etc.).
- Aviso: todos los datos almacenados en los elementos seleccionados se eliminarán y no serán recuperables. Por lo tanto, verifique primero si las copias de seguridad están actualizadas y funcionando.
«Hide unnecessary Dublin Core elements»: si se activa, todos los elementos del esquema de metadatos Dublin Core considerados como innecesarios para el proyecto se ocultarán. Estos pueden ser configurados desde la tabla que puede ser desplegada pulsando sobre el botón «Show».
Sección «Permissions»: gestiona los permisos de los usuarios.
«Mandatory Elements»: establece los elementos del esquema de metadatos Dublin Core que serán obligatorios durante el proceso de integración, es decir, han de ser rellenados obligatoriamente. Estos pueden ser configurados desde la tabla que puede ser desplegada pulsando sobre el botón «Show».
«Specific admin display»: establece los elementos que serán mostrados en las distintas zonas del buscador de ítems. Estos pueden ser configurados desde la tabla que puede ser desplegada pulsando sobre el botón «Show».
- «Search»: en el buscador de ítems, saldrá como opción de búsqueda el elemento seleccionado.
- «Filter»: en la lista de filtros del buscador, aparecerá el elemento seleccionado como un filtro más.
- «Directly»: en cada ítem/colección aparecerá directamente sobre la tabla el elemento seleccionado.
- «Details»: se mostrará el elemento seleccionado en el desplegable donde se muestran los detalles de cada ítem/colección.
Ver también
CSV Export¶
El complemento CSV Export permite exportar todos los ítems almacenados en la plataforma en formato CSV. A través de la entrada «CSV Export», dentro de la sección «Export Tools» del menú principal de administración, se accede a la página principal del complemento.
Desde su página principal solo se puede exportar TODOS los ítems almacenados en la plataforma.
Para exportar todos los ítems existentes en formato CSV:
- Desde el complemento CSV Export (
/admin/csv-export/). - Hacer clic sobre el botón «Export all data as CSV».
- Confirmar la descarga.
Si solo deseas exportar un ítem/colección específico en CSV, mira la sección Exportar ítems.
El documento CSV descargado podrá volver a ser importado a la plataforma a través del complemento CSV Import+ independientemente de las modificaciones que se hagan sobre él.
Ver también
Bulk Editor¶
El complemento Bulk Editor aporta una herramienta denominada Bulk Metadata Editor que permite modificar los metadatos de múltiples ítems a la vez en base a unas reglas. El acceso a esta herramienta se encuentra dentro de la sección «Edit Tools» del menú principal de administración.
Para editar varios ítems a la vez:
Desde el complemento Bulk Editor (
/admin/bulk-metadata-editor/).Seleccionar los ítems que se desean modificar:
Collection: Para seleccionar los ítem de una determinada colección.
Select Items by Metadata: Para seleccionar los ítems en base al contenido de sus metadatos.
Para crear una regla:
- Seleccionar el metadato a comprobar.
- Seleccionar la condición.
- Indicar el valor de la condición.
- Si queremos que el valor coincida de forma exacta, marcar la casilla Match Case.
Hacer clic sobre el botón «Preview Selected Items» para comprobar que los ítems seleccionados son los correctos.
Seleccionar los metadatos que deseamos modificar.
Tips: Mantener pulsado la tecla Crtl para escoger varios metadatos salteados.
Hacer clic sobre el botón «Preview Selected Fields» para visualizar el contenido actual de los metadatos seleccionados.
Seleccionar el tipo de cambio a ejecutar sobre los metadatos seleccionados.
- Search and replace text: busca texto en el contenido de los metadatos seleccionados y lo sustituye.
- Add a new metadatum in the selected field: añade un nuevo campo a los metadatos seleccionados.
- Prepend text to existing metadata in the selected fields: añade texto al principio del contenido actual de los metadatos seleccionados.
- Append text to existing metadata in the selected fields: añade texto al final del contenido actual de los metadatos seleccionados.
- Explode metadata with a separator in multiple elements in the selected fields: dado un separador, divide el contenido actual de los metadatos seleccionados en varios campos.
- Deduplicate and remove empty metadata in the selected fields: elimina campos vacíos o duplicados existentes en los metadatos seleccionados.
- Deduplicate files of selected items by hash: elimina ficheros duplicados de los ítems seleccionados.
- Delete all existing metadata in the selected fields: elimina todos los metadatos seleccionados.
Marcar la casilla Background Job si se desea ejecutar la operación en segundo plano.
Hacer clic sobre el botón «Apply Edits Now».
Tags Manager¶
El complemento Tags Manager añade nuevas funcionalidades:
- Sincronización entre tags y el elemento Subject del esquema de metadatos Dublin core: cuando se crea/importa un ítem, si este cuenta con el elemento Subject del esquema de metadatos Dublin Core, se crea de forma automática un nuevo tag cuyo nombre es el contenido del elemento Subject.
- Eliminación masiva de tags: permite eliminar varios tags a la vez.
Estas funcionalidades se pueden activar/desactivar su página de configuración (ver Configurar complementos (plugins)).
Ver también
Geolocation Modified¶
Nota
Sólo se explicarán aquellas funcionalidades añadidas a la versión original del complemento Geolocation. Si quieres saber más acerca del plugin, haz clic aquí.
El complemento Geolocation Modified es una versión mejorada del complemento Geolocation. Las funcionalidades que se han añadido son:
- Marco avanzado de dibujo: añade en el mapa un cuadro de herramientas que permite trazar localizaciones simples (marcadores) y compuestas (rectangulares).
- Sincronización entre geolocalizaciones y el elemento Spatial Coverage del esquema de metadatos Dublin Core: cuando se establece una geolocalización para un ítem, el elemento Spatial Coverage del ítem se actualiza con las coordenadas de la geolocalización.
- Sincronización inversa: cuando se crea/importa un ítem, si este cuenta con el elemento Spatial Coverage del esquema de metadatos Dublin Core, se crea y asocia de forma automática una nueva geolocalización con las coordenadas indicadas por el elemento Spatial Coverage.
Nota
Solo se puede activar un tipo de sincronización a la vez.
Estas funcionalidades se pueden activar/desactivar su página de configuración (ver Configurar complementos (plugins)).
- Enable draw plugin para activar/desactivar el marco avanzado de dibujo.
- Spatial Coverage synchronization y Reverse Spatial Coverage synchronization para activar/desactivar las funcionalidades de sincronización.
Ver también
CENIEH export¶
El complemento CENIEH export añade tres formatos de exportación para las colecciones y uno para los ítems. Este formato se ha adaptado a las necesidades del proyecto ARIADNEplus.
Para cada colección:
Figura 117 Panel con los formatos de exportación de colecciones (/admin/collections/show/<idCollection>)
- CENIEHfull: exporta en un único fichero XML toda la colección, incluyendo a cada uno de sus ítems.
- CENIEHfullzip: exporta todos los ítems de la colección generando un fichero XML por ítem. Todos ellos comprimidos dentro de un fichero .zip.
- CENIEHmeta: exporta únicamente la colección, sin incluir ninguno de sus ítems.
Para cada ítem:
Figura 118 Panel que muestra los formatos de exportación de colecciones (/admin/items/show/<idItem>)
- CENIEH: exporta el ítem en un único fichero XML.
Ver también
Collection Files¶
El complemento Collection Files permite asociar ficheros a las colecciones. En la versión original de Omeka esta funcionalidad sólo está implementada para los ítems.
Figura 120 Panel que muestra los ficheros asociados a una colección (/admin/collections/show/<idCollection>)
Figura 121 Vista desde donde se visualiza un fichero asociado a una colección (/admin/collections/edit/<idCollection>)
Ver también
Automatic Dublin Core Updates¶
El complemento Automatic Dublin Core Updates permite actualizar automáticamente el contenido de alguno de los elementos del esquema de metadatos Dublin Core.
Para activar/desactivar la actualización automática de elementos:
- Acceder a la página de configuración del complemento Automatic Dublin Core Updates (ver Configurar complementos (plugins)).
- Marcar/Desmarcar la casilla del elemento que se quiera activar/desactivar.
- Pulsar sobre el botón «Save Changes».
OAI-PMH Repository¶
El complemento OAI-PMH Repository permite que otros repositorios web recolecten metadatos de nuestra aplicación.
El endpoint de la aplicación tiene el siguiente formato: http://<host>/oai-pmh-repository/request.
Simple Pages¶
El complemento Simple Pages permite añadir páginas simples como la de «About» al área pública. Desde la entrada «Simple Pages», dentro de la sección «Others» del menú principal, se accede al gestor de páginas simples (/admin/simple-pages/).
Para añadir una página simple:
Desde el complemento Simple Pages (
/admin/simple-pages/).Hacer clic sobre el botón «Add a Page».
Rellenar el formulario:
- Title: nombre y cabecera para la página.
- Slug: parte de la URL que referencia a la página.
- Use HTML editor?: activar/desactivar el editor HTML para crear el contenido de la página.
- Text: contenido de la página.
- Parent: página «padre».
- Order: orden de la página respecto a otras con el mismo «padre».
- Publish this page?: publicar/desplublicar la página.
Hacer clic sobre el botón «Save changes».
Para eliminar una página simple:
- Desde el complemento Simple Pages (
/admin/simple-pages/). - Localizar la página a eliminar en la tabla principal.
- Hacer clic sobre el texto «Delete».
- Confirmar la eliminación haciendo clic sobre el botón rojo «Delete».
Para editar una página simple:
- Desde el complemento Simple Pages (
/admin/simple-pages/). - Localizar la página a eliminar en la tabla principal.
- Hacer clic sobre el texto «Edit».
- Modificar el formulario.
- Hacer clic sobre el botón «Save changes».
History Log¶
El complemento History Log permite llevar un registro detallado de todas las acciones (eliminar, editar, crear, etc.) ejecutadas en la plataforma. Desde la entrada «History Logs», dentro de la sección «Others» del menú principal, se accede a todos los registros de la aplicación (/admin/history-log/).
Desde su página principal se pueden hacer búsquedas avanzadas y aplicar filtros sobre todos los registros de la aplicación.
Getty Suggest¶
El complemento Getty Suggest permite sugerir términos de los vocabularios Getty durante el relleno de un elemento (metadato). Desde la entrada «Getty Suggest», dentro de la sección «Others» del menú principal, se accede a todos los registros de la aplicación (/admin/getty-suggest/).
Para activar la sugerencia de vocabulario en un metadato:
- Desde el complemento Simple Pages (
/admin/getty-suggest/). - Rellenar el formulario.
- Element: metadato en el que se activará la sugerencia.
- Authority/Vocab: vocabulario Getty a sugerir.
- Hacer clic sobre el botón «Add Suggest».
Para desactivar la sugerencia de vocabulario en un metadato:
- Desde el complemento Simple Pages (
/admin/getty-suggest/). - Buscar en la tabla de asignaciones el metadato a desactivar.
- Hacer clic sobre el botón «Delete».
Para editar la sugerencia de vocabulario en un metadato:
- Desde el complemento Simple Pages (
/admin/getty-suggest/). - Buscar en la tabla de asignaciones el metadato a editar.
- Hacer clic sobre el botón «Edit».
- Modificar desde la tabla el metadato o la autoridad.
- Hacer clic sobre el botón «Save».
Ver también
Simple Vocab¶
El complemento Simple Vocab permite crear y gestionar vocabularios simples para elementos de un determinado esquema. Desde la entrada «Simple Vocab», dentro de la sección «Others» del menú principal, se accede al gestor de vocabularios simples (/admin/simple-vocab/).
Para crear un vocabulario sobre un metadato específico:
- Desde el complemento Simple Vocab (
/admin/getty-suggest/). - Rellenar el formulario.
- Element: metadato en el que se activará el vocabulario.
- Vocabulary terms: términos del vocabulario, uno por línea.
- Hacer clic sobre el botón «Save Changes».
Para eliminar un vocabulario sobre un metadato específico:
- Desde el complemento Simple Vocab (
/admin/getty-suggest/). - Seleccionar en el formulario el metadato donde se encuentra activado el vocabulario.
- Element: metadato involucrado.
- Eliminar todos los términos del campo «Vocabulary Terms».
- Hacer clic sobre el botón «Save Changes».
Para editar un vocabulario sobre un metadato específico:
- Desde el complemento Simple Vocab (
/admin/getty-suggest/). - Seleccionar en el formulario el metadato donde se encuentra activado el vocabulario.
- Element: metadato involucrado.
- Editar los términos del campo «Vocabulary Terms».
- Hacer clic sobre el botón «Save Changes».
Curatescape Admin Helper¶
El complemento Curatescape Admin Helper implementa funcionalidades que brindan ayuda a los administradores de la aplicación.
Ver también
Curatescape JSON¶
El complemento Curatescape JSON implementa funcionalidades para la plantilla de diseño (theme) Curatescape.
Ver también
Dublin Core Extended¶
El complemento Dublin Core Extended implementa nuevos elementos en el esquema de metadatos Dublin Core.
Hide Elements¶
El complemento Hide Elements permite ocultar elementos de los esquemas de metadatos existentes en la plataforma.
Super RSS¶
El complemento Super RSS muestra enlaces para compartir publicaciones (área pública) en redes sociales.
Ver también

































































































