Table of Contents

Introduzione

L'input-form è un file excel che contiene i metadati che compongono le tipologie di documento presenti in archivio. Attraverso questo file è possibile definire il set di metadati per ciascuna tipologia di documento indicandone posizione, tipologia ed etichette ad essi associati. 

Il file input-form.xlsx può essere caricato in archivio solo dall'Help Desk di IRIS. Attraverso il tool input-form gli amministratori dell'archivio possono modificare i metadati che compongono ciascuna tipologia di documento

In questa guida vedremo come è strutturata l'input-form, la sua gestione e che relazione ha sia con la submission che con il layout della scheda prodotto.

File input-form.xlsx

Il file è costituito da quattro fogli:

1. Input-form
2. value-pairs
3. i18n
4. validations

Foglio input-form

Il foglio contiene l'elenco dei metadati di ciascuna tipologia di documento e le relative informazioni. L'ordine in cui i metadati compaiono all'interno del foglio ricalca quello in cui saranno visualizzati all'interno della submission e della scheda prodotto (in visione semplice e completa della scheda prodotto).

Di seguito il dettaglio delle colonne presenti nel foglio:
Colonna A-form_name → indica il nome della tipologia di documento.
Colonna B-page → indica lo step di submission in cui compare il metadato.
Colonna C-element → indica l'element in formato Dublin Core del metadato.
Colonna D-qualifier → indica il qualifier in formato Dublin Core del metadato.
Colonna E-input-type → indica la tipologia di metadato. I valori possibili sono i seguenti:

• ance → associato ai metadati authority.ancejournal e authority.anceserie. Consente di visualizzare in submission la form per l'interrogazione del catalogo ANCE;
• contributors → associato al metadato authority.people. Permette di visualizzare in submission la form di riconoscimento della stringa autori;
• date → consente di visualizzare in submission il campo per l'inserimento di una data;
• default_value → associato a metadati che devono avere dei valori calcolati automaticamente dal sistema (come ad esempio identifier.citation);
• dropdown → associato a metadati che prevedono una lista certa di valori associati;
• onebox → associato a metadati che devono essere valorizzati con un testo alfanumerico inserito dall'utente;
• qualdrop_value → associato a metadati che prevedono più di una lista certa di valori;
• text_area → associato a metadati che devono essere valorizzati con un testo molto lungo (ad esempio title);
• year → associato a metadati che devono essere valorizzato solo con un anno;

Colonna F-list_name → indica la lista associata ad un metadato con input-type dropdown, oppure la logica di sistema associata ad un metadato di tipo default_value.
Colonna G-repeatable → indica se il metatado può essere ripetuto in submission oppure no. I valori possibili sono i seguenti:

• true → il metadato può essere ripetuto in submissio;
• false → il metadato non può essere ripetuto in submission;

Colonna H-scope → è una colonna ad uso interno di IRIS.
Colonna I-label → indica la chiave dell'etichetta associata al nome del metadato. Questa etichetta è utilizzata sia in submission che all'interno della scheda prodotto.
Colonna J-validazioni → indica gli eventuali controlli che insistono su un metadato e l'eventuale messaggio di errore che viene visualizzato in submission.
Colonna K-hint → indica la chiave dell'etichetta associata al suggerimento del metadato visualizzato in submission.
Colonna L-view_mode → indica se un metadato deve comparire solo nella scheda completa o anche in quella breve del prodotto. I possibili valori sono i seguenti:

• completa → il metadato viene visualizzato solo all'interno della scheda completa e non in quella breve del prodotto;
• breve → il metadato viene visualizzato sia all'interno della scheda completa che della scheda breve del prodotto;

Colonna M- view autheticated only → è una colonna ad uso interno di IRIS.
Colonna N- view type → è una colonna ad uso interno di IRIS.

Foglio value-pairs

In questo foglio è contenuto l'elenco di valori previsti per ciascun metadato di tipo default_value. L'ordine in cui compaiono nel foglio è lo stesso in cui saranno visualizzati all'interno della submisison.
Colonna A-list_name → indica la lista di cui fa parte il valore. Corrisponde alla lista indicata nella colonna E - input-type del foglio input-forms.
Colonna B-i18n key → indica la chiave dell'etichetta associata al valore.
Colonna C-stored value → indica il valore che viene salvato su database dal sistema.

Foglio i18n

In questo foglio è contenuto l'elenco di tutte le etichette presenti nei fogli 'input-forms' e 'value-pairs'.
Colonna A-chiave → indica la chiave dell'etichetta.
Colonna B-default → indica il valore di default dell'etichetta.

Foglio validations

In questo foglio è contenuto l'elenco di tutti i controlli di validazione configurati all'interno della colonna J del foglio input-forms.
Colonna A Validatore → contiene l'elenco dei possibili validatori. I valori previsti sono i seguenti:

