Gijon Tutorial Dspace

Toni [email protected]

Universitat Politcnica de CatalunyaServei de Biblioteques i DocumentaciTutorial DSpace Gijn, diciembre de 2007 Ecologa de los repositorios institucionales

SumarioIntroduccin a DSpaceFuncionalidadesPersonalizacinHerramientas administrativas (scripts)Conclusin

Ecologa de los repositorios institucionales. Gijn, diciembre del 2007

Introduccin Funcionalidades Personalizacin Scripts Conclusin Introduccin a DSpace

Software en cdigo abierto para implementar depsitos digitales.Objetivo: Coleccionar y organizar la produccin intelectual de una institucin, describirla, diseminar y preservar sus objetos digitales. Actualmente en la versin estable 1.4.2. Versin 1.5 en fase alfa


Introduccin Funcionalidades Personalizacin Scripts Conclusin Modelo de Datos ILa informacin que almacena DSpace est estructura en 5 componentes bsicos:1.- Comunidades/subcomunidades (conjunto de colecciones y subcomunidades)2.- Colecciones (agrupaciones de tems con un workflow en comn)3.- tems (metadatos + archivos)4.- Bundles (paquetes de archivos) Archivos originales: ORIGINAL De licencia: LICENSE, CC-LICENSE Generados a partir de los originales: TEXT, THUMBNAIL5.- Bitstreams (archivos)


Introduccin Funcionalidades Personalizacin Scripts Conclusin Modelo de Datos II


Introduccin Funcionalidades Personalizacin Scripts Conclusin Visin general I

Dos interfaces web: JSPUI / XMLUI (Manakin)Interfaz web bastante completa: mostrar el contenido, aadir nuevo y administrar.XHTML 1.0 y WAIMultilenguageMotor de bsqueda, basado en lucene, indexacin de texto completondices de navegacin: ttulo, autor, materia y fecha (configurable) RSSOAI-PMHHerramientas de importacin e exportacin de temsHerramientas de exportacin en diferentes formatos en XML (METS, MODS. DCQ, MPEG-21)


Introduccin Funcionalidades Personalizacin Scripts Conclusin Visin general II

Nivel coleccin / comunidadPgina propia para las comunidades y colecciones: posibilidad aadir logo, texto personalizados,... Alertas por coleccinRSS a nivel de coleccin y de comunidadndices de navegacin y bsquedas acotados a nivel de coleccin y comunidad

Nivel de temDiferentes niveles de acceso: abierto, solo metadatos,... Recomendar un temOpenURLHandle: identificadores persistentesMetadatos: nivel simple (configurable) /nivel completoLicencias creative commons


Introduccin Funcionalidades Personalizacin Scripts Conclusin Metadatos IInicialmente esquema DC Qualifiedhttp://dublincore.org/documents/dcmi-terms/Soporta ms de un esquemaSe puede modificar a travs de la interfaz webAadir nuevos DCQ al esquema por defectoCrear nuevos esquemasMover elementos entre esquemasUTF-8Soporte para metadatos en diferentes lenguas


Introduccin Funcionalidades Personalizacin Scripts Conclusin Metadatos IIUn metadato en DSpace tiene asociado:EsquemaElementoCualificadorLenguaValor


Introduccin Funcionalidades Personalizacin Scripts Conclusin

Autorizacin Los autorizaciones se gestionan a travs de dos objetos:Eperson: una cuenta usuario Group: un conjunto de usuariosExisten dos grupos especiales, annimo, administradores. Se pueden crear grupos a partir de otros grupos.Modelo flexible:Para la mayora de objetos del modelo de datos es posible dar permisos de lectura, insercin, edicin, borrado.En el caso de las colecciones existe el rol administrador de coleccin.En el caso de los tems es posible definir diferentes niveles de lectura: restringir el acceso al texto completo o a todo.


Introduccin Funcionalidades Personalizacin Scripts Conclusin AutenticacinSistema por defecto - correo electrnico / contrasea LDAPCertificados X.509Sistema basado en IP (versin 1.5)Posibilidad de utilizar ms de un mtodo de autenticacin a la vez


Introduccin Funcionalidades Personalizacin Scripts Conclusin Formulario de envoEl formulario de envo consta de diversos pasos.Seleccin de la coleccinPreguntas previasMetadatos (2 pasos)Inclusin de archivosRevisinSeleccin Licencia Creative Commons (opcional)Aceptacin licencia final El formulario de metadatos es configurable mediante un archivo de configuracin propio. Ahora lo veremos... En la versin 1.5 tambin es posible modificar/adaptar estos pasos mediante otro archivo de configuracin. Incluir nuevos pasos, modificarlos, ...


