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 nella submission e scheda prodotti (breve o completa) rispecchia l'ordine presente nel file
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 metadato 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 nella tabella sotto 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 riporta il valore della 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 competa di valori (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'etichetta 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': è possibile gestire la visualizzazione del metadato all'interno della scheda prodotto attraverso le configurazioni presenti in questa colonna.
Nel primo campo sono presenti i valori 'breve' e 'completa'
Scegliendo 'breve' il metadato è visibile sia nella scheda breve che in quella completa del dettaglio prodotto (come da immagine sotto):
Scegliendo 'completa' il metadato è visibile solo nella scheda completa del dettaglio prodotto.
Attraverso il secondo campo a tendina è possibile configurare per il metadato un layout di visualizzazione specifico all'interno della scheda prodotto (la configurazione incide su entrambe le schede, breve e completa). Posizionandosi sul campo si visualizza un menu a tendina con diverse scelte.
I possibili valori sono i seguenti:
L'amministratore ha la possibilità di definire una diversa visibilità del metadato differenziando tra utenti autenticati sul portale e utenti non autenticati. Cliccando sull'icona il dato sarà visibile anche agli utenti che consultano il prodotto pubblicato sulla home page pubblica e che non hanno eseguito l'autenticazione sul portale. Dopo ver attivato tale funzione l'icona si presenterà di colore verde
Version file input-form.xlsx
In fondo alla pagina vengono tracciate tutte le modifiche all'input form attuate con il caricamento di nuove versioni del file di configurazione 'input-form.xlsx' (come da immagine a seguire).
Le varie versioni sono mostrate dalla meno recente alla più recente. Per ciascuna versione è indicato il numero progressivo, nella colonna a destra sono esposti i commenti inseriti in fase di caricamento del file.
In ultima posizione compare l'ultima versione in grassetto che è quella attualmente in uso.
Cliccando sul pulsante a forma di lente di ingrandimento è possibile visualizzare nella pagina la versione dell'input-form di interesse, in modo da poter controllare le eventuali differenze con quella attuale. In alto nella pagina è indicata la versione di input-form visualizzata.
Dal pulsante' esporta input form', posizionato in alto a sinistra della pagina, è' possibile eseguire il download dell'ultima versione del file 'input-form.xlsx.