Novell Documentation: Novell Identity Manager 3 - Configuración del portlet Lista de búsqueda

20.2 Configuración del portlet Lista de búsqueda

Para configurar el portlet Lista de búsqueda deberá ejecutar una serie de pasos como los siguientes:

Paso	Tarea	Descripción
1	Definir: Las entidades y atributos sobre los que dará permiso de búsqueda a los usuarios Cómo visualizará la lista de resultados	Puede utilizar la acción Búsqueda en Directorio predefinida que se instala con la aplicación de usuario del Gestor de identidades, tal cual. Puede modificarla o crear una propia. Si desea obtener más información, consulte Sección 20.2.2, Configuración de las preferencias de la lista de búsqueda.
2	Verificar que el conjunto de entidades y atributos de búsqueda estén definidos en el nivel de abstracción del directorio.	Si desea obtener más información, consulte Sección 4.0, Configuración del nivel de abstracción del directorio.
3	Determinar cómo desea que los usuarios accedan al portlet.	¿Desea que los usuarios lancen este portlet desde una página ya existente o desde una nueva? Para obtener más información acerca de las páginas, consulte Sección 7.0, Administración de páginas.
4	Definir las preferencias del portlet	Las preferencias del portlet de la lista de búsqueda permiten definir: Los atributos que se visualicen en cada formato de lista de resultados Qué formato de visualización de la lista de resultados producirá una búsqueda El orden de clasificación por defecto de los formatos de la lista de resultados Si desea obtener más información, consulte Sección 20.2.2, Configuración de las preferencias de la lista de búsqueda
5	Probar los valores	Verifique que las listas de resultados muestren los atributos deseados.
6	Defina los derechos de eDirectory y establezca los índices que sean necesarios para mejorar el rendimiento	Derechos de eDirectory: Para ejecutar una búsqueda El usuario que ejecute la búsqueda debe tener derechos de Browse (Examinación) sobre cualquier usuario u objeto donde se busque. Para guardar una búsqueda (en el caso de los usuarios no administrativos): Trustee de la unidad administrativa y de la organización en la que ejecutarán la búsqueda. Usuario necesita derechos de escritura, derechos sobre sí mismo y derecho de Supervisión.
6		Mejora del rendimiento: el rendimiento de la búsqueda se puede mejorar añadiendo un índice de valor de eDirectory al atributo en el que se basa la búsqueda.

Para obtener más información acerca de cómo definir los diversos formatos de visualización de la lista de resultados, consulte Sección 20.2.2, Configuración de las preferencias de la lista de búsqueda.

20.2.1 Configuración del nivel de abstracción del directorio

Las entidades y atributos que se pueden seleccionar en la lista desplegable de criterios de búsqueda y los datos devueltos por las búsquedas del repositorio seguro de identidades, deben estar definidos en el nivel de abstracción del directorio. La tabla siguiente muestra las propiedades que deben definirse para las entidades y atributos utilizados por la lista de búsqueda.

Tipo de definición	Configuración	Valor del nivel de abstracción del directorio
entity	view	Seleccionado (true)
attribute	enable	Seleccionado (true)
	search	Seleccionado (true) Cuando el valor sea false, no se podrá definir una búsqueda en este atributo, ni incluirlo en el formato de la lista de resultados
	hide	No seleccionado (false) Todos los atributos que tengan search seleccionado (true) deben tener también definido hide como no seleccionado (false) ya que el portlet Lista de búsqueda no examina el valor de la propiedad hide durante la búsqueda (ya que obstaculiza el rendimiento). Supongamos que User1 define el atributo HomePhone como hide=true (en eDirectory). HomePhone se puede buscar, por lo que Lista de búsqueda recupera el registro, pero no examina los valores de los atributos restantes (repercutiría sobre el rendimiento). Si otro usuario buscase una correspondencia exacta para el atributo HomePhone, el registro oculto se mostraría en la lista de resultados.

Otros valores del nivel de abstracción del directorio Los tipos de datos, tipos de formato, filtros y ámbito de búsqueda del nivel de abstracción del directorio también repercuten sobre el portlet Lista de búsqueda. El tipo de datos y de formato repercuten sobre la apariencia, mientras que el filtro y el ámbito de búsqueda repercuten sobre el volumen de datos devuelto.

Si desea obtener más información, consulte Sección 4.3, Funcionamiento de las entidades y los atributos.

20.2.2 Configuración de las preferencias de la lista de búsqueda

Se definen dos tipos de preferencias:

Preferencias de búsqueda

Las preferencias de búsqueda están contenidas en una única página de preferencias:

A continuación, definimos las preferencias de búsqueda:

Preferencia	Operaciones que puede realizar
Modo por defecto	Especificar cómo desea que el portlet se visualice cuando un usuario acceda por primera vez a él. Los valores son: Búsqueda básica: permite que los usuarios introduzcan un único criterio de búsqueda. Por ejemplo: El nombre empieza por A Búsqueda avanzada: permite que los usuarios definan varios criterios en uno o varios bloques de búsqueda. Los usuarios pueden utilizar los operadores lógicos "and" y "or" dentro de los criterios de búsqueda o en los bloques de búsqueda. Por ejemplo, los usuarios pueden crear una búsqueda como la siguiente: (Nombre empieza por A o Nombre empieza por B) y (Región = Nordeste o Región = Sureste) O (Nombre empieza por A y Nombre empieza por B) o (Nombre empieza por B y Apellido empieza por A )Mis búsquedas guardadas: muestra una lista de las búsquedas que el usuario conectado actualmente ha guardado. Las búsquedas se guardan en el atributo srvprvQueryList del usuario. NOTA:Los usuarios pueden acceder a cualquiera de estos modos en el tiempo de ejecución, ejecutando o editando una búsqueda o haciendo clic en un botón en la parte inferior del portlet.
Paginación	Número máximo de filas que se muestra a la vez.
Límite de resultados	Número máximo de coincidencias que devuelve la búsqueda. Si el valor está definido en 0, el máximo adoptará el valor del nivel de abstracción del directorio.
Preferencia compleja de búsqueda y lista	Haga clic para ajustar: Las entidades que se buscarán El tipo de resultado definido Los atributos que se incluirán en las páginas y el orden en que aparecerán Por defecto, todos los objetos listados en el nivel de abstracción del directorio que tengan el atributo view=true, se incluirán en la búsqueda. La lista de atributos de la entidad se obtiene de los atributos listados en el nivel de abstracción del directorio, cuya definición sea enable=true.

