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.
Il file è costituito da quattro fogli:
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:
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:
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:
Colonna M- view autheticated only → è una colonna ad uso interno di IRIS.
Colonna N- view type → è una colonna ad uso interno di IRIS.
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.
| Il valore contenuto nella colonna C-stored_value è quello che viene visualizzato all'interno dei report del tool Reportistica e Analisi. |
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.
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:
Colonna B-Spiegazione → contiene la spiegazione dei valori presenti nella colonna 'A-Validatore'.
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.
| Attraverso questo tool NON è possibile inserire o togliere metadati dalle tipologie di documento. Per fare modifiche di questo tipo occorre contattare l'Help Desk di IRIS utilizzando il Customer Portal. |
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:
Di seguito i dettagli sui campi e azioni visualizzati in questa pagina.
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
La tabella in cui sono esposti i metadati ricalca la struttura del file input-form.xlsx
| L'ordine di visualizzazione dei metadati all'interno della submission e della scheda prodotto rispecchia quello esposto in questa pagina. |
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:
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:
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:
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.
Attraverso il pulsante Esporta input-form è possibile scarica re il file input-form.xlsx.