Novell Documentation: Novell Identity Manager 3 - Configurazione della portlet Elenco di ricerca

20.2 Configurazione della portlet Elenco di ricerca

Per configurare la portlet Elenco di ricerca, si esegue la procedura seguente:

Passaggio	Task	Descrizione
1	Definire: Le entità e gli attributi che gli utenti potranno sottoporre a ricerca. La modalità di visualizzazione dell'elenco dei risultati.	È possibile utilizzare l'azione predefinita Ricerca directory, che viene installata con l'applicazione utente di Identity Manager così com'è. È possibile modificarla o creare un'azione personalizzata. Per ulteriori informazioni, vedere la sezione Sezione 20.2.2, Impostazione delle preferenze della portlet Elenco di ricerca.
2	Verificare che l'insieme di entità e attributi per la ricerca sia definito nello strato di astrazione directory.	Per ulteriori informazioni, vedere il capitolo Sezione 4.0, Configurazione dello strato di astrazione directory.
3	Determinare la modalità di accesso alla portlet da parte degli utenti.	Scegliere se si desidera che gli utenti avviino la portlet da una pagina esistente o da una pagina nuova. Per ulteriori informazioni sulle pagine, vedere il capitolo Sezione 7.0, Amministrazione di pagine.
4	Impostare preferenze per la portlet.	Le preferenze della portlet Elenco di ricerca consentono di definire gli elementi seguenti: Gli attributi visualizzati per ogni formato dell'elenco dei risultati. Il formato di visualizzazione dell'elenco dei risultati che verrà utilizzato per una data ricerca. L'ordinamento di default per i formati degli elenchi dei risultati. Per ulteriori informazioni, vedere la sezione Sezione 20.2.2, Impostazione delle preferenze della portlet Elenco di ricerca.
5	Verificare le impostazioni	Verificare che nell'elenco dei risultati risultino gli attributi desiderati.
6	Impostare diritti eDirectory e stabilire gli eventuali indici necessari per migliorare le prestazioni.	Diritti eDirectory: Per eseguire una ricerca: L'utente che esegue la ricerca deve disporre dei diritti Sfogliatura su qualsiasi utente o oggetto sottoposto a ricerca. Per salvare una ricerca (per utenti senza diritti di amministratore): Trustee dell'unità organizzativa e organizzazione in cui verrà eseguita la ricerca. L'utente deve disporre dei diritti di scrittura, di aggiunta e cancellazione di se stesso e di supervisore.
6		Miglioramento delle prestazioni: l'efficacia della ricerca può essere migliorata aggiungendo un indice di valore eDirectory all'attributo sul quale è basata la ricerca.

Per ulteriori informazioni sulla definizione di formati di visualizzazione diversi dell'elenco dei risultati, vedere la sezione Sezione 20.2.2, Impostazione delle preferenze della portlet Elenco di ricerca.

20.2.1 Impostazione dello strato di astrazione directory

Le entità e gli attributi che è possibile selezionare nell'elenco a discesa dei criteri di ricerca e i dati restituiti dalle ricerche nell'Identity Vault devono essere definiti nello strato di astrazione directory. Nella tabella seguente sono mostrate le proprietà che è necessario impostare per le entità e gli attributi utilizzati in un elenco di ricerca.

