18.2 Configurazione della portlet Organigramma

Per configurare la portlet Organigramma è necessario eseguire le operazioni seguenti:

Passaggio 1

Task

Descrizione

1

Definire la relazione che si desidera visualizzare.

È possibile utilizzare una delle relazioni predefinite installate nell'applicazione utente di Identity Manager oppure creare relazioni personalizzate.

Per ulteriori informazioni sulla definizione di una relazione, vedere il capitolo Sezione 4.0, Configurazione dello strato di astrazione directory.

2

Verificare che le entità e gli attributi che si desidera utilizzare nella relazione siano disponibili nello strato di astrazione directory.

Per ulteriori informazioni sulla definizione di una relazione, vedere la sezione Sezione 18.2.1, Impostazione dello strato di astrazione directory.

3

Determinare il punto in cui visualizzare la relazione.

Scegliere se si desidera creare una nuova pagina per l'avvio dell'organigramma oppure se si desidera avviare l'organigramma dalla portlet Dettagli o da un altro organigramma.

Per ulteriori informazioni sulla creazione di pagine e sull'aggiunta di portlet a tali pagine, vedere il capitolo Sezione 7.0, Amministrazione di pagine.

4

Impostare preferenze per la portlet.

Le preferenze consentono di definire:

  • Gli attributi da visualizzare.
  • La modalità di visualizzazione (il rispettivo layout HTML)

Per ulteriori informazioni, vedere la sezione Sezione 18.2.2, Impostazione delle preferenze dell'organigramma.

5

Test

Verificare le definizioni di relazione e il layout.

6

Impostare diritti eDirectory e stabilire gli eventuali indici necessari per migliorare le prestazioni.

Diritti effettivi: per visualizzare gli attributi definiti nella portlet, è necessario che gli utenti dispongano dei diritti in Lettura sugli attributi.

Miglioramento delle prestazioni: la visualizzazione dell'organigramma può essere migliorata aggiungendo un indice di valore eDirectory all'attributo secondario della relazione, poiché l'attributo secondario viene utilizzato per l'esecuzione di una ricerca LDAP.

18.2.1 Impostazione dello strato di astrazione directory

Le entità e gli attributi visualizzati in un organigramma devono essere definiti nello strato di astrazione directory. Nella tabella seguente sono mostrati gli attributi e le proprietà che è necessario impostare per ogni entità e ogni attributo visualizzato in un organigramma.

Tipo di definizione

Impostazione

Valore

entità

view

Selezionato (true)

attributo

read

Selezionato (true)

search

Selezionato (true)

Requisiti del collegamento Consultazione Il collegamento Consultazione consente di esplorare l'organigramma eseguendo ricerche di altri oggetti dello stesso tipo della chiave di entità superiore. È necessario che la chiave di entità superiore disponga almeno di un attributo le cui proprietà di accesso obbligatorio e ricerca siano impostate su true (devono risultare selezionate nell'editor dello strato di astrazione directory). In caso contrario la finestra di dialogo Ricerca oggetto del collegamento Consultazione non potrà essere popolata e risulterà vuota.

Per ulteriori informazioni sulla configurazione di entità e attributi, vedere il capitolo Sezione 4.0, Configurazione dello strato di astrazione directory.

18.2.2 Impostazione delle preferenze dell'organigramma

È possibile definire due tipi di preferenze:

Preferenze relative alle relazioni dell'organigramma

Le preferenze relative alle relazioni della portlet Organigramma sono incluse in un'unica pagina.

Descrizione: Descrizione: Illustrazione

.

.

.

Descrizione: Descrizione: Illustrazione

Preferenza

Operazione

Layout di presentazione

Fare clic su Visualizza/modifica preferenza personalizzata per accedere alle preferenze di layout, descritte in Preferenze di layout dell'organigramma.

Chiave di relazione

Digitare la chiave di relazione. Questo valore deve corrispondere a una delle chiavi di relazione specificate nello strato di astrazione directory.

Chiave di entità superiore

Digitare il nome distinto dell'entità che rappresenta il nodo radice dell'organigramma da visualizzare oppure, per visualizzare l'organigramma dell'utente corrente, digitare ${User/id}. Il parametro ${User/id} viene risolto nel nome distinto dell'utente corrente.

