progettoarchimista/archimista

Archimista 3.0.0

Archimista

Archimista è un'applicazione web open source per la descrizione di archivi storici. È disponibile in due versioni: standalone e server. 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 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
• Gemma rubyzip
• ImageMagick (opzionale, per la gestione di oggetti digitali)
• Database: MySQL (>= 5.1) o PostgreSQL (>= 9.1) o SQLite
• Webserver configurato per applicazioni Rails

Installazione

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
3. Eseguire il task rake gems:install
4. Eseguire il task RAILS_ENV=production rake db:setup
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 (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

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

Crediti

Archimista è un progetto promosso da:

• Direzione Generale per gli Archivi
• ICAR – Istituto Centrale per gli Archivi
• Regione Lombardia, Direzione Generale Istruzione, Formazione e Cultura
• Università degli Studi di Pavia
• Politecnico di Milano
• Regione Piemonte

Autori

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

Licenza

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

archimista's Issues

migrare dati da desco a archimista

Salve,

c'è qualche documentazione su come migrare da Desco a Archimista?

Impossibile installare

Come importare elenchi e inventari sommari

Salve,
ecco il problema:

• un archivio è dotato di numerosi strumenti di corredo, come elenchi o inventari sommari;
• gli strumenti di corredo di cui sopra sono stati digitalizzati o redatti direttamente al pc con programmi di videoscrittura;
• è necessario migrare gli inventari in un formato digitale che ne permetta l'aggiornamento e la conservazione.

Ed ecco una soluzione per "migrare" gli inventari in Archimista:

• confrontare il tracciato dell'inventario esistente con quello di Archimista;
• creare le schede di livello alto (fondo, serie, etc.);
• rielaborare il tracciato esistente in modo da avere un file csv che contenga i dati delle unità archivistiche descritte nell'inventario predisposti in tabelle compatibili con il tracciato dati Archimista (tabella "unit" e collegate);
• importare il file csv così creato all'interno dell'inventario digitale creato su Archimista, nel livello corrispondente a quello desiderato (la funzione 'importa csv' è accessibile nella scheda "Unità archivistiche";
• verificare la correttezza dei dati importati.

FINE

NB: Prima di intraprendere l'operazione, è importante valutare bene se lo sforzo sia commisurato all'obiettivo.

Io ho usato questo criterio per importare, ad esempio, l'inventario sommario degli Atti dei notai dell'AS di Belluno, di cui rimaneva una copia cartacea e un vecchio file in Microsoft Access. Le informazioni contenute nell'inventario per descrivere le singole unità archivistiche non sono molto approfondite (numero dell'unità, nome del notaio, tipo di unità documentaria, estremi cronologici, presenza di indici o rubriche), ma il fondo comprende oltre 9.000 unità.

Quella descritta sopra è stata la soluzione più rapida ed efficace, valutando il tempo e le risorse disponibili. Ed è stato anche un modo per verificare la fattibilità di operazioni di questo tipo. In altri casi, ho ritenuto invece di sfruttare altre funzioni di Archimista, come la creazione massiva di unità archivistiche a partire dalla scheda "Unità archivistiche" (vista tabellare).

Allego a questo post una versione (poco) aggiornata della relazione che ho preparato per descrivere il lavoro. Si tratta di "Linee guida" aperte al contributo della Community.

Buon lavoro colleghi archivisti-smanettoni!

Lina Marzotti

20190812-Marzotti-Archimista-Tracciato_unita_archivistica-Agg_20210316.docx

Javascript mancanti

Il manifest file application.js richiede alcuni file che non sono presenti nel repository.
Senza questi file l'applicazione non può partire.

I file andrebbero collocati in lib/assets/javascripts:

jquery-1.7.1.min.js
bootstrap.min.js
jquery-ui-1.8.18.min.js
jquery.ui.datepicker-it.js
jquery.cookie.js
jquery.blockUI.js
markitup/jquery.markitup.js
markitup/settings.js
jquery.fancybox-1.3.4.pack.js

Manuale utente e Wiki

Salve!
Mi sono domandata solo qualche giorno fa se esistesse un Wiki su Archimista, perché forse Wikipedia è la sede più adatta per cominciare a sviluppare un manuale utente del software.

Una cosa del genere sarebbe estremamente efficace dal punto di vista della diffusione e dell'accessibilità (GitHub non è per tutti). E sarebbe senz'altro utile dal punto di vista professionale a chi lavora con Archimista. Infatti, i committenti che non dispongono di una professionalità specifica, avrebbero gli strumenti informativi utili a continuare a tener vivo il loro strumento di corredo digitale personalizzato (elenco o inventario che sia) e questo renderebbe estremamente più desiderabile l'intervento di un'archivista professionista per realizzare inventari o altri strumenti di corredo digitali.

Questo è il mio punto di vista (avvalorato dalla mia esperienza professionale diretta). Posso definirmi un utente esperto e sono disponibile a redigere il wiki (non nell'immediato, ma un pezzettino alla volta...).

Chi è con me?

Lina Marzotti

https://it.wikipedia.org/wiki/Discussione:Archimista#Aggiornamento_lemma_e_collegamento_a_GitHub

Problemi di installazione su PostgreSQL

Salve,

sto tentando di installare Archimista 3 su postgresql 9.4.5, attualmente ricevo questi errori:

-- create_table("activities", {:force=>:cascade})
   -> 0.0283s
-- add_index("activities", ["db_source", "legacy_id"], {:name=>"index_activities_on_source_and_legacy_id", :using=>:btree})
   -> 0.0059s
-- create_table("creator_activities", {:force=>:cascade})
   -> 0.0085s
-- add_index("creator_activities", ["creator_id"], {:name=>"index_creator_activities_on_creator_id", :using=>:btree})
   -> 0.0058s
-- add_index("creator_activities", ["db_source", "legacy_id"], {:name=>"index_creator_activities_on_source_and_legacy_id", :using=>:btree})
   -> 0.0054s
-- create_table("creator_association_types", {:force=>:cascade})
   -> 0.0057s
-- create_table("creator_corporate_types", {:force=>:cascade})
   -> 0.0055s
-- create_table("creator_editors", {:force=>:cascade})
   -> 0.0090s
-- add_index("creator_editors", ["creator_id"], {:name=>"index_creator_editors_on_creator_id", :using=>:btree})
   -> 0.0056s
-- add_index("creator_editors", ["db_source", "legacy_id"], {:name=>"index_creator_editors_on_source_and_legacy_id", :using=>:btree})
   -> 0.0056s
-- create_table("creator_events", {:force=>:cascade})
rake aborted!
ActiveRecord::StatementInvalid: PG::SyntaxError: ERROR:  syntax error at or near "("
LINE 1: SELECT 'boolean(1)'::regtype::oid
               ^
CONTEXT:  invalid type name "boolean(1)"
: SELECT 'boolean(1)'::regtype::oid
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/database_statements.rb:155:in `async_exec'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/database_statements.rb:155:in `block in execute'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract_adapter.rb:473:in `block in log'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/notifications/instrumenter.rb:20:in `instrument'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract_adapter.rb:467:in `log'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/database_statements.rb:154:in `execute'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql_adapter.rb:393:in `lookup_cast_type'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:120:in `type_for_column'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/schema_statements.rb:33:in `type_for_column'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:97:in `quote_value'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:84:in `add_column_options!'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/schema_statements.rb:25:in `add_column_options!'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:33:in `visit_ColumnDefinition'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/schema_statements.rb:8:in `visit_ColumnDefinition'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:14:in `accept'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:40:in `block in visit_TableDefinition'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:40:in `map'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:40:in `visit_TableDefinition'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:14:in `accept'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_statements.rb:208:in `create_table'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/migration.rb:662:in `block in method_missing'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/migration.rb:632:in `block in say_with_time'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/migration.rb:632:in `say_with_time'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/migration.rb:652:in `method_missing'
/archimista/db/schema.rb:73:in `block in <top (required)>'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/schema.rb:41:in `instance_eval'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/schema.rb:41:in `define'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/schema.rb:61:in `define'
/archimista/db/schema.rb:14:in `<top (required)>'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/dependencies.rb:268:in `load'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/dependencies.rb:268:in `block in load'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/dependencies.rb:240:in `load_dependency'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/dependencies.rb:268:in `load'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:218:in `load_schema_for'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:235:in `block in load_schema_current'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:275:in `block in each_current_configuration'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:274:in `each'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:274:in `each_current_configuration'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:234:in `load_schema_current'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/railties/databases.rake:244:in `block (3 levels) in <top (required)>'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/railties/databases.rake:248:in `block (3 levels) in <top (required)>'
/usr/local/bundle/gems/rake-12.3.0/exe/rake:27:in `<top (required)>'

Caused by:
PG::SyntaxError: ERROR:  syntax error at or near "("
LINE 1: SELECT 'boolean(1)'::regtype::oid
               ^
CONTEXT:  invalid type name "boolean(1)"
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/database_statements.rb:155:in `async_exec'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/database_statements.rb:155:in `block in execute'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract_adapter.rb:473:in `block in log'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/notifications/instrumenter.rb:20:in `instrument'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract_adapter.rb:467:in `log'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/database_statements.rb:154:in `execute'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql_adapter.rb:393:in `lookup_cast_type'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:120:in `type_for_column'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/schema_statements.rb:33:in `type_for_column'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:97:in `quote_value'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:84:in `add_column_options!'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/schema_statements.rb:25:in `add_column_options!'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:33:in `visit_ColumnDefinition'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/postgresql/schema_statements.rb:8:in `visit_ColumnDefinition'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:14:in `accept'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:40:in `block in visit_TableDefinition'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:40:in `map'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:40:in `visit_TableDefinition'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_creation.rb:14:in `accept'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/connection_adapters/abstract/schema_statements.rb:208:in `create_table'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/migration.rb:662:in `block in method_missing'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/migration.rb:632:in `block in say_with_time'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/migration.rb:632:in `say_with_time'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/migration.rb:652:in `method_missing'
/archimista/db/schema.rb:73:in `block in <top (required)>'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/schema.rb:41:in `instance_eval'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/schema.rb:41:in `define'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/schema.rb:61:in `define'
/archimista/db/schema.rb:14:in `<top (required)>'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/dependencies.rb:268:in `load'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/dependencies.rb:268:in `block in load'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/dependencies.rb:240:in `load_dependency'
/usr/local/bundle/gems/activesupport-4.2.1/lib/active_support/dependencies.rb:268:in `load'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:218:in `load_schema_for'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:235:in `block in load_schema_current'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:275:in `block in each_current_configuration'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:274:in `each'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:274:in `each_current_configuration'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/tasks/database_tasks.rb:234:in `load_schema_current'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/railties/databases.rake:244:in `block (3 levels) in <top (required)>'
/usr/local/bundle/gems/activerecord-4.2.1/lib/active_record/railties/databases.rake:248:in `block (3 levels) in <top (required)>'
/usr/local/bundle/gems/rake-12.3.0/exe/rake:27:in `<top (required)>'
Tasks: TOP => db:schema:load
(See full trace by running task with --trace)

A quanto mi risulta, per avere compatibilità con Postgres, la definizione di BOOLEAN non dovrebbe contenere (1)

/usr/local/archimista-master/app/models/export.rb

Buongiorno, credo di segnalare un errore ma le mie competenze informatiche sono limitate. Perdonate, quindi, l'ignoranza.
Mi sembra che il file /usr/local/archimista-master/app/models/export.rb non sia configurato correttamente; la linea:
eval File.read('/usr/local/webapp/archimista/tmp/Configurazione_dl.rb')
rimanda ad una directory statica di archimista, per cui, se qualcuno installa archimista in un'altra directory, la funzione di esportazione delle entita in formato METS-SAN / CAT-SAN restituisce un errore perché l'applicazione non riesce a leggere il file Configurazione_dl.rb
Modificando la linea con la directory in cui effettivamente si trova archimista, l'esportazione avviene in modo corretto.
Non è possibile far pescare al programma la directory di installazione automaticamente? Grazie

Ivan Faiferri

Requisiti hardware

Abbiamo in produzione una versione di archimista dockerizzata.
Abbiamo notato che ogni tanto a seguito della richiesta di generazione di un pdf, la soluzione non ha abbastanza risorse e va in crash.
Nei log l'ultima operazione registrata è:

Processing by ReportsController#inventory as PDF
Parameters: {"id"=>"21"}
Rendered reports/reportsettings.html.erb (18.2ms)
Rendered reports/inventory.html.erb (51405.4ms)
/usr/local/bin/wkhtmltopdf --page-size A4 --encoding utf-8 --print-media-type --enable-smart-shrinking - /usr/src/app/public/downloads/inventory-20231003194323.pdf
Completed 500 Internal Server Error in 266319ms (ActiveRecord: 7594.0ms)

Errno::ENOMEM (Cannot allocate memory - /usr/local/bin/wkhtmltopdf):
app/controllers/reportscontroller.rb:566:in pdf_init' app/controllers/reports_controller.rb:171:inblock (2 levels) in inventory' app/controllers/reportscontroller.rb:168:in `inventory'

esiste un riepilogo dei requisiti minimi hardware da rispettare?