Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
/config/database.yml
/config/secrets.yml
/Gemfile.lock
249 changes: 115 additions & 134 deletions CHANGELOG.md

Large diffs are not rendered by default.

9 changes: 7 additions & 2 deletions COPYRIGHT
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
Copyright (C) 2011-2015 Direzione Generale per gli Archivi, Regione Lombardia,
Università degli Studi di Pavia, Politecnico di Milano
Copyright (C) 2011-2019
Direzione Generale per gli Archivi
ICAR – Istituto Centrale per gli Archivi
Regione Lombardia, Direzione Generale Autonomia e Cultura
Università degli Studi di Pavia
Politecnico di Milano
Regione Piemonte

Archimista is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
Expand Down
61 changes: 61 additions & 0 deletions CREDITS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
## Crediti
2018 - in corso
* [Direzione Generale per gli Archivi](http://www.regione.lombardia.it)
* [ICAR – Istituto Centrale per gli Archivi](http://www.icar.beniculturali.it/)
* [Regione Lombardia, Direzione Generale Istruzione, Formazione e Cultura](http://www.regione.lombardia.it/wps/portal/istituzionale/HP/istituzione/direzioni-generali/direzione-generale-autonomia-e-cultura)
* [Università degli Studi di Pavia](http://www.unipv.eu/site/home.html)
* [Politecnico di Milano](https://www.polimi.it/)
* [Regione Piemonte](https://www.regione.piemonte.it/)


**2015 - 2018**
**Promozione e finanziamento**
* [Politecnico di Milano](http://www.polimi.it/)
* [Regione Lombardia, Direzione Generale Culture, Identità e Autonomie](http://www.cultura.regione.lombardia.it/)

Contribuiscono allo sviluppo [Fondazione Famiglia Legler](http://www.ffl.it/) e [Fondazione ISEC](http://www.fondazioneisec.it/)

**Comitato di pilotaggio**
* [Politecnico di Milano](http://www.polimi.it/)
* [Regione Lombardia, Direzione Generale Culture, Identità e Autonomie](http://www.cultura.regione.lombardia.it/)
* [Soprintendenza archivistica della Lombardia](http://www.sa-lom.archivi.beniculturali.it/)

**Archimista versioni 2.0.0 e 2.1.0**
* Sviluppo 2.0.0: [TAI S.a.s.](http://www.taisas.com/), Milano
* Attività: aggiornamento framework (Ruby 2.1.5 e Rails 4.2.1), personalizzazione report, miglioramento relazione fra Fonti ed entità principali. Per dettagli consultare [Note di rilascio](http://www.archimista.it/?page_id=30)
* Rilasci: versione 2.0.0, 2.1.0

**ArchiVista versione 2.0.0**
* Sviluppo 2.0.0: [TAI S.a.s.](http://www.taisas.com/), Milano
* Attività: gestione multisito, visione campi speciali schede unità documentarie. Per dettagli consultare [Note di rilascio](http://www.archimista.it/?page_id=30)
* Rilasci: versione 2.0.0

**Licenza**
Questo programma è software libero; è lecito redistribuirlo o modificarlo secondo i termini della GNU General Public License come è pubblicata dalla Free Software Foundation; o la versione 2 della licenza o una versione successiva.

Di seguito si elencano le responsabilità di progetto per gli anni precedenti

**2012 - 2014**
**Promozione e finanziamento**
* [Politecnico di Milano](http://www.polimi.it/)
* [Regione Lombardia, Direzione Generale Culture, Identità e Autonomie](http://www.cultura.regione.lombardia.it/)

**Comitato di pilotaggio**
* [Politecnico di Milano](http://www.polimi.it/)
* [Regione Lombardia, Direzione Generale Culture, Identità e Autonomie](http://www.cultura.regione.lombardia.it/)
* [Soprintendenza archivistica della Lombardia](http://www.sa-lom.archivi.beniculturali.it/)

*Attività*: Miglioramento report, miglioramento riordini, gestione unità e sottounità, gestione oggetti digitali, modulo interrogazione web
*Rilasci*: versione 1.2.0, 1.2.1, Archimista Web 1.0.0

**2010 - 2012**
**Promozione e finanziamento**
* [Direzione Generale per gli Archivi](http://www.archivi.beniculturali.it/)
* [Regione Lombardia, Direzione Generale Culture, Identità e Autonomie](http://www.cultura.regione.lombardia.it/)
* [Regione Piemonte](http://www.regione.piemonte.it/)

**Coordinamento scientifico**
* [Università degli Studi di Pavia](http://www.unipv.eu/site/home.html)

*Attività*: sviluppo core di Archimista con data entry, viste e ordinamento dati
*Rilasci*: versione 1.0.0, 1.1.0
65 changes: 65 additions & 0 deletions FAQ.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
## Archimista FAQ 3.1.1

**È possibile estrarre un complesso o un’unità includendo tutta la gerarchia (ascendenza e discendenza)?**
Sì. Il tracciato relativo ad un complesso ora contiene: tutta l’ascendenza (se presente) a partire dal complesso radice secondo una struttura breve contenente solo *unitid* e *unittitle*; il complesso oggetto di esportazione; tutta la discendenza (se presente); le unità archivistiche associate al complesso oggetto di esportazione ed ai complessi figli. Il tracciato relativo ad una unità ora contiene: tutta l’ascendenza sia in termini di complessi che di unità a partire dal complesso radice secondo una struttura breve contenente solo *unitid* e *unittitle*; l’unità oggetto di esportazione; tutta la discendenza (se presente).

**Come avviene l’esportazione di dati secondo il nuovo tracciato ICAR-IMPORT?**
L’esportazione avviene in un unico file, di un complesso archivistico e di tutte le entità ad esso associate.
Il tracciato ICAR-IMPORT è costruito a partire da un complesso archivistico (radice o non) ed include le seguenti entità:
* complesso archivistico secondo il tracciato EAD3 (con tutta la gerarchia ascendente e discendente);
* i complessi figli sono inseriti con tutte le informazioni che il tracciato prevede;
* ogni unità comprende gli oggetti digitali collegati (file inclusi nell’archivio zip insieme al file ICAR-IMPORT);
* i soggetti conservatori collegati al complesso radice secondo il tracciato SCONS2;
* i soggetti produttori collegati al complesso oggetto di esportazione o ad uno dei suoi complessi figli secondo il tracciato EAC-CPF;
* i profili istituzionali collegati ai soggetti produttori secondo il tracciato EAC-CPF;
* le schede anagrafiche collegate alle unità incluse secondo il tracciato EAC-CPF;
* le fonti archivistiche collegate al complesso oggetto di esportazione o ai complessi figli secondo il tracciato EAD3.

**Tentando di estrarre mediante unzip un archivio generato dall'export in formato ICAR-IMPORT si ottiene un errore del tipo "error: invalid zip file with overlapped components (possible zip bomb)"; come risolvere?**
Per archivi di dimensioni superiori a 4GB potrebbe verificarsi un errore in fase di estrazione mediante unzip. Per ovviare al problema è possibile utilizzare in alernativa il software "7zip" o il comando "jar xf <nome_file.zip>".

**È possibile creare una scheda sottofascicolo?**
Sì. È possibile crearla, dalla schermata in cui compare la lista delle unità relative ad un determinato complesso archivistico, è sufficiente cliccare sul bottone “crea sottofascicolo”. E’ anche possibile reiterare l’operazione su più livelli.

**Gli aef prodotti con le precedenti versioni si importano senza problemi?**
Sì. Gli aef delle versioni sono sempre importati: si è scelto di gestire sempre la compatibilità con le versioni precedenti.
Anche i dati delle schede speciali prodotti con le versioni precedenti (sino alla versione 2.0.0) sono riconvertiti automaticamente e riportati nei nuovi campi delle schede unità di tipo unità documentaria al variare del tracciato di riferimento (in particolare D, F, S).
Tutti i dati delle vecchie schede speciali che non hanno corrispondenza nelle nuove (OA, BDM) sono salvati nel campo “descrizione estrinseca” (unità documentaria).

**Per installare la nuova versione si sovrascrive la vecchia versione o è meglio disinstallare e reinstallare?**
Quando si procede a una nuova installazione della versione standalone, il database eventualmente già presente viene automaticamente aggiornato alla nuova versione (dati ed eventuali oggetti digitali).
Questo avviene anche se si procede alla disinstallazione della versione precedente (operazione consigliata), perché il database non viene mai rimosso.

**Perché in Unità non visualizzo più il pulsante “Vai a scheda speciale” presente sino alla versione 2.0.0?**
La nuova versione 2.1.0 ha modificato il concetto di scheda speciale: in modalità scheda unità documentaria (da Unità), l’utente può richiedere l’attivazione di campi speciali, per la descrizione di schede unità documentaria di tipo:
* CARS Cartografia storica
* D Disegno
* DT Disegno tecnico
* F Fotografia
* S Stampa

Per altri dettagli consulta la pagina [Note di rilascio](http://www.archimista.it/?page_id=30)

**Le novità già introdotte dalla versione 2.0.0 riguardano:**
* Report
* possibilità di personalizzare il report scegliendo quali campi mostrare per le entità Progetto, Produttore, Conservatore, Complesso archivistico e Unità
* scelta per la visualizzazione o non visualizzazione del nome del campo per ogni entità principale
*Esempio di report con etichetta del campo*
`Titolo`
`“Titolo della mia unità”`
`Estremi cronologici 1977-2015`
*Esempio di report senza etichetta del campo*
`“Titolo della mia unità”`
`1977-2015`
* possibilità di inserimento dei campi delle schede speciali Unità
* Fonti
* possibilità di creare relazioni fra Fonti e le entità principali direttamente dalla scheda Fonte

Per dettagli consulta la pagina [Note di rilascio](http://www.archimista.it/?page_id=30)

**Le novità introdotte dalla versione 1.2.1 riguardano**
* esportazioni e importazioni, possibili sia per Complesso, sia per Progetto oppure Conservatore
* produzione di report per Complesso archivistico, Progetto o Soggetto conservatore
* upload multiplo di oggetti digitali
* creazione sotto-unità e sotto-sotto-unità e possibilità di modificarne il livello

4 changes: 2 additions & 2 deletions Gemfile
Original file line number Diff line number Diff line change
Expand Up @@ -46,8 +46,8 @@ gem 'devise', '>=3.5.1'
gem 'devise-encryptable', '0.2.0'
gem 'cancancan'

gem 'acts_as_list', '>=0.8.2'
gem 'ancestry', '>=2.2.1'
gem 'acts_as_list', '>=0.7.2'
gem 'ancestry', '>=2.1.0'
gem 'will_paginate', '>=3.0.7'
gem 'RedCloth', '>=4.2.9'
gem 'paperclip', '>=4.2.1'
Expand Down
53 changes: 32 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
## Archimista
Archimista è un'applicazione web open source per la descrizione di archivi storici. È disponibile in due versioni: standalone e server.
Versione corrente: **3.0.0**
La versione corrente è la **3.1.1**.

## Requisiti
Archimista funziona sui sistemi operativi GNU/Linux, Mac OS X, Windows Vista e superiori. Per Windows XP è necessario utilizzare una versione apposita

Archimista funziona sui sistemi operativi GNU/Linux, Mac OS X, Windows Vista e superiori. Per Windows XP è necessario utilizzare una versione apposita che viene compilata allo scopo.
I requisiti generali dell’applicazione sono i seguenti:
* Ruby 2.1.5
* Rails 4.2.1
* Varie gemme Ruby dichiarate nel file Gemfile
Expand All @@ -14,42 +14,53 @@ Archimista funziona sui sistemi operativi GNU/Linux, Mac OS X, Windows Vista e s
* Webserver configurato per applicazioni Rails

## Installazione
Per Windows, versione standalone, è disponibile un pacchetto di installazione, scaricabile dal sito ufficiale: [http://www.archimista.it](http://www.archimista.it).

Sono disponibili le versioni standalone con un proprio pacchetto di installazione per le versioni windows XP e per le versioni superiori. I pacchetti di installazione sono disponibili su github nella directory releases.
Per la versione server, nel caso di prima installazione:

1. Predisporre il proprio computer con il software indicato nei Requisiti
2. Creare un file di configurazione per il database: config/database.yml. Per maggiori informazioni leggi: [http://guides.rubyonrails.org/v2.3.11/getting_started.html#configuring-a-database](http://guides.rubyonrails.org/v2.3.11/getting_started.html#configuring-a-database)
3. Eseguire il task rake gems:install
4. Eseguire il task RAILS_ENV=production rake db:setup
5. Avviare il webserver
5. Nel file config/initializers/metadata.rb modificare la variabile BASE_URL inserendo il proprio url di archivista, modificare il file tmp/Configurazione_dl.rb con i dati da usare negli export SAN
6. Avviare il webserver

L'utente per il primo login è:

* user: admin_archimista
* pass: admin_archimista

Nel caso di aggiornamento da versioni precedenti dell'applicazione:

1. Eseguire il task RAILS_ENV=production rake db:migrate
2. Eseguire il task RAILS_ENV=production rake assets:clean

## Macchina virtuale
È possibile utilizzare una macchina virtuale già pronta per l'utilizzo di archimista e archivista scaricandola dal seguente url:
[http://archimista.icar.beniculturali.it/downloads/2021-02-06-archimista.ova](http://archimista.icar.beniculturali.it/downloads/2021-02-06-archimista.ova) (*se si dovessero verificare problemi nell'apertura del link, è consigliato copiare e incollare l'url in un nuovo tab del browser manualmente*)

Di seguito il link alla guida all'uso della macchina virtuale:
[http://archimista.icar.beniculturali.it/downloads/VM-Archimista-manuale.pdf](http://archimista.icar.beniculturali.it/downloads/VM-Archimista-manuale.pdf)

*NB: VirtualBox non è al momento compatibile con chip M1*

## Supporto a Windows XP
In considerazione dell'obsolescenza del sistema operativo Windows XP, non più supportato da Microsoft dal 2014, non è stato possibile verificare appieno le funzionalità della versione archimista 3.1.1 per XP, e quindi non se ne raccomanda l'installazione. A partire dalle versioni di archimista successive alla 3.1.1, Windows XP non sarà più supportato.

## FAQ
Consulta le FAQ per risolvere problemi comuni come ad esempio la gestione di export di dimensioni maggiori di 4GB o scoprire come utilizzare al meglio archimista.
[https://github.com/ProgettoArchimista/archimista/blob/master/FAQ.md](https://github.com/ProgettoArchimista/archimista/blob/master/FAQ.md)

## Crediti
Archimista è un progetto promosso da:

* Direzione Generale per gli Archivi
* Regione Lombardia, Direzione Generale Istruzione, Formazione e Cultura
* Università degli Studi di Pavia
* Politecnico di Milano
* [Direzione Generale per gli Archivi](http://www.regione.lombardia.it)
* [ICAR – Istituto Centrale per gli Archivi](http://www.icar.beniculturali.it/)
* [Regione Lombardia, Direzione Generale Istruzione, Formazione e Cultura](http://www.regione.lombardia.it/wps/portal/istituzionale/HP/istituzione/direzioni-generali/direzione-generale-autonomia-e-cultura)
* [Università degli Studi di Pavia](http://www.unipv.eu/site/home.html)
* [Politecnico di Milano](https://www.polimi.it/)
* [Regione Piemonte](https://www.regione.piemonte.it/)

## Autori
Codex Società Cooperativa, Pavia
* [http://www.codexcoop.it](http://www.codexcoop.it)
TAI S.a.s.
* [http://www.taisas.com](http://www.taisas.com)

Lo sviluppo attuale è curato da INGLOBA360 s.r.l.
* [http://www.ingloba360.it](http://www.ingloba360.it)
Codex Società Cooperativa, Pavia ([http://www.codexcoop.it](http://www.codexcoop.it))
TAI S.a.s. ([http://www.taisas.com](http://www.taisas.com))
Lo sviluppo attuale è curato da INGLOBA360 s.r.l. ([http://www.ingloba360.it](http://www.ingloba360.it))

## Licenza
Archimista è rilasciato sotto licenza GNU General Public License v2.0 o successive.

Loading