Il file Excel input-forms.xls viene utilizzato per produrre file di configurazione XML per il software IRIS tramite strumenti automatici.
La descrizione del set di pagine mediante le quali i ricercatori inseriscono i metadati relativi al prodotto della ricerca è chiamata “form” (benché di fatto sia un insieme di form, nel significato HTML del termine). Un form è identificato da un unico nome simbolico (ad esempio, nel nostro caso, Articolo in rivista, Contributo in volume, e così via), ma nella struttura XML esso si divide in una serie di “pagine”, ciascuna della quali rappresenta una precisa pagina web per la raccolta dei metadati. A sua volta, l’elemento pagina contiene una sequenza di elementi “campo”, ciascuno dei quali definisce una finestra dialogo interattivo (un’area di testo, una data, una tendina di valori fissi, eccetera) con cui il ricercatore inserisce ogni metadato di tipo Dublin Core.
Per customizzare le pagine di inserimento dati, l’istituzione che installa IRIS deve esplicitare tutte le proprie scelte mediante un file avente struttura predeterminata, appunto il file input-forms.xls.
IRIS può contenere più di una versione di input-form e ogni versione può essere attiva o inattiva. Lo stato della singola input form è gestibile dalla funzionalità di Attivazione input form:
Configurazione > Prodotti > Attivazione input-form
https://surplusqa02.qa.cineca.it/ir/dspace-admin/input-form-activation
Le nuove submission utilizzano sempre la versione attiva più recente di una submission (NB: se una submission viene interrotta e ripresa successivamente potrebbe accadere che nel tempo intercorso sia stata caricata una nuova versione dell'input form).
Se la versione dell' input form con cui è stato creato il prodotto è ancora attiva, si continuerà a far riferimento a quella versione per la descrizione del prodotto, ma se invece quella versione è stata disattivata allora il sistema aggiornerà il prodotto alla nuova versione segnalando gli eventuali metadati non più utilizzabili e dando la possibilità di cambiare tipologia di prodotto prima della conversione (utile nei casi in cui una nuova versione di input form sia stata introdotta dopo aver "spezzato" una input form pre-esistente in più sotto-tipologie).
Le tre opzioni presenti al caricamento (dal menu a sinistra: Configurazione > Prodotti > Caricamento input form):
consentono quindi di gestire i possibili scenari complessivamente per tutte le input form che si caricano via Excel senza dover poi utilizzare singolarmente la funzionalità di attivazione/disattivazione.
L'opzione 3 di non attivare la input form è prevista principalmente per futuri sviluppi: si vuole infatti rendere possibile in una futura versione il test delle nuove input form agli amministratori prima della loro attivazione. Al momento potrebbe essere utilizzata per caricare nel sistema una nuova input form e condividerla con i colleghi tramite la piattaforma o valutare tramite le funzionalità di check (Prodotti > Tools di manutenzione > Check ...) l'impatto che avrebbe sul pregresso.
Al fine della corretta generazione dei file di configurazione, e per ridurre i tempi di messa in servizio di richieste di modifiche a queste configurazioni, devono essere seguite le seguenti indicazioni:
Il foglio Excel si compone di fogli distinti, i cui nomi NON devono essere alterati
NON deve essere utilizzata bordatura, l’unica evidenziazione eventualmente ammessa è con colori di sfondo ed esclusivamente su righe in uso (non inserire righe vuote)
NON devono essere valorizzate celle nei fogli ad eccezione di quelle esplicitamente citate in questa guida; eventuali commenti ed informazioni aggiuntive vanno inserite in nuovi fogli (in posizione successiva a quelli predefiniti) e segnalate esplicitamente ai tecnici CINECA
Il form-definition descrive i template di submission/validazione disponibili per il sistema. Ciascun template definisce i metadati per una specifica tipologia di documento (es. articolo su rivista, intervento a convegno, contributo in libro, monografia, ecc.).
Le uniche celle da utilizzare rientrano nelle colonne A:K
Tutte le informazioni devono essere inserite sequenzialmente nell’ordine corretto, NON devono essere presenti righe vuote. Ogni template va configurato interamente prima di passare alla definizione di un nuovo template. I metadati vanno inseriti nell’ordine in cui si desidera che siano presentati all’utente nei form di inserimento/validazione rispettando l’ordine di paginazione.
La colonna A contiene il nome del template. Deve essere mantenuto costante per tutta la definizione del template. Le richieste di utilizzo di un determinato template per una specifica collezione devono far riferimento a tale nome.
La colonna B contiene il numero di pagina in cui il metadato sarà richiesto. I numeri di pagina devono essere inseriti sequenzialmente senza salti a partire dal valore 1.
La colonna C contiene l’element dublin core del metadato. Si richiede l’utilizzo di metadati in accordo a quanto definito dallo standard: http://dublincore.org. Una guida in lingua italiana è disponibile all'indirizzo: http://www.aepic.it/dublincore.php. NON è possibile utilizzare i caratteri _ (underscore) e . (punto)
La colonna D contiene il qualifier dublin core del metadato, se necessario. Oltre a qualifier "standard" possono essere definiti qualifier "custom" (personalizzati). Si consiglia di mantenere il più possibile quelli proposti per non incorrere in costi di personalizzazione delle procedure che vi fanno riferimento (ad es. la generazione automatica di citazioni). NON è possibile utilizzare i caratteri _ (underscore) e . (punto)
La colonna E definisce la modalità di immissione per il metadato. I valori ammessi sono:
ance: per inserire la rivista o serie
onebox: un singolo box per l’immissione di testo libero
twobox: utilizzabile solo per metadati ripetibili, consente la definizione di due valori in una sola riga html
textarea: box multilinea per l’immissione di testo libero
name: box multipla per l’inserimento di nomi di persone che saranno poi memorizzate nel db nella forma “Cognome, Nome”
year: per inserire il solo anno
date: box multipla per la selezione di una data. Nel caso il metadato sia definito obbligatorio è sufficiente l’indicazione del solo anno
fulldate: granularità giornaliera inserimento via calendario javascript
dropdown: menù a discesa con valori predefiniti, per la cui definizione si veda la colonna F
list: checkbox o radio (in base alla definizione di ripetibilità) con una lista di opzioni predefinita per la cui definizione si veda colonna F
qualdrop_value: combinazione di un dropdown per la definizione del qualifier specifico del metadato e di una box a testo libero per l’immissione del valore. La Colonna CD deve essere lasciata vuota. Per la definizione della lista di qualifier utilizzabili si veda la colonna F
qualdrop_text: combinazione di un dropdown per la definizione del qualifier specifico del metadato e di una text area a testo libero per l’immissione del valore. La D deve essere lasciata vuota. Per la definizione della lista di qualifier utilizzabili si veda la colonna F
sharepriority: utilizzabile solo per metadati ripetibili, box multilinea per l’inserimento facilitato di persone multiple. Il tool permette di identificare i singoli nominativi suddividendoli in campi controlled_name e ricoscendone l’eventuale afferenza all’istituzione se presente il modulo SUR+ GA. È possibile configurare una percentuale di attribuzione di responsabilità per i singoli nomi e un eventuale ordine diverso da quello bibliografico per utilizzo interno all’istituzione. Il sistema esegue dei controlli per verificare che la percentuale abbia un totale di 100% e che l’ordinamento sia coerente con i valori inseriti nella box (ripetizioni, mancanze, ecc.).
default_value: (solo per gli archivi che abbiano richiesto specifici sviluppi) valore automatico non modificabile generato secondo logica specifica concordata con il cliente. Attualmente il default value valorizza il metadato dc.type.miur con il codice della tipologia Miur su cui è mappato la tipologia di pubblicazione in ugov (esempio: articolo in rivista deve prevedere un default value per dc.type.miur con valore 262). Questo differisce dalla precedente versione di Ugov che per questa operazione prevedeva una interfaccia specifica.
La colonna F deve essere valorizzata solo se come modalità di immissione (colonna E) si è scelta una delle seguenti: dropdown, list, qualdrop_value o qualdrop_text, nei quali casi occorre inserire il nome assegnato al set di valori ammessi nel foglio form-value-pairs.
La colonna G contiene la label mostrata all’utente nei form di submission/validazione dei metadati. Se il metadato è definito obbligatorio (si veda colonna I) il sistema inserirà automaticamente un * prima della label specificata. Se il metadato è definito in colonna E come default_value, il contenuto di questa colonna verrà utilizzato per la valorizzazione del metadato. Inserendo il testo fra due segnaposto @@ si potrà indicare la generazione tramite uno degli algoritmi disponibili (ad esempio, per il metadato dc.identifier.citation , nella colonna G si deve compilare ‘@@citation@@’).
Il valore di questo campo non viene utilizzato come label nella scheda breve di presentazione dell’item. Per la definizione di tale label occorre agire sulle configurazioni e utilizzare la funzionalità di gestione dell’i18n.
La colonna H contiene un valore True/False ad indicare la ripetibilità o meno del metadato.
La colonna I contiene il messaggio di errore da mostrare in caso di mancata valorizzazione del metadato. La cella vuota implica la non obbligatorietà del campo.
La colonna J contiene una mini guida per la compilazione del metadato che sarà mostrata all’utente subito sopra la box di immissione del metadato stesso. Può contenere tag HTML.
La colonna K contiene l’ambito di utilizzo del metadato. I possibili valori sono:
cella vuota: campo utilizzabile in lettura/scrittura sia durante la submission che durante il workflow di verifica;
submission hidden: il campo non è presente durante la fase di submission. Utilizzabile per semplificare il processo di self-archiving riservando la compilazione di alcuni metadati agli operatori durante la fase di verifica;
submission readonly: il campo è presente durante la fase di submission in sola lettura;
workflow hidden: il campo non è presente durante la fase di verifica dei metadati. Utilizzabile per esempio per rendere anonima la submission in fase di verifica;
workflow readonly: il campo è presente durante la fase di verifica dei metadati in sola lettura;
readonly: il campo è presente in sola lettura sia durante la submission che durante la verifica dei metadati. Utile in presenza di campi pre-valorizzati da procedure automatiche;
hidden: il campo non è utilizzato nelle form di submission. Utilizzabile per definire la visibilità del campo nella scheda breve dell’item;
Nel foglio Form-value-pairs vengono descritti i set di valori disponibili per i metadati con modalità di immissione dropdown, list, qualdrop_value o controlled_name (si veda Colonna E). Le colonne devono essere valorizzate da sinistra verso destra senza lasciare colonne vuote.
Ogni set di valori occupa due colonne adiacenti: nella prima cella della prima colonna (ad esempio A:1) viene definito il nome del set di dati (si veda Colonna F), nella prima cella della seconda colonna (ad esempio B:1) andrebbe riportato il qualifier del primo metadato che utilizza tale set.
A partire dalla seconda riga vengono quindi inseriti i valori ammissibili inserendo nella prima colonna (ad esempio A:2) il valore visualizzato dall’utente e nella seconda colonna (ad esempio B:2) il valore che sarà effettivamente salvato nel database in caso di selezione di tale opzione.
L’assenza di valore in una data riga per entrambe le colonne che definiscono il set determinano la fine dei valori ammissibili per quel dato set. Non vanno quindi lasciate “righe vuote” all’interno della definizione di un set.
Tutti i valori utilizzati per il salvataggio sul database (seconda colonna) devono essere univoci nella relativa lista. Inserire voci duplicate anche se in posizioni differenti nella stessa colonna NON è consentito.
Per la definizione di quali metadati mostrare nella scheda breve e scheda completa dell’item occorre accedere alla UI di configurazione tramite il menù Configurazione > Prodotti > Layout schede e definire, per ogni tipologia di scheda prodotto, gli attributi della scheda breve. NB: è possibile modificare l’ordinamento dei campi selezionati (quelli di cui si è spuntata la checkbox “Mostra”) tramite drag&drop