Tipo di definizione	Impostazione	Valore dello strato di astrazione directory
entità	view	Selezionato (true)
attributo	enable	Selezionato (true)
	search	Selezionato (true) Se è false, non è possibile definire una ricerca su questo attributo o includerlo in un formato dell'elenco di ricerca.
	hide	Non selezionato (false) La proprietà hide di ogni attributo per il quale la ricerca è selezionata (true) deve risultare non selezionata (false) per la motivazione che nella portlet Elenco di ricerca il valore della proprietà hide non viene esaminato durante la ricerca (l'operazione potrebbe deteriorare le prestazioni). Si supponga che Utente1 imposti l'attributo HomePhone su hide=true (in eDirectory). Poiché HomePhone può essere sottoposto a ricerca, il record viene recuperato ma non vengono esaminati i valori degli altri attributi per evitare di incidere negativamente sulle prestazioni. Se un altro utente ricercasse una corrispondenza esatta dell'attributo HomePhone, il record nascosto verrebbe visualizzato nell'elenco di ricerca.

Altre impostazioni dello strato di astrazione directory Il tipo di dati, il tipo di formato, i filtri e l'ambito della ricerca dello strato di astrazione directory incidono sulla portlet Elenco di ricerca. Il tipo di dati e il tipo di formato incidono sull'aspetto mentre il filtri e l'ambito della ricerca determinano la quantità di dati restituita.

Per ulteriori informazioni, vedere la sezione Sezione 4.3, Utilizzo di entità e attributi.

20.2.2 Impostazione delle preferenze della portlet Elenco di ricerca

È possibile definire due tipi di preferenze:

Preferenze di ricerca

Le preferenze di ricerca sono incluse in un'unica pagina:

Le preferenze di ricerca sono le seguenti:

Preferenza	Operazione
Modalità di default	Consente di specificare l'aspetto della portlet visualizzata al primo accesso di un utente. I valori sono i seguenti: Ricerca di base: consente di immettere un criterio di ricerca unico. Ad esempio: Nome inizia con A Ricerca avanzata: consente di definire criteri di ricerca multipli in uno o più blocchi di ricerca. È possibile utilizzare gli operatori logici and/or nei criteri di ricerca o tra i blocchi di ricerca. È ad esempio possibile creare una ricerca analoga all'esempio seguente: (Nome inizia con A o Nome inizia con B) e (Area geografica = Nord-Est o Area geografica = Sud-Est) OPPURE (Nome inizia con A e Cognome inizia con B) o (Nome inizia con B e Cognome inizia con A) Ricerche personali salvate: consente di visualizzare un elenco delle ricerche salvate dall'utente che ha eseguito il login. Le ricerche vengono salvate nell'attributo srvprvQueryList dell'utente. NOTA:gli utenti hanno la possibilità di accedere alla modalità preferita in fase di runtime eseguendo o modificando una ricerca oppure facendo clic su un pulsante nella parte inferiore della portlet.
Impaginazione	Numero massimo di righe visualizzate per volta.
Limite risultati	Numero massimo di corrispondenze restituite dalla ricerca. Se si imposta il valore 0, verrà utilizzato il massimo impostato nello strato di astrazione directory.
Preferenza complessa di ricerca ed elenco	Fare clic per ridefinire gli elementi seguenti: Entità da sottoporre a ricerca Tipo del gruppo di risultati Attributi da includere nelle pagine e ordine di visualizzazione Per default qualsiasi oggetto elencato nello strato di astrazione directory con attributo view=true viene incluso nella ricerca. L'elenco di attributi dell'entità viene desunto dagli attributi elencati nello strato di astrazione directory e da quelli definiti come enable=true.

Preferenze dei formati dell'elenco dei risultati

La pagina delle preferenze complesse consente di definire le entità da includere nella ricerca e il formato dell'elenco dei risultati. La pagina delle preferenze di default si presenta come nell'illustrazione seguente:

Le preferenze complesse sono le seguenti:

Preferenza	Operazione
Definizione entità	A ogni oggetto valido per la ricerca (view=true) corrisponde un blocco Definizione entità in questa pagina delle preferenze. Utilizzare queste preferenze per eseguire le operazioni seguenti: Definire gli oggetti inclusi nella ricerca. Modificare le definizioni dei formati degli elenchi di risultati (ad esempio aggiungendo o rimuovendo gli attributi visualizzati e il relativo ordinamento). Rimuovere gli oggetti che non si desidera includere nella ricerca facendo clic sul pulsante di eliminazione disponibile sulla riga Definizione entità. L'intero blocco della definizione entità verrà eliminato. È possibile reintegrare l'oggetto nella ricerca in un secondo momento facendo clic su Aggiungi definizione entità (nella parte inferiore della pagina) e completando i pannelli di selezione della procedura guidata. SUGGERIMENTO:se un oggetto non è presente in questo elenco ma risulta nello strato di astrazione directory, selezionare il modificatore view (nell'oggetto entità). Se è impostato su false, l'entità non potrà essere utilizzata nelle portlet di identità.
Mostra e-mail come icona	Quando è impostato su true e nell'elenco dei risultati è specificato un attributo e-mail, viene visualizzata un'icona. Quando è impostato su false, verrà visualizzato l'indirizzo di e-mail completo. L'attributo e-mail (testo o icona) è un collegamento mail-to: sul quale è possibile fare clic.
Tipi di elenco risultati (default)	Consente di specificare il formato di default dell'elenco dei risultati per l'entità corrente. L'impostazione di default viene utilizzata solo quando l'utente corrente non seleziona un formato diverso.
Blocco del formato di visualizzazione dell'Elenco risultati	Consente di specificare il formato di visualizzazione (ad esempio le pagine di identità, ubicazione o organizzazione) e l'insieme di attributi da includere per il tipo. Per rimuovere un tipo di elenco risultati: Fare clic sul pulsante di eliminazione visualizzato accanto al tipo di elenco risultati. Il tipo di pagina e tutti gli attributi associati verranno eliminati dalla ricerca. Per aggiungere una pagina del gruppo di risultati: Fare clic sul pulsante di espansione e selezionare il formato del gruppo di risultati nell'elenco di possibilità.
Attributi	Consente di specificare l'insieme di attributi che verranno visualizzati per lo specifico formato di visualizzazione. Per aggiungere o rimuovere un attributo: Fare clic sul pulsante di modifica degli attributi. Per aggiungere un attributo, selezionarlo nell'elenco degli attributi disponibili. Fare clic sulla freccia per spostarlo nell'elenco Selezionato. Eseguire l'operazione inversa per rimuovere un attributo dall'Elenco risultati. Per riordinare l'elenco degli attributi, fare clic sulla freccia su o sulla freccia giù a destra dell'elenco selezionato. Fare clic su Invia. Attributi e tipi di dati: il tipo di dati dell’attributo incide sul modo in cui questo è visualizzato. Se ad esempio un attributo è definito come sottotipo di elenco locale o globale, i valori possibili vengono visualizzati in una casella di riepilogo a discesa nelle schermate dei criteri di ricerca di base o avanzati. Se il tipo è un nome distinto, viene visualizzato un pulsante per la ricerca e l'accesso alla cronologia per consentire agli utenti di selezionare un valore nelle schermate dei criteri di ricerca di base o avanzati. Il nome distinto verrà risolto in una visualizzazione semplificata nell'elenco dei risultati. Il tipo di dati e il sottotipo, inoltre, limitano l'operatore di confronto visualizzato per l'utente per fare in modo che vengano costruiti solo confronti validi. Per ulteriori informazioni, vedere il capitolo Sezione 4.0, Configurazione dello strato di astrazione directory.
Ordinamento blocco del formato di visualizzazione dell'Elenco risultati	L'ordinamento dell'elenco dei risultati è basato su questo attributo. L'ordinamento di default diventa effettivo solo se il tipo di gruppo di risultati non coincide con il formato di visualizzazione della sessione utente corrente. Attributi multivalore e attributi a valore singolo: il numero di record visualizzati in un elenco di risultati cambia in funzione dell'attributo di ordinamento (a valore singolo o multivalore). Di solito l'ordinamento basato su attributi multivalore produce apparentemente più record, nonostante il numero totale di corrispondenze rimanga immutato. Ciò dipende dal fatto che ogni valore di un attributo multivalore occupa una riga.

Completamento del pannello delle preferenze

Per verificare se i dati immessi sono validi, fare clic su Invia. Se un dato immesso non è valido, viene visualizzato un messaggio di errore nella parte superiore della pagina delle preferenze. Terminata la correzione degli errori, fare clic su Torna alla visualizzazione dell'elenco, quindi su Salva preferenze.