Introduccin Funcionalidades Personalizacin Scripts Conclusin WorkflowPaso 1: aceptar / rechazar envoPaso 2: aceptar / rechazar envo + editar metadatosPaso 3: editar metadatosA nivel de coleccin, por cada coleccin se puede definir que pasos estn activos.Cada paso se asocia un conjunto de usuariosSe pueden definir un conjunto de metadatos por defectoSe puede modificar a travs de la interfaz de usuario.


Introduccin Funcionalidades Personalizacin Scripts Conclusin OAI-PMHInicialmente esquema Dublin Core sin cualificarLos sets que ofrece son las colecciones definidas en DSpace. En la versin 1.5 se han incluido las comunidades.Configurable para servir otros esquemas de metadatos a travs de Crosswalks de Dublin Core: Mets, mod, dcq, ...


Introduccin Funcionalidades Personalizacin Scripts Conclusin Manakin IUn nueva interfaz web de DSpace basada en XMLApache Coocon, XSL, CSSManakin vs interfaz JSPInterfaz JSPLa interfaz JSP es difcil y costosa de modificar y extender.Una interfaz nica para todas las colecciones a pesar de poder tener diferente contenidoManakinFacilidad para cambiar el estilo de la interfazMejorar la visualizacin: permitir mostrar los metadatos de formas muy distintasDiseo modular: fcil de extender, adaptar y personalizar


Introduccin Funcionalidades Personalizacin Scripts Conclusin Manakin IITres componentes bsicosAspects Son los generadores de contenido en XMLImplementan un conjunto de funcionalidades relacionadasEsquema DRI (Digital Repository Interface)Representacin abstracta en XML de la pgina del repositorioEs la entrada y salida de los aspectsTema: definen como se visualiza el contenidoTres partes fundamentales:Sitemap.xml: fichero de configuracin del temaHoja(s) de estilo XSL: transforma el DRI Schema (XML) en HTMLHoja de estilo CSS: determina la visualizacin final


Introduccin Funcionalidades Personalizacin Scripts Conclusin Manakin IIIArchivo xmlui.confDefine los aspects que intervienen Define los temas que se aplican a cada pgina. Se pueden a aplicar a:Una nica pgina:

A todas las pginas de una comunidad / coleccin: A todo/resto del repositorio


Introduccin Funcionalidades Personalizacin Scripts Conclusin Localizacin carpetasHay que tener en cuenta que diferentes partes de DSpace residen en diferentes zonas del servidor:[dspace-source]: el cdigo fuente de DSpace, aqu se deben realizar los cambios / personalizaciones de la interfaz [tomcat]: donde estn las interfaces web de DSpace funcionando[dspace]: contiene los archivos de configuracin (dspace.cfg, input-forms.xml, ...), scripts de administracin, archivos almacenados, ...


Introduccin Funcionalidades Personalizacin Scripts Conclusin Archivo configuracinArchivo [dspace]/config/dspace.cfgAqu estn:La configuracin bsicaFuncionalidades que se pueden activar o desactivarLa configuracin de las interfazEs un listado de claves / valores: webui.itemdisplay.default = dc.title, \ dc.contributor.*, \ ... Cada par clave valor debe ir en una sola linea, si no se debe escapar con \


Introduccin Funcionalidades Personalizacin Scripts Conclusin Cambiar apariencia global

