Introduzione

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 internazzionalizzarlo.
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.

• Cerca Etichette Custom: permette di accedere alla form di ricerca e gestione delle Etichette Custom;
• Cerca Etichette Default: permette di accedere alla form di ricerca e modifica delle Etichette Default;
• Ricarica Etichette: permette di rendere effettive le modifiche fatte alle etichette;
• Inizia visione amministrativa: consente di visualizzare le chiavi delle etichette all'interno delle pagine dell'Archivio;
• Termina visione amministrativa: consente di terminare la visione Amministrativa, tornando a visualizzare i valori delle etichette all'interno delle pagine dell'Archivio;
• Importa: consente di esportare tutte le etichette presenti in Archivio;
• Esporta: consente di importare le etichette da file;
• Verifica Etichette:consente di accedere a un tool che mostra le etichette che sono state modificate dall'utente e il cui valore di default successivamente è stato modificato da CINECA.

Forma delle etichette

Le etichette in IRIS sono formate da una chiave e da un insiemi di valori associati ad essa.
La chiave è univoca e serve ad identificare l'etichetta. I valori possono essere i seguenti:

• *\[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);

Ad esempio il titolo che compare all'interno de Desktop Prodotti è associato all'etichetta jsp.mydspace. Questa etichetta ha i seguenti valori di default:

• *\[it\] Valore di Default:* Desktop prodotti

• *\[en\] Valore di Default:* My DSpace

Nel caso si volesse modificare questa etichetta occorre fare riferimento alla chiave jsp.mydspace.

Classificazione delle etichette

Le etichette presenti in Archivio sono suddivise in due categorie:

• Etichette di Default
• Etichette Custom

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 avrà la stessa chiave di quella di default, ma un valore differente.

Modifica di un etichetta di Default

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 da 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. Per farlo occorre cliccare sul pulsante Operazioni e quindi selezionare la voce Crea Etichetta Custom. Come visto precedentemente la modifica di un etichetta di default consiste nella creazione della corrispondente etichetta custom (stessa chiave, ma valore differente).

I filtri

Di seguito l'elenco dei filtri che compongono la form di ricerca e il loro significato:

• Chiave: permette di cercare le etichette a partire dalla loro chiave;
• Valore: permette di cercare le etichette a partire dal loro valore;

Tabella dei risultati

I risultati sono presentati in forma tabellare. Le colonne hanno il seguente significato:

• Chiave: rappresenta la chiave dell'etichetta;
• Valore: mostra i valori possibili dell'etichetta. I valori possibili sono i seguenti:
  
  

*\[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);

• Operazioni permette di modificare l'etichetta attraverso il tasto Crea Etichetta Custom.

Modifica di un Etichetta

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 rirpristinato 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.

Gestione di Etichette Custom

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.

I filtri

Di seguito l'elenco dei filtri che compongono la form di ricerca e il loro significato:

• Chiave: permette di cercare le etichette a partire dalla loro chiave;
• Valore: permette di cercare le etichette a partire dal loro valore;

Tabella dei risultati

I risultati sono presentati in forma tabellare.

Le colonne hanno il seguente significato:

• Chiave: rappresenta la chiave dell'etichetta;
• Valore: mostra i valori possibili dell'etichetta. I valori possibili sono i seguenti:
  
  

*\[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);

• Operazioni permette di scegliere tra le seguenti operazioni

Modificare: permette di accedere alla form di modifica dell'etichetta;
Elimina: permette di eliminare dell'etichetta custom. In questo caso verrà ripristinata la visualizzazione del valore di default dell'etichetta;
Dettaglio: permette di visualizzare tutti i valori dell'etichetta per esteso;

Visione amministrativa

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.

Inizia visione amministrativa

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 incominciata la visione amministrativa viene visualizzato il alto a destra un boxe che permette di terminare la visione amministrativa. Il boxe scompare se si esegue una qualsiasi azione all'interno della pagina.

Termina visione amministrativa

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 boxe 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

Esporta Etichette

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:

• Tipo esportazione: è un radio button che consente di scegleire di esportare solo le etichette cstom, solo le etichette default oppure entrambe (Completa);
• Lingua: è un menu a tendina che permette di scegliere di esportare le etichette in italiano o in inglese;
• Caratteri: è un menu a tendina che consente di selezionare l'insieme di caratteri in cui esportare le etichette. Il valore di default è UTF-8;

Cliccando su Download viene generato l'elenco delle etichette desiderato sotto forma di file.txt.

Importa Etichette

Attraverso questa funzione è possibile importare delle etichette all'interno dell'Archivio. L'import di etichette consente di modificare più etichette con un unica azione. Questa funzionalità è particolarmente utile qualora si vogliono 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:

• Lingua: consente di indicare la lingua delle etichette che si stanno importando;
• Codifica caratteri: consente di indicare la codifica dei caratteri delle etichette che si stanno importando. Di default è selezionato il valore Rilevamento automatico che permette di rilevare automaticamente la codifica dei caratteri del file che si sta utilizzando per l'import;
• Sovrascrivi esistenti: è un radio butto i cui valori sono si e no.
• File: consente di aprire la finestra per caricare il file;

Verifica Etichette

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 ilcui valore di default è Desktop Prodotti. Se creiamo un etichetta custom con valore Gestione Pubblicazioni e successivamente il valore di default viene sovrascritto da CINECA con Il mio Desktop Prodotti, allora l'etichetta verrà visualizzata in questo tool.

La pagina si presenta come una tabella le cui colonne hanno il seguente significato:

• ID: rappresenta l'identificativo interno dell'etichetta;
• Chiave: rappresenta la chiave dell'etichetta;
• Valore: mostra i valori possibili dell'etichetta. I valori possibili sono i seguenti:
  
  

*\[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);

• Operazioni: in questa colonna sono presenti tre pulsanti che consentono di eseguire le seguenti azioni:
  • Modifica: permette di accede alla form di modifica dell'etichetta (vedi sopra). Salvando le modifiche il valore inserito verrà assegnato al'letichetta;
  • Conferma valore in uso: consente di assegnare all'etichetta il valore in uso e di eliminare il valore di default sovrascritto da CINECA;
  • Elimina etichetta custom: consente di assegnare all'etichetta il valore di default sovrascritto da CINECA e di eliminare il valore in creato con l'etichetta custom;