Questo valore deve essere compreso tra i nodi specificati dalla proprietà di ricerca radice nello strato di astrazione directory. In caso contrario la ricerca LDAP avrà esito negativo.

Di seguito vengono illustrati alcuni esempi di nomi distinti validi (con dati di esempio):

  • Per visualizzare la chiave di relazione da utente a utente in cui il dipendente Giacomo Magli costituisce la radice dell'organigramma, è necessario specificare:

cn=gmagli,ou=utenti,ou=esempio,o=novell
  • Per visualizzare la chiave di relazione da gruppo a utenti in cui il gruppo della contabilità rappresenta il nodo radice, è necessario specificare:

cn=contabilità,ou=gruppi,ou=esempio,o=novell

Profondità di default

Consente di specificare la profondità dell'organigramma quando viene visualizzato per la prima volta.

  • 0: viene mostrata solo la radice
  • 1: vengono mostrati la radice e gli elementi secondari
  • 2: vengono mostrati la radice, gli elementi secondari e gli elementi di terzo livello

e così via. Se questo valore viene incrementato in modo tale da superare il valore di Profondità massima, quest'ultimo avrà la priorità.

Profondità massima

Consente di definire la profondità massima raggiungibile in un organigramma. Non coincide con la possibilità di passare da un elemento all'altro di un organigramma, operazione limitata da diritti effettivi.

Skin organigramma

Biglietto da visita

eGuide

Novell.com

Collegato

True Blue

Collega connettori agli elementi

Consente di specificare se i biglietti da visita dell'organigramma sono collegati mediante connettori. Se è false, i biglietti da visita dell'organigramma non sono collegati.

Timeout menu

Numero di millisecondi prima della scomparsa del menu visualizzato (per i collegamenti incorporati).

Presentazione albero

Consente di definire l'orientamento, la distribuzione e l'aspetto dell'organigramma per livello di profondità.

I primi n valori definiranno l'orientamento, la distribuzione e l'aspetto per i livelli da 0 a n-1. L'ultimo valore verrà utilizzato ripetutamente per i livelli di profondità superiori a n-1. I valori devono essere compresi tra 0 e 5.

I valori sono i seguenti:

0: segnaposto sopra un elenco verticale di elementi.

1: riga sopra un elenco verticale di elementi.

2: segnaposto sopra un elenco orizzontale di elementi.

3: riga sopra un elenco orizzontale di elementi.

4: segnaposto davanti a un elenco verticale di elementi.

5: riga davanti a un elenco verticale di elementi.

Presentazione foglia

Consente di definire l'orientamento, la distribuzione e l'aspetto dell'organigramma relativamente alla profondità massima di una diramazione.

Larghezza minima dell'elemento