[dspace-source]/jsp/layout/*.jsp archivos comunes casi todas las pginas[dspace-source]/jsp/styles.css.jsp hoja de estiloLos archivos modificados se deberan guardar en [dspace-source]/jsp/local/...Despus de realizar los cambios se debe recompilar y volver a copiar la interfaz en el webapp del tomcat.


Introduccin Funcionalidades Personalizacin Scripts Conclusin Cambiar textoDSpace usa archivos de i18n para gestionar los textos de la interfaz:[dspace-source]/config/language-packs/Messages.properties Es un listado de claves-valor:jsp.home.com1 = Communities in DSpacejsp.home.com2 = Choose a community to browse its collections.

En los archivos jsp estn referenciados as:

Por cada cambio se debe recompilar el DSpace y volverlo a instalar en Tomcat.


Introduccin Funcionalidades Personalizacin Scripts Conclusin InternacionalizacinPara incluir o cambiar la traduccin en castellano se debe incluir una rplica del archivo Messages.properties traducido:[dspace-source]/config/language-pack/Messages_es.propertiesLa interfaz se mostrar en el idioma en que este configurado el navegador web.Para incluir un selector de idioma, se debe instalar un parche:[ Patch 1450491 ] i18n configurable multilingualism supportPara activar el soporte multilenguage es necesario modificar un par de claves de dspace.cfg:default.locale = eswebui.supported.locales = es, enVersin 1.5:La posicin de los archivos ha cambiado:[dspace-source]/dspace-api/src/main/resource/Messages.properties (principal) [dspace-source]/language-packs/es/Messages_es.properties Ya incluye el parche para hacer la plataforma multilenguajeLa interfaz XML (manakin) tiene su propio archivo de textos diferenciado. En formato xml.[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/src/main/webapp/i18n/messages.xml


Introduccin Funcionalidades Personalizacin Scripts Conclusin Visualizacin simple de metadatos de un tem I

En la interfaz jsp es posible modificar los metadatos que se muestran en la visualizacin simple de un tem modificando una clave del archivo dspace.cfg:webui.itemdisplay.default = dc.title, dc.title.alternative, dc.contributor.*, \ dc.subject, dc.date.issued(date), dc.publisher, \ dc.identifier.citation, dc.relation.ispartofseries, \ dc.description.abstract, dc.description, \ dc.identifier.govdoc, dc.identifier.uri(link), \ dc.identifier.isbn, dc.identifier.issn, \ dc.identifier.ismn, dc.identifier (link) -> el metadato se mostrar como un enlace(date) -> el metadato se mostrar como una fecha en el idioma en que se este mostrando la interfaz


Introduccin Funcionalidades Personalizacin Scripts Conclusin Visualizacin simple de metadatos de un tem II

Es posible definir listados de metadatos distintos en algunas colecciones:

webui.itemdisplay..collections = , ...

webui.itemdisplay.tutorial.collections = 123456789/3 webui.itemdisplay.tutorial = dc.title, dc.contributor.*, \ dc.relation.ispartof, dc.identifier.citation, \ dc.description.tableofcontents, my.custom.metadata, \ dc.identifier.uri(link)


Introduccin Funcionalidades Personalizacin Scripts Conclusin Visualizacin simple de metadatos de un tem III

Etiquetas ??? alguna.clave.exto??? Si se incluyen nuevos metadatos a mostrar es necesario incluir las claves i18n en el archivo de textos de la interfaz (Messages.properties): metadata... = ... (ej.: metadata.dc.title, metadata.dc.identifier.citation)


Introduccin Funcionalidades Personalizacin Scripts Conclusin Bsqueda e ndicesBsquedaDSpace utiliza un motor de bsqueda basado en Lucene.Lucene crea un conjunto de ndices que guarda en [dspace]/searchndices de navegacinTambin dispone de ndices para la navegacin a partir de ciertos metadatos del tem: listado por ttulo, fecha de publicacin, autor y materia. Estos ndices se guardan en tablas de la base de datos.En dspace.cfg se puede configurar parte del sistema de bsqueda e ndices:


Introduccin Funcionalidades Personalizacin Scripts Conclusin Bsqueda IDefinir los ndices que queremos tener:Los ndices estn definidos a partir de claves de esta forma: search.index. = nombre_indice:schema.element.qualifier es el nmero de ndice definido Para un ndice se puede asignar ms de un metadato creando ms de una entrada de search.index. (ejemplo ndice author)En lugar de qualifier se puede incluir * para indexar cualquier metadato con ese elemento La configuracin bsica utiliza otro ndice llamado default que contiene:Todos los ndices definidosEl texto completo extradoEl nombre de las comunidades y colecciones


Introduccin Funcionalidades Personalizacin Scripts Conclusin Bsqueda IIDefinicin de ndices que viene por defecto: search.index.1 = author:dc.contributor.* search.index.2 = author:dc.creator.* search.index.3 = title:dc.title.* search.index.4 = keyword:dc.subject.* search.index.5 = abstract:dc.description.abstract search.index.6 = author:dc.description.statementofresponsibility search.index.7 = series:dc.relation.ispartofseries search.index.8 = abstract:dc.description.tableofcontents search.index.9 = mime:dc.format.mimetype search.index.10 = sponsor:dc.description.sponsorship search.index.11 = identifier:dc.identifier.* search.index.12 = language:dc.language.iso

Si se incluyen nuevos ndices, para que aparezcan en la interfaz es necesario modificar el archivo que genera el formulario de bsqueda avanzada. No se incluye automticamente!


Introduccin Funcionalidades Personalizacin Scripts Conclusin ndices de navegacin IActualmente ofrece 4 ndices de navegacin (ttulo, autor, materia, fecha) A travs de dspace.cfg se puede elegir que metadatos utiliza: webui.browse.index.date = dc.date.issued webui.browse.index.author = dc.contributor.* webui.browse.index.title = dc.title webui.browse.index.subject = dc.subject.*

Y definir que metadatos se muestran en los listados: webui.itemlist.columns = dc.date.issued(date), dc.title, dc.contributor.*


Introduccin Funcionalidades Personalizacin Scripts Conclusin ndices de navegacin IIEn la versin 1.5 se han incluido varias mejoras para hacer estos ndices ms configurables:

Se puede crear ms ndices (no solo los 4 que vienen por defecto). Definir para que campos se pueden ordenar los listados y como se ordenan estos camposMs opciones sobre como mostrar los ndices (nmero de autores que muestra, longitud mxima de campo listado, ... )


Introduccin Funcionalidades Personalizacin Scripts Conclusin Bsqueda e ndicesCada vez que realizamos algn cambio en la configuracin que afecta a la bsqueda o a los ndices de navegacin es necesario re-indexar mediante el script index-all: [dspace]/bin/index-all En la versin 1.5 el cambio en la configuracin de ndices puede implicar que se deban cambiar algunas tablas. Se puede utilizar este comando para reconstruir las tablas: [dspace]/bin/dsrun org.dspace.browse.IndexBrowse f r


Introduccin Funcionalidades Personalizacin Scripts Conclusin Formulario de envo IPara modificar el formulario de envo es necesario modificar el archivo de configuracin [dspace]/config/input-forms.xml

...

...

...

Introduccin Funcionalidades Personalizacin Scripts Conclusin Formulario de envo IILa etiqueta field:


dc

El nombre del esquema

contributor

El elemento del metadato

author

El cualificador del metadato. Puede estar vaco.

true

Si es o no repetible

Authors

La etiqueta que se muestra

name

El tipo de campo

Enter the names of the authors of this item The help text to be showed to the submitter below.

Texto de ayuda, instrucciones de que se debe incluir exactamente.

Texto que se muestra si no se ha rellenado el campo. Si no hay nada el campo es opcional.

Opcional. Para indicar si es visible solo durante el envo o la revisin

Introduccin Funcionalidades Personalizacin Scripts Conclusin Formulario de envo IIIInput-type define el tipo de campo::Campo de texto libre:onebox : un campo simple de texto (ej.: ttulo)twobox: dos campos simples de texto (ej.: materias)textarea: campo de texto largo (ej.: abstract, resumen)

Campo de datos especficosname: nombre de personas (apellido, nombre)date: fecha

Campos de datos con valores controladosdropdown : un seleccionablelist: implementado como checkbox o radio button qualdrop_value : compuesto de un seleccionable para escoger el cualificador, y un campo de texto para introducir el valor


Introduccin Funcionalidades Personalizacin Scripts Conclusin Formulario de envo IVEn los campos de tipo onebox, twobox o textarea, se puede aadir la etiqueta: XXX para capturar los valores de un vocabulario controlado Las vocabularios controlados estn definidos en archivos xml en [dspace]/config/controlled-vocabulary/ y tiene esta forma:

... ...


Introduccin Funcionalidades Personalizacin Scripts Conclusin Formulario de envo VSe pueden realizar bsquedas en el vocabulario controlado a travs de la interfaz:

Se debe activar en el archivo de configuracinwebui.controlledvocabulary.enable = true


Introduccin Funcionalidades Personalizacin Scripts Conclusin Scripts IA parte de la interfaz web DSpace incorpora un conjunto de utilidades de administracin ejecutables a travs de lnea de comandosSe trata en su mayora de clases java ejecutables que se deben usar mediante el script dsrun: [dspace]/bin/dsrun org.dspace.administer.CommunityFiliatorLas ms utilizadas son directamente ejecutables mediante scripts especficos en [dspace]/bin[dspace]/bin/index-allAlgunas se deben programar para ejecutar diariamente (cron de linux)


Introduccin Funcionalidades Personalizacin Scripts Conclusin Scripts II


import

export

Importacin /exportacin de tems mediante archivos en xml.

create-administrator

Crear un administrador

index-all

Re-construir los ndices de DSpace (bsqueda y navegacin)

packager

Otro script de importacin que permite importar tems empaquetados (archivos comprimidos, PDF, ...)

structure-builder (v. 1.5)

Creacin de estructura de comunidades colecciones

Introduccin Funcionalidades Personalizacin Scripts Conclusin ItemImport[dspace]/bin/dsrun org.dspace.app.itemimport -a -w -c -e -s -m mapfileO[dspace]/bin/import -a -w -c -e -s -m mapfileScript para hacer importaciones de tems en DSpaceExiste su anlogo para realizar exportaciones: ItemExportEn tres modos: insercin, borrado, modificadoLos tems deben tener como mnimo dos archivos:dublin_core.xml xml con los metadatos contents listado de archivos a cargararchivos a cargar


Introduccin Funcionalidades Personalizacin Scripts Conclusin Tareas programables (cron)


Hoja1

&C&A

&CPgina &P

filter-media

Creacin de archivos: extraccin del texto completo, miniaturas de imgenes, ...

sub-daily

Enviar los correos de subscripcin a las colecciones

stat-general

stat-monthly

stat-report-general

stat-monthly-general

Generar estadsticas de DSpace

(sobre todo estadsticas administrativas)

checker

Comprobar la integridad de los archivos

generate-sitemaps (v. 1.5)

Creacin de sitemaps google

Introduccin Funcionalidades Personalizacin Scripts Conclusin Filter-media[dspace]/bin/filter-media

Para generar archivos secundarios a partir de los originalesActualmente usado para:Extraer el texto de los archivos para poder hacer bsquedasExtraccin de miniaturas de imgenes para su visualizacin en listadosExtraccin / creacin de imgenes con texto incrustadoTambin lanza una re-indexacin.Configurable en [dspace]/config/dspace.cfg #Configure each filter's input format(s)filter.org.dspace.app.mediafilter.PDFFilter.inputFormats = Adobe PDFfilter.org.dspace.app.mediafilter.HTMLFilter.inputFormats = HTML, Textfilter.org.dspace.app.mediafilter.WordFilter.inputFormats = Microsoft Wordfilter.org.dspace.app.mediafilter.JPEGFilter.inputFormats = BMP, GIF, JPEG, imagen/pngfilter.org.dspace.app.mediafilter.BrandedPreviewJPEGFilter.inputFormats = BMP, GIF, JPEG, imagen/png


Introduccin Funcionalidades Personalizacin Scripts Conclusin Versiones FuturasDSpace 1.5 (alpha)Reestructuracin del cdigo (separacin en mdulos y uso de Maven)dspacedspace-apilanguage-pack: dspace-jspuidspace-oaidspace-xmlui (Manakin)dspace-lni (webservice basado en WebDav)i18n multilingualism supportConfigurable item submissionConfigurable Browse...DSpace 1.6 (en proceso)VersioningDAO Persistent Identifiers- ...


Introduccin Funcionalidades Personalizacin Scripts Conclusin DocumentacinDSpace Basic Tutorial DSUG Rome 2007 ( Andrea Bollini, Federico Meschini)DSpace 1.4.1 - Customization ( Claudia Jrgen)Dspace How-to Guide (Tim Donohue, Scott Phillips, Dorothea Salo). Traducido al castellano (Luis Tijera ,Universidad de Len)Learning to use Manakin -DSUG Rome 2007 (Scott Phillips)


Introduccin Funcionalidades Personalizacin Scripts Conclusin Recursos generalesDSpace.org http://www.dspace.orgDSpace wiki http://wiki.dspace.orgDocumentacin DSpace. (en [dspace-source]/doc) Sourceforge.net http://sourceforge.net/projects/dspaceListas de distribucin: http://www.dspace.org/feedback/mailing.htmldspace-generaldspace-techdspace-develEn castellanoWiki Gude http://sod.upc.edu/gudeLista Gude http://www.rediris.es/list/info/gude.es.html


Ecologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesSe puede indicar el lenguaje del metadatosPersonalizar el conjunto de metadatos para una coleccinPersonalizar el formato de entrada para cada metadatoPersonalizar que metadatos mostramos en la pantalla de visualizacinSe puede modificar despues a traves de la interfaz de usuario

Ecologa de los repositorios institucionalesEsquema, elemento y qualificador estan almacenados en el metadata registry de dspaceEcologa de los repositorios institucionalesEstas restricciones no estn disponibles a nivel de servidor OAIAdministrador de coleccin puede:...Ecologa de los repositorios institucionalesCAS/Shiboleth mediante un parcheEcologa de los repositorios institucionalesEcologa de los repositorios institucionales(Consejo: utiliza grupos para pasos del workflow comunes)Ecologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionalesEcologa de los repositorios institucionales

Gijon Tutorial Dspace

Documents

Transcript of Gijon Tutorial Dspace