Page tree
Skip to end of metadata
Go to start of metadata

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 IRISAttraverso 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 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:

  • 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 metadato può essere ripetuto in submission oppure no. I valori possibili sono i seguenti:

  • true: il metadato può essere ripetuto in submission;
  • 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.

NOTA

Il valore contenuto nella colonna C-stored_value è quello che viene visualizzato all'interno dei report del tool Reportistica e Analisi.

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.

ATTENZIONE

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:

  • 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 nella tabella sotto 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 


NOTA

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:

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

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.

Esporta input-form

Dal pulsante' esporta input form', posizionato in alto a sinistra della pagina, è' possibile eseguire il download dell'ultima versione del file 'input-form.xlsx.




  • No labels