DSpace

Documentation DSpace | Versions DSpace | Wiki DSpace | Assistance

Présentation

Le logiciel open source DSpace est une application de dépôt clé en main utilisée par plus de 2 000 organisations et institutions dans le monde pour assurer un accès durable aux ressources numériques. Pour plus d'informations, visitez http://www.dspace.org/

DSpace se compose à la fois d'un backend basé sur Java et d'un frontend basé sur Angular.

• Le backend (ce codebase) fournit une API REST, ainsi que d'autres interfaces machine (par ex. OAI-PMH, SWORD, etc.)
  • Le contrat REST se trouve sur https://github.com/DSpace/RestContract
• Le frontend (https://github.com/DSpace/dspace-angular/) est l'interface utilisateur construite sur l'API REST

Les versions antérieures de DSpace (v6.x et inférieures) utilisaient deux IU différentes (XMLUI et JSPUI). Ces IU ne sont plus supportées dans v7 et ultérieures.

• Une branche de maintenance pour les versions plus anciennes est toujours disponible, voir dspace-6_x pour la maintenance 6.x.

Téléchargements

• Backend (API REST) : https://github.com/DSpace/DSpace/releases
• Frontend (Interface utilisateur) : https://github.com/DSpace/dspace-angular/releases

Documentation / Installation

La documentation de chaque version peut être consultée en ligne ou téléchargée via notre Wiki de documentation.

Les dernières instructions d'installation de DSpace sont disponibles sur : https://wiki.lyrasis.org/display/DSDOC9x/Installing+DSpace

Veuillez noter qu'en tant qu'application web Java, DSpace nécessite une base de données (PostgreSQL) et un conteneur de servlets (généralement Tomcat) pour fonctionner. De plus amples informations sur ces prérequis et tous les autres peuvent être trouvées dans les instructions d'installation ci-dessus.

Exécuter DSpace 9 dans Docker

NOTE : Pour l'instant, nous ne disposons pas d'images Docker prêtes pour la production pour DSpace. Cela dit, nous avons des scripts Docker Compose de démarrage rapide à des fins de développement ou de test.

Voir Exécuter DSpace 9 avec Docker Compose

Contribuer

Voir Documentation pour contribuer

Obtenir de l'aide

DSpace fournit des listes de diffusion publiques où vous pouvez poser des questions ou soulever des sujets de discussion. Nous invitons tout le monde à participer à ces listes :

• [email protected] : Discussion générale sur la plateforme DSpace, annonces, partage des bonnes pratiques
• [email protected] : Liste de diffusion d'assistance technique. Voir aussi notre guide pour Comment résoudre une erreur.
• [email protected] : Liste de diffusion des développeurs / développement

Une excellente section Q&A est également disponible sous le tag DSpace sur Stackoverflow

Des options d'assistance supplémentaires sont disponibles sur https://wiki.lyrasis.org/display/DSPACE/Support

DSpace dispose également d'un réseau actif de fournisseurs de services. Si vous préférez engager un fournisseur de services pour installer, mettre à niveau, personnaliser ou héberger DSpace, nous vous recommandons de contacter l'un de nos fournisseurs de services enregistrés.

Suivi des problèmes

DSpace utilise GitHub pour suivre les problèmes :

• Problèmes backend (API REST) : https://github.com/DSpace/DSpace/issues
• Problèmes frontend (Interface utilisateur) : https://github.com/DSpace/dspace-angular/issues

Tests

Exécution des tests

Par défaut, dans DSpace, les tests unitaires et les tests d'intégration sont désactivés. Cependant, ils sont exécutés automatiquement par GitHub Actions pour toutes les Pull Requests et les commits de code.

• Comment exécuter à la fois les tests unitaires (via maven-surefire-plugin) et les tests d'intégration (via maven-failsafe-plugin) :
  root@kitploit:~

  mvn install -DskipUnitTests=false -DskipIntegrationTests=false
  

• Comment exécuter uniquement les tests unitaires :
  root@kitploit:~

  mvn test -DskipUnitTests=false
  

• Comment exécuter un seul test unitaire
  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
  

• Comment exécuter uniquement les tests d'intégration
  root@kitploit:~

  mvn install -DskipIntegrationTests=false
  

• Comment exécuter un seul test d'intégration
  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
  

Licence

Le code source de DSpace est librement disponible sous une licence BSD 3-Clause standard. La licence complète est disponible dans le fichier LICENSE ou en ligne à l'adresse http://www.dspace.org/license/

DSpace utilise des bibliothèques tierces qui peuvent être distribuées sous différentes licences. Ces licences sont listées dans le fichier LICENSES_THIRD_PARTY.