Preferencias de formato de Lista de resultados

La página de preferencias complejas permite definir las entidades que se incluirán en la búsqueda y cómo dar formato a la lista de resultados. La página de preferencias por defecto tiene una apariencia como la que mostramos a continuación:

Las preferencias complejas son:

Preferencia	Operaciones que puede realizar
Definición de entidad	Todos los objetos que se puedan buscar (view=true) tienen en esta página de preferencias un bloque de definición de entidad correspondiente. Utilice estas preferencias para: Definir los objetos incluidos en la búsqueda. Modificar las definiciones de formato de la lista de resultados (como añadir y eliminar los atributos que se visualizan y su orden de clasificación por defecto). Eliminar los objetos que no desee incluir en la búsqueda, haciendo clic en el botón de supresión que aparece en la línea de Definición de entidad. De esta manera, eliminará el bloque completo de definición de la entidad. Más tarde, puede volver a añadir el objeto a la búsqueda, haciendo clic en Añadir definición de entidad (situado en la parte inferior de la página) y completando los paneles de selección del asistente. SUGERENCIA:Si un objeto no aparece en la lista, pero está listado en el nivel de abstracción del directorio, compruebe el modificador view (en el objeto Entidad). Si está definido en false, los portlets de identidad no podrán utilizar la entidad.
Mostrar correo electrónico como icono	Cuando esté definido en true y la lista de resultados tenga especificado un atributo Email, se visualizará como un icono. Cuando esté definido en false, el atributo Email mostrará la dirección completa de correo electrónico. El atributo email (ya sea texto o icono) es un enlace de correo sobre el que se puede hacer clic.
Tipos de lista de resultado (valor por defecto)	Especifica el formato por defecto de la lista de resultados de la entidad actual. El valor por defecto se utiliza únicamente cuando el usuario actual no ha seleccionado otro formato.
Bloque de formato de visualización de la lista de resultados	Especifica el formato de visualización (como páginas de identidad, ubicación o de organización) e incluye el conjunto de atributos que se incluirán para el tipo. Para eliminar un tipo de lista de resultado: Haga clic en el botón de supresión que aparece junto a Tipo de lista de resultado. Esto eliminará de la búsqueda, el tipo de página y todos los atributos asociados. Para añadir una página de conjunto de resultados: Haga clic en el botón de expansión y seleccione el formato de conjunto de resultados en la lista de opciones.
Atributos	Especifica el conjunto de atributos que se visualizarán para un formato de visualización concreto. Para añadir o eliminar un atributo: Haga clic en el botón Modificar atributos. Para añadir un atributo, selecciónelo (en la lista de atributos disponibles). Haga clic en la flecha para moverlo a la lista Seleccionado. Ejecute la operación inversa para eliminar un atributo de la lista de resultados. Para reordenar la lista de atributos, haga clic en las flechas hacia arriba y hacia abajo situadas a la derecha de la lista seleccionada. Haga clic en Enviar. Tipos de atributos y datos: los tipos de datos del atributo influyen sobre la forma en que se visualizan. Por ejemplo, si un atributo se define como subtipo de la lista local o la lista global, los posibles valores se mostrarán en un recuadro de lista desplegable de las pantallas de criterios de búsqueda básica o avanzada. Si el tipo es DN, se visualizará un botón de historial y un botón de búsqueda para permitir que los usuarios seleccionen un valor en las pantallas de criterios de búsqueda básica o avanzada, y el DN se determinará en una pantalla fácil en la lista de resultados. Los tipos y subtipos de datos también restringen el operador de comparaciones que se muestra para el usuario, para asegurarse de que sólo se construyen comparaciones válidas. Si desea obtener más información, consulte Sección 4.0, Configuración del nivel de abstracción del directorio.
Orden del bloque de formato de visualización de la lista de resultados	El orden de clasificación de la lista de resultados se basa en este atributo y sólo entra en vigor si el tipo de conjunto de resultados no es el formato de visualización de la sesión de usuario actual. Atributos multivalentes y monovalentes: el número de registros visualizados en la lista de resultados dependerá de que el atributo de clasificación sea multivalente o monovalente. Por lo general, la clasificación en los atributos multivalentes dará como resultado más registros, aunque el número total de coincidencias siga siendo el mismo. Esto se debe a que cada valor de un atributo multivalente se muestra por si mismo en una línea.

Cumplimentación del panel de preferencias

Para verificar que ha enviado entradas válidas, haga clic en Enviar. Si una entrada no es válida, verá un mensaje de error en la parte superior de la página de preferencias. Cuando haya solucionado todos los errores, haga clic en Regresar a la vista de lista y, a continuación, en Guardar preferencias.