DSpace

Documentazione DSpace | Release di DSpace | Wiki di DSpace | Supporto

Panoramica

Il software open source DSpace è un'applicazione repository pronta all'uso utilizzata da più di 2.000 organizzazioni e istituzioni in tutto il mondo per garantire un accesso duraturo alle risorse digitali. Per maggiori informazioni, visita http://www.dspace.org/

DSpace è composto sia da un backend basato su Java sia da un frontend basato su Angular.

• Il backend (questo codebase) fornisce un'API REST, insieme ad altre interfacce machine-based (ad es. OAI-PMH, SWORD, ecc.)
  • Il contratto REST è disponibile su https://github.com/DSpace/RestContract
• Il frontend (https://github.com/DSpace/dspace-angular/) è l'interfaccia utente costruita sull'API REST

Le versioni precedenti di DSpace (v6.x e precedenti) utilizzavano due diverse UI (XMLUI e JSPUI). Queste UI non sono più supportate in v7 e successive.

• È ancora disponibile un ramo di manutenzione per le versioni precedenti; vedi dspace-6_x per la manutenzione della 6.x.

Download

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

Documentazione / Installazione

La documentazione per ogni release può essere consultata online o scaricata tramite il nostro Wiki di documentazione.

Le istruzioni più recenti per l'installazione di DSpace sono disponibili all'indirizzo: https://wiki.lyrasis.org/display/DSDOC9x/Installing+DSpace

Si noti che, in quanto applicazione web Java, DSpace richiede un database (PostgreSQL) e un contenitore di servlet (di solito Tomcat) per funzionare. Ulteriori informazioni su questi e su tutti gli altri prerequisiti sono disponibili nelle istruzioni di installazione sopra indicate.

Eseguire DSpace 9 in Docker

NOTA: al momento non disponiamo di immagini Docker pronte per la produzione per DSpace. Detto questo, abbiamo script Docker Compose di avvio rapido per scopi di sviluppo o test.

Vedi Eseguire DSpace 9 con Docker Compose

Contributi

Vedi la documentazione sui contributi

Ottenere assistenza

DSpace fornisce mailing list pubbliche dove puoi postare domande o sollevare argomenti di discussione. Invitiamo tutti a partecipare a queste liste:

• [email protected] : Discussione generale sulla piattaforma DSpace, annunci, condivisione di buone pratiche
• [email protected] : Mailing list per il supporto tecnico. Vedi anche la nostra guida su come risolvere un errore.
• [email protected] : Mailing list per sviluppatori / sviluppo

Ottime domande e risposte sono disponibili anche sotto il tag DSpace su Stackoverflow

Ulteriori opzioni di supporto sono disponibili all'indirizzo https://wiki.lyrasis.org/display/DSPACE/Support

DSpace dispone anche di una rete attiva di fornitori di servizi. Se preferisci assumere un fornitore di servizi per installare, aggiornare, personalizzare o ospitare DSpace, ti consigliamo di contattare uno dei nostri Fornitori di servizi registrati.

Tracker dei problemi

DSpace utilizza GitHub per tracciare i problemi:

• Problemi del backend (API REST): https://github.com/DSpace/DSpace/issues
• Problemi del frontend (interfaccia utente): https://github.com/DSpace/dspace-angular/issues

Testing

Eseguire i test

Per impostazione predefinita, in DSpace, i test unitari e i test di integrazione sono disabilitati. Tuttavia, vengono eseguiti automaticamente da GitHub Actions per tutte le pull request e i commit di codice.

• Come eseguire sia i test unitari (tramite maven-surefire-plugin) sia i test di integrazione (tramite maven-failsafe-plugin):
  root@kitploit:~

  mvn install -DskipUnitTests=false -DskipIntegrationTests=false
  

• Come eseguire solo i test unitari:
  root@kitploit:~

  mvn test -DskipUnitTests=false
  

• Come eseguire un singolo test unitario
  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
  

• Come eseguire solo i test di integrazione
  root@kitploit:~

  mvn install -DskipIntegrationTests=false
  

• Come eseguire un singolo test di integrazione
  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
  

Licenza

Il codice sorgente di DSpace è liberamente disponibile sotto una licenza BSD 3-Clause standard. La licenza completa è disponibile nel file LICENSE o online su http://www.dspace.org/license/

DSpace utilizza librerie di terze parti che possono essere distribuite con licenze diverse. Queste licenze sono elencate nel file LICENSES_THIRD_PARTY.