• notNull
• wosCheck
• scopusCheck
• pubmedCheck
• doiCheck
• isbnCheck
• year

Colonna B-Spiegazione → contiene la spiegazione dei valori presenti nella colonna 'A-Validatore'.

Tool Input-form

Il tool input-form è disponibile agli amministratori che operano in visione completa. Per accedervi occorre andare nel menu e selezionare le voci Configurazione > Prodotti > input form > lista.

l'amministratore attraverso tale funzionalità ha la possibilità di gestire i metadati che sono presenti nella submission e nella scheda scheda prodotto.

La maschera è  composta da:

• campo 'tipologia' per la scelta del tipo di prodotto su cui si vuole intervenire;
• il resto della pagina è interessata da una tabella in cui sono visualizzati i metadati del prodotto selezionato nel campo 'tipologia'.

 Di seguito i dettagli sui campi e azioni visualizzati in questa pagina.

Campo Tipologia

Il campo tipologia è un menu a tendina che contiene l'elenco di tutte le tipologie di documento presenti in archivio. Per ciascuna tipologia di documento selezionata viene proposto l'elenco dei metadati che la compongono

Gestione dei metadati

La tabella in cui sono esposti i metadati ricalca la struttura del file input-form.xlsx 

Colonna pagina → indica lo step di submission in cui compare il metadato. Questo campo rispecchia la colonna B page del foglio input-forms del file input-form.xls. I valori di questo campo non possono essere modificati.

Colonna 'posto' → indica l'ordine di visualizzazione del metadato sia all'interno della submission che della scheda prodotto. Utilizzando i pulsanti freccia su e freccia giù è possibile modificare l'ordinamento dei metadati.

Colonna 'metadato' → in questa colonna viene riportato il nome del metadato in formato Dublin Core (colonne C elemet e D qualifier del foglio input-forms del file input-form.xls) e tra parentesi la tipologia di dato ad esso associato (colonna E input-type del foglio input-forms del file input-form.xls). Per i metadati di tipo dropdown o qualdrop_value viene riportata la lista di valori associata ad esso (colonna F list name del foglio input-forms del file input-form.xls). Cliccando sul nome della lista viene visualizzata la lista di valori che la compongono (foglio value-paird del file input-form.xls).

Nell'immagine sotto un esempio di dato del tipo dropdown e di lista ad esso associata

Colonna 'scrittura' → è una colonna ad uso interno di IRIS.
Colonna 'etichette e validazioni' → in questa colonna sono indicati  l'etichette associata al metadato  (colonne I label K hint del foglio input-forms del file input-form.xls) e gli eventuali controlli di validità presenti sul metadato (colonna J validazioni del foglio input-forms del file input-form.xls).

Colonna 'breve/completa' → questa colonna consente di gestire il layout del metadato all'interno della scheda prodotto.

Attraverso il primo tasto è possibile indicare se il metadato deve essere visualizzato solo nella visione completa o anche nella visione breve della scheda prodotto. Questo campo rispecchia la colonna L view_mode del foglio input-forms del file input-form.xls. I valori possibili sono i seguenti:

• completa → il metadato viene visualizzato solo all'interno della visione completa e non in quella semplice della scheda prodotto;
• breve → il metadato viene visualizzato sia all'interno della visione completa che della visione semplice della scheda prodotto;

Attraverso il secondo pulsante è possibile dare al metadato un layout di visualizzazione specifico all'interno della scheda prodotto, sia che questo sia visualizzato all'interno della visione breve o della visione completa. I possibili valori sono i seguenti:

• auto
• testo
• thumbnail
• icona full-text
• anno accademico (XXXX/XXXX-1)
• input form
• data
• link
• contributor – standard
• contributor – colorato

Attraverso il terzo pulsante è possibile indicare se un metadato deve essere visibile solo agli utenti autenticati oppure lo deve essere anche per utenti anonimi. I possibili valori sono i seguenti:

• Visualizza solo ad utenti autenticati;
• Visualizza anche ad utenti anonimi;

Gestione delle versioni

Quando viene caricata una nuova versione dell'input form IRIS tiene traccia delle modifiche fatte salvando tutte le input-form caricate. In fondo alla pagina compare un elenco di tutte le versioni salvate.

Le varie versioni sono mostrate dalla meno recente alla più recente. Per ciascuna versione è indicato il numero progressivo ei commenti inseriti quando il file è stato caricato. In ultima posizione compare l'ultima versione in grassetto che è quella attualmente in uso. Cliccando sul pulsante a forma di lente di ingrandimento è possibile caricare nel tool la visualizzazione di quella versione dell'input-form per controllare le eventuali differenze con quella attuale.

Esporta input-form

Attraverso il pulsante Esporta input-form è possibile scarica re il file input-form.xlsx.