DSpace

Documentación de DSpace | Lanzamientos de DSpace | Wiki de DSpace | Soporte

Resumen

El software de código abierto DSpace es una aplicación de repositorio llave en mano utilizada por más de 2,000 organizaciones e instituciones en todo el mundo para proporcionar acceso duradero a recursos digitales. Para más información, visita http://www.dspace.org/

DSpace consta de un backend basado en Java y un frontend basado en Angular.

• El backend (este código base) proporciona una API REST, junto con otras interfaces basadas en máquinas (p. ej., OAI-PMH, SWORD, etc.)
  • El Contrato REST está en https://github.com/DSpace/RestContract
• El frontend (https://github.com/DSpace/dspace-angular/) es la interfaz de usuario construida sobre la API REST

Las versiones anteriores de DSpace (v6.x e inferiores) usaban dos interfaces de usuario diferentes (XMLUI y JSPUI). Esas interfaces ya no son compatibles con v7 y superiores.

• Una rama de mantenimiento para versiones anteriores sigue disponible; consulta dspace-6_x para el mantenimiento de 6.x.

Descargas

• Backend (REST API): https://github.com/DSpace/DSpace/releases
• Frontend (Interfaz de usuario): https://github.com/DSpace/dspace-angular/releases

Documentación / Instalación

La documentación de cada versión puede consultarse en línea o descargarse a través de nuestra Wiki de documentación.

Las instrucciones más recientes de instalación de DSpace están disponibles en: https://wiki.lyrasis.org/display/DSDOC9x/Installing+DSpace

Ten en cuenta que, como aplicación web Java, DSpace requiere una base de datos (PostgreSQL) y un contenedor de servlets (normalmente Tomcat) para funcionar. Puedes encontrar más información sobre estos y todos los demás requisitos previos en las instrucciones de instalación anteriores.

Ejecutar DSpace 9 en Docker

NOTA: Por el momento, no disponemos de imágenes Docker listas para producción de DSpace. Dicho esto, sí tenemos scripts de inicio rápido de Docker Compose para fines de desarrollo o pruebas.

Consulta Ejecutar DSpace 9 con Docker Compose

Contribuciones

Consulta la documentación de contribución

Obtener ayuda

DSpace ofrece listas de correo públicas donde puedes publicar preguntas o plantear temas de discusión. Todos son bienvenidos a participar en estas listas:

• [email protected] : Discusión general sobre la plataforma DSpace, anuncios e intercambio de mejores prácticas
• [email protected] : Lista de correo de soporte técnico. Consulta también nuestra guía para solucionar un error.
• [email protected] : Lista de correo de desarrolladores / desarrollo

También hay excelentes preguntas y respuestas en la etiqueta DSpace en Stackoverflow

Opciones de soporte adicionales están en https://wiki.lyrasis.org/display/DSPACE/Support

DSpace también cuenta con una red activa de proveedores de servicios. Si prefieres contratar a un proveedor de servicios para instalar, actualizar, personalizar u hospedar DSpace, te recomendamos ponerte en contacto con uno de nuestros Proveedores de servicios registrados.

Seguimiento de incidencias

DSpace utiliza GitHub para realizar el seguimiento de incidencias:

• Incidencias del backend (REST API): https://github.com/DSpace/DSpace/issues
• Incidencias del frontend (interfaz de usuario): https://github.com/DSpace/dspace-angular/issues

Pruebas

Ejecutar pruebas

De forma predeterminada, en DSpace, las pruebas unitarias y las pruebas de integración están deshabilitadas. Sin embargo, se ejecutan automáticamente mediante GitHub Actions para todas las pull requests y confirmaciones de código.

• Cómo ejecutar tanto las pruebas unitarias (mediante maven-surefire-plugin) como las pruebas de integración (mediante maven-failsafe-plugin):
  root@kitploit:~

  mvn install -DskipUnitTests=false -DskipIntegrationTests=false
  

• Cómo ejecutar solo las pruebas unitarias:
  root@kitploit:~

  mvn test -DskipUnitTests=false
  

• Cómo ejecutar una única prueba unitaria
  root@kitploit:~

  # Run all tests in a specific test class
  # NOTE: failIfNoTests=false is required to skip tests in other modules
  mvn test -DskipUnitTests=false -Dtest=[full.package.testClassName] -DfailIfNoTests=false
  
  # Run one test method in a specific test class
  mvn test -DskipUnitTests=false -Dtest=[full.package.testClassName]#[testMethodName] -DfailIfNoTests=false
  

• Cómo ejecutar solo las pruebas de integración
  root@kitploit:~

  mvn install -DskipIntegrationTests=false
  

• Cómo ejecutar una única prueba de integración
  root@kitploit:~

  # Run all integration tests in a specific test class
  # NOTE: failIfNoTests=false is required to skip tests in other modules
  mvn install -DskipIntegrationTests=false -Dit.test=[full.package.testClassName] -DfailIfNoTests=false
  
  # Run one test method in a specific test class
  mvn install -DskipIntegrationTests=false -Dit.test=[full.package.testClassName]#[testMethodName] -DfailIfNoTests=false
  

Licencia

El código fuente de DSpace está disponible gratuitamente bajo una licencia BSD de 3 cláusulas estándar. La licencia completa está disponible en el archivo LICENSE o en línea en http://www.dspace.org/license/

DSpace utiliza bibliotecas de terceros que pueden distribuirse bajo licencias diferentes. Esas licencias se enumeran en el archivo LICENSES_THIRD_PARTY.