Nella seguente guida viene illustrato come gestire le etichette all'interno dell'Archivio. La modifica dei testi delle etichette consente di personalizzare l'Archivio e di aprirlo all'internazionalizzazione.
Il tool di gestione delle etichette è disponibile solo agli amministratori dell'Archivio che operano in Visione Completa. Per accedervi occorre portarsi in Configurazione → Gestione etichette.
Il tool si compone di varie voci. Di seguito viene spiegato lo scopo di ciascun elemento.
Le etichette in IRIS sono formate da una chiave e da un insiem di valori associati ad essa.
La chiave è univoca e serve ad identificare l'etichetta. I valori possono essere i seguenti:
Ad esempio la voce del menu Desktop Prodotti è associata all'etichetta menu.module.dspace.mydspace.menu.label.
Questa etichetta ha i seguenti valori di default:
Nel caso si volesse modificare questa etichetta occorre richiamare la chiave menu.module.dspace.mydspace.menu.label.
Le etichette presenti in Archivio sono suddivise in due categorie:
Le etichette di default sono quelle native di IRIS, cioè che non hanno subito alcuna modifica.
Quando una etichetta di default viene modificata, viene creata l'etichetta custom corrispondente che ha la stessa chiave di quella di default, ma con il valore differente deciso dall'amministratore di ateneo.
Per modificare un'etichetta già esistente in Archivio occorre selezionare la voce Cerca Etichette Default. Attraverso la form successiva è possibile cercare l'etichetta desiderata. Questa sezione si compone di una form di ricerca e una tabella che mostra i risultati ottenuti. Al primo accesso sono mostrate tutte le etichette presenti in Archivio. Una volta individuata si può procedere alla modifica del valore visualizzato. Come visto precedentemente, la modifica di un'etichetta di default consiste nella creazione della corrispondente etichetta custom (stessa chiave, ma valore differente).
Di seguito l'elenco dei filtri che compongono la form di ricerca e il loro significato:
I risultati sono presentati in forma tabellare. Le colonne hanno il seguente significato:
[it] Valore di Default: valore di default in italiano;
[it] Valore Custom: valore modificato in italiano (se vuoto vuol dire che l'etichetta non ha ancora subito modifiche);
[en] Valore di Default: valore di default in inglese;
[en] Valore Custom: valore modificato in inglese (se vuoto vuol dire che l'etichetta non ha ancora subito modifiche)
Se si vuole modificare il valore di un'etichetta di default occorre cliccare sul tasto Crea Etichetta Custom.
Successivamente compare la form per la creazione dell'etichetta Custom.
La form si compone di un campo in cui inserire il valore Italiano da sovrascrivere, il valore in inglese da sovrascrivere e il riepilogo del valore di default in italiano e inglese.
La modifica di un'etichetta di default consiste nella creazione di un'etichetta custom il cui valore sarà sostituito a quello dell'etichetta di default. Cancellando l'etichetta custom viene ripristinato il valore dell'etichetta di default.
Per modificare l'etichetta di default occorre inserire il nuovo valore all'interno dei rispettivi campi e quindi cliccare sul pulsante Salva posto in fondo alla pagina.
Ad esempio, se si vuole fare in modo che il titolo del desktop prodotti sia modificato da "Desktop prodotti" a "Il mio Desktop prodotti" per la lingua italiana, occorre scrivere "Il mio Desktop prodotti" all'interno del campo Valore quindi cliccare su Salva.
Per rendere effettiva la modifica occorre cliccare sul bottone Ricariche Etichette posto nel menu.
La gestione delle etichette custom avviene attraverso il tool raggiungibile cliccando sul tasto Cerca Etichette Custom posto all'interno del menu.
Attraverso questa sezione è possibile gestire le etichette custom ovvero quelle etichette che sono state create per modificare il valore delle corrispondenti etichette di default.
Questa sezione si compone di una form di ricerca e da una tabella che mostra i risultati ottenuti.
Al primo accesso sono mostrate tutte le etichette presenti in Archivio.
Di seguito l'elenco dei filtri che compongono la form di ricerca e il loro significato:
I risultati sono presentati in forma tabellare.
Le colonne hanno il seguente significato:
[it] Valore di Default: valore di default in italiano;
[it] Valore Custom: valore modificato in italiano (se vuoto vuol dire che l'etichetta non ha ancora subito modifiche);
[en] Valore di Default: valore di default in inglese;
[en] Valore Custom: valore modificato in inglese (se vuoto vuol dire che l'etichetta non ha ancora subito modifiche)
Nel caso si debba aggiungere una nuova etichetta è possibile utilizzare il bottone Nuova Etichetta visibile agli Amministratori che operano in Visione Completa all'interno della tool di gestione delle etichette di default.
Cliccando sul pulsante Nuova Etichetta si accede alla form di creazione di una nuova etichetta. La form è la stessa che viene utilizzata per la modifica di un'etichetta, dettagliata in questo paragrafo Gestione delle etichette.
La visione amministrativa è uno strumento che consente di visualizzare le chiavi delle etichette presenti in Archivio. Questa modalità è utile per capire le chiavi delle etichette che si vorrebbero modificare.
Come gli altri componenti del tool di gestione delle etichette, anche la visione amministrativa è disponibile solo agli amministratori dell'Archivio che operano in Visione Completa.
Per iniziare la visione amministrativa occorre portarsi nel menu e quindi scegliere la voce Gestione etichette → Inizia visione amministrativa.
In questo modo viene ricaricata la pagina che si stava consultando, ma verrà visualizzata la chiave delle etichette e non il loro valore.
Nell'esempio sottostante viene visualizzato il desktop prodotti in visione amministrativa.
Quando viene avviata la visione amministrativa, viene visualizzato il alto a destra un messaggio che permette di terminare la visione amministrativa.
Il messaggio scompare se si esegue una qualsiasi azione all'interno della pagina.
Per terminare la visione amministrativa è possibile ricaricare la pagina che si sta consultando (premendo il tasto f5) e quindi cliccare sul bottone Termina che compare all'interno del messaggio in alto a destra che segnala che la visione amministrativa è stata attivata.
In alternativa è possibile portarsi all'interno del menu e selezionare la voce, gestione etichette, Termina visione amministrativa, che corrisponde alla chiave menu.module.ma.i18n.administrativeStop.menu.label.
Attraverso questa funzione è possibile esportare l'elenco delle etichette dell'Archivio. Accedendo a questo tool compare una form che consente di effettuare diversi tipo di export.
Il significato degli elementi che compongono la form è il seguente:
Cliccando su Download viene generato l'elenco delle etichette desiderato sotto forma di file di testo (.txt).
Attraverso questa funzione è possibile eseguire l'importazione massiva di etichette all'interno dell'Archivio, consentendo all'amministratore la modifica di più etichette con un un'unica azione.
Questa funzionalità è particolarmente utile qualora si vogliano valorizzare le etichette con tag html o script.
Il tool è composto da una form di upload che consente di indicare il tipo di import che si sta facendo. Il significato degli elementi che compongono la form è il seguente:
In questa sezione vengono visualizzate le etichette che sono state modificate dall'utente e il cui valore di default è stato successivamente sovrascritto da Cineca.
Ad esempio, prendiamo in considerazione l'etichetta jsp.mydspace il cui valore di default è "Desktop Prodotti": se creiamo un'etichetta custom con la funzione Gestione Pubblicazioni e successivamente il valore di default viene sovrascritto da Cineca con "Il mio Desktop Prodotti", allora l'etichetta verrà visualizzata in questa sezione.
La pagina si presenta come una tabella le cui colonne hanno il seguente significato:
[it] Valore di Default: valore di default in italiano;
[it] Valore Custom: valore modificato in italiano (se vuoto vuol dire che l'etichetta non ha ancora subito modifiche);
[en] Valore di Default: valore di default in inglese;
[en] Valore Custom: valore modificato in inglese (se vuoto vuol dire che l'etichetta non ha ancora subito modifiche)
Le chiavi di tutti i messaggi inviati da IRIS sono strutturate nel seguente modo: mail.template.[identificativo_template], dove identificativo_template rappresenta il nome del template di ciascuna mail. L'elenco completo dei template delle mail inviate da IRIS è disponibile nella seguente sezione Notifiche e-mail modulo IR (Institutional Repository)
Le chiavi delle intestazioni delle colonne dei file excel generati dai tool di export del portale pubblico e del desktop prodotti sono strutturate nel seguente modo: excel.export.dc.[element].[qualifier], dove element e qualifier sono gli identificativi del metadato. Ad esempio, se si vuole modificare il valore per l'intestazione della colonna Data di pubblicazione, occorre tenere presente che la data di pubblicazione corrisponde al metadato dc.date.issued. Pertanto occorre utilizzare la chiave excel.export.dc.date.issued.
All'interno delle form delle entità che fanno parte del modulo RM (Resource Management) e del modulo AP (Activities & Projects) sono state introdotte delle etichette che presentano delle informazioni aggiuntive rispetto ai campi in cui sono visualizzate. Le etichette si presentano come dei pulsanti "i" (informazioni) che se cliccati mostrano il contenuto dell'etichetta.
Queste particolari etichette hanno la seguente struttura <info.[dato della form]>