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. |
In questo paragrafo viene spiegato il funzionamento del tool input form che consente di gestire i metadati presenti sia in submission che nella scheda prodotto.
Il campo tipologia è un menu a tendina che contiene l'elenco di tutte le tipologie di documento presenti in archivio. Selezionando una voce presente al suo interno è possibile visualizzare l'elenco dei metadati che compongono una determinata tipologia ed eventualmente gestirli.
Il tool input form si compone come una tabella che "ricalca" la struttura del file input-form.xlsx. Per ciascuna tipologia di documento selezionata viene proposto l'elenco dei metadati che la compongono.
L'ordine in cui i metadati sono presentati è lo stesso in cui vengono visualizzati sia all'interno della submisson che all'interno della scheda prodotto. |
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 cjhe 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).
Colonna autorizzazioni scrittura → è una colonna ad uso interno di IRIS.
Colonna etichette e validazioni → in questa colonna sono riportate le etichette associate al metadato (colonne I label K hint del foglio input-forms del file input-form.xls) e le 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.