Questo valore deve essere uguale a round('altezza minima dell'elemento' * 1,618)

Altezza minima dell'elemento

Questo valore deve essere uguale a round('larghezza minima dell'elemento' / 1,618)

Separatore per attributi multivalore

Carattere utilizzato come separatore in attributi con più di un valore.

Preferenze di layout dell'organigramma

Le preferenze di layout dell'organigramma consentono di definire il layout HTML per la visualizzazione delle voci contenute nell'organigramma. È possibile utilizzare l'editor HTML preferito per apportare modifiche più precise. Vedere Per utilizzare un editor esterno.

Descrizione: Descrizione: Illustrazione

Layout HTML per biglietti da visita: layout di default.

Layout HTML per visualizzazione semplice: layout visualizzato quando la preferenza di presentazione dell'albero è impostata su 1.

Editor HTML Per accedere all'editor HTML, fare clic sul pulsante di modifica. L'editor HTML si presenta nel modo seguente:

Descrizione: Descrizione: Illustrazione
Utilizzo dell'editor HTML

L'editor HTML fornisce un'interfaccia WYSIWYG (What You See Is What You Get) per definire il layout delle foglie dell'organigramma. Mette a disposizione le funzioni tipiche di un editor HTML che consentono di definire la formattazione del testo e degli elenchi, di specificare ancore e immagini e così via. Utilizzare l'elenco a discesa Parole chiave per disporre attributi, comandi e URL di navigazione all'interno dell'area del layout. La parola chiave scelta nell'elenco a discesa viene inserita con la sintassi corretta ma è ugualmente possibile aggiungere elementi HTML all'interno dell'area del layout.

Parole chiave Durante la definizione del layout, è possibile utilizzare l'elenco a discesa Parole chiave per inserire variabili che verranno sostituite da specifici valori di attributo in fase di runtime. In alternativa è possibile digitare riferimenti alle variabili rispettando la sintassi seguente:


$[[parola chiave]]

Dove parola chiave rappresenta il valore di un attributo di entità, ad esempio Cognome.

È possibile concatenare gli attributi rispettando la sintassi seguente:


$[[parola chiave+parola chiave]]

Ad esempio: 


$[[Nome+Cognome]]

È possibile concatenare il numero di attributi desiderato e inserire inoltre stringhe racchiuse tra virgolette, come segue:


$[[parola chiave+”testo di esempio”+parola chiave]]

In tal modo verranno generati i valori delle parole chiave e il testo racchiuso tra virgolette.

NOTA:se una parola chiave viene digitata in modo errato nel layout, nell'organigramma verrà rappresentata tal quale (compresi i caratteri $[[]]).

Funzioni dell'editor HTML e utilizzo di parole chiave Per utilizzare le funzioni dell'editor HTML e l'elenco a discesa Parole chiave:

Funzione

Suggerimento

Pulsante Inserisci collegamento

Per inserire un collegamento:

In Mozilla:

  1. Evidenziare il testo al quale si desidera aggiungere il collegamento ipertestuale e fare clic su Inserisci collegamento.
  2. Digitare l'URL e fare clic su Crea collegamento.
  3. Salvare le preferenze.

In IE:

  1. Fare clic su Inserisci collegamento.
  2. Digitare l'URL nella finestra popup.
  3. Evidenziare il testo al quale si desidera aggiungere il collegamento ipertestuale e fare clic su Crea collegamento (nella finestra popup).
  4. Salvare le preferenze.

NOTA:se l'immagine o l'URL si trova nell'area in alto a sinistra dell'editor HTML, verrà nascosto dalla finestra popup. Poiché non è possibile spostare la finestra popup, sarà necessario creare il testo desiderato in un'altra posizione dell'editor, per poi tagliarlo e incollarlo nell'ubicazione corretta.

Pulsante Aggiungi immagine

In Mozilla:

  1. Posizionare il mouse sul punto in cui si desidera inserire l'immagine e fare clic su Aggiungi immagine.
  2. Digitare l'URL e il testo e fare clic su Crea immagine nella finestra popup.
  3. Salvare le preferenze.

In IE:

  1. Fare clic su Aggiungi immagine.
  2. Digitare l'URL e il testo nella finestra popup, quindi posizionare il mouse sul punto in cui si desidera inserire un'immagine e fare clic su Crea immagine nella finestra popup.
  3. Salvare le preferenze.

NOTA:se l'immagine o l'URL si trova nell'area in alto a sinistra dell'editor HTML, verrà nascosto dalla finestra popup. Poiché non è possibile spostare la finestra popup, sarà necessario creare il testo desiderato in un'altra posizione dell'editor, per poi tagliarlo e incollarlo nell'ubicazione corretta.

Elenco a discesa Parole chiave: Attributi

Insieme degli attributi disponibili per questa entità.

Elenco a discesa Parole chiave: Comandi

Questi comandi consentono alla portlet Organigramma di avviare altre portlet di identità o funzioni incorporate quali IM o strumenti di e-mail.

  • Pulsante di azione IM: consente di creare un pulsante per inviare messaggi di IM.
  • Pulsante di azione posta: consente di creare un pulsante per inviare messaggi e-mail.
  • Pulsante di azione organigramma: consente di creare un pulsante per passare a un'altra relazione, in cui l'elemento superiore è costituito dall'istanza dell'entità selezionata.
  • Pulsante di azione informazioni: consente di avviare la portlet Dettagli.

Per gli esempi dei pulsanti generati, vedere Collegamenti incorporati.

URL

Collegamento URL di navigazione organigramma: consente di specificare un URL o un attributo di entità che verrà visualizzato come collegamento. Quando si fa clic sul collegamento, la portlet Organigramma viene nuovamente visualizzata e l'entità su cui si è fatto clic costituisce il nodo radice.

Restrizione:

valido solo quando l'oggetto delle entità superiore e secondaria di una relazione è dello stesso tipo. Nella relazione Manager-Dipendente, ad esempio, entrambe le entità sono oggetti Utente.

Suggerimenti di utilizzo:

Per utilizzare questa parola chiave, è necessario eseguire la procedura seguente:

  1. Fare clic su Visualizza origine.
  2. Digitare la parola chiave @NavUrl rispettando la sintassi seguente:

<a href="javascript:$[[@NavUrl]]">testo</a>

dove testo è il collegamento da visualizzare in fase di runtime o l'attributo di un'entità. Nell'esempio seguente Fare clic qui assume l'aspetto di un collegamento su cui è possibile fare clic:


<a href="javascript:$[[@NavUrl]]">Fare clic qui</a>

Nell'esempio seguente l'attributo Nome assume l'aspetto del collegamento su cui è possibile fare clic:


<a href="javascript:$[[@NavUrl]]">$[[Nome]]</a>

Restrizione:

In Internet Explorer non è possibile utilizzare la sintassi seguente:


<a href="$[[@NavUrl]]">testo</a>

Durante l'operazione di salvataggio viene aggiunto quanto segue:


http://contesto davanti a $[[@NavUrl]]

Ciò significa che 


<a href="$[[@NavUrl]]">testo</a>

diventa


<a href="http://hostlocale/.../$[[@NavUrl]]">testo</a>

che non verrà visualizzato correttamente in fase di runtime.

 

Collegamento Clic di navigazione organigramma: utilizzare questa parola chiave per un evento onClick (consente l'aggiornamento della sola area della portlet Organigramma anziché della pagina intera).

Suggerimenti di utilizzo:

Per utilizzare questa parola chiave, è necessario eseguire la procedura seguente:

  1. Fare clic su Visualizza origine.
  2. Digitare la parola chiave @NavClick rispettando la sintassi seguente:

<A href="javascript:return false;" onClick="$[[@NavClick]]">$[[Attributo]]</A>

dove attributo è un attributo di entità che assume l'aspetto di un collegamento su cui fare clic.

"javascript:return false;" è obbligatorio. Se omesso, viene generato un errore.

Per salvare i layout definiti, fare clic su Invia.

Per utilizzare un editor esterno È possibile utilizzare un editor HTML esterno nei modi seguenti:

  1. Creando l'origine HTML per gli attributi, i comandi e le parole chiave dell'entità utilizzando l'editor del layout HTML disponibile nelle preferenze.

  2. Copiando l'origine HTML nell'editor preferito.

  3. Apportando le modifiche desiderate.

  4. Ricopiando l'origine HTML nell'editor del layout HTML dopo aver completato le operazioni di modifica.

18.2.3 Caricamento dinamico delle immagini

Per visualizzare le immagini, ad esempio le foto dell'utente, memorizzate nell'Identity Vault, è possibile aggiungere il nome dell'attributo al biglietto da visita. Se ad esempio si aggiunge l'attributo Foto dell'utente al layout del biglietto da visita, viene visualizzata la foto dell'utente.

Se le immagini sono memorizzate in una posizione diversa dall'Identity Vault, è necessario utilizzare il tag IMG: (nella modalità Visualizza origine dell'editor HTML) come descritto di seguito:

  1. Passare alle preferenze della portlet Organigramma e accedere all'editor HTML.

  2. Fare clic su Visualizza origine.

  3. Utilizzare il tag IMG: per unire un'ubicazione, una chiave di attributo e un'estensione di file rispettando una sintassi analoga alla seguente:


$[[IMG:”URL” + nome-chiave-attributo+ ”estensionefile”]]

Nell'esempio seguente viene mostrata la sintassi da utilizzare se le foto dell'utente vengono memorizzate come immagini JPG per Cognome nella sottodirectory /images del server per applicazioni.


$[[IMG:"http://host:8080/images/"+Cognome+".jpg"]]

In fase di runtime viene eseguito il concatenamento dell'URL con l'attributo Cognome e l'estensione di file .jpg.

Notare che l'editor HTML supporta una sintassi flessibile. Supporta qualsiasi combinazione di testo e attributi, quindi la sintassi è la seguente:


$[[IMG:”testo” + nome-chiave-attributo+ ...]]