Novell Documentation: Novell Identity Manager 3 - Configurando o portlet Lista de Pesquisa

20.2 Configurando o portlet Lista de Pesquisa

Para configurar o portlet Lista de Pesquisa, você seguirá um conjunto de etapas como este:

Etapa	Tarefa	Descrição
1	Definir: As entidades e os atributos que os usuários poderão pesquisar. Como a lista de resultados será exibida	Você pode usar a ação da Pesquisa de Diretórios que é instalada com o aplicativo de usuário do Identity Manager como está. É possível modificá-la ou criar uma própria. Para obter mais informações, consulte a Seção 20.2.2, Definindo preferências da Lista de Pesquisa.
2	Verificar se o conjunto de entidades e atributos para a pesquisa são definidos na camada de abstração do diretório.	Para obter mais informações, consulte o Seção 4.0, Configurando a Camada de Abstração do Diretório.
3	Determinar como os usuários devem acessar o portlet:	Os usuários poderão iniciar o portlet em uma página nova ou uma página existente? Para obter mais informações sobre páginas, consulte o Seção 7.0, Administração de Página.
4	Definir preferências para o portlet	As preferências do portlet Lista de Pesquisa permitem definir: Os atributos exibidos para cada formato da lista de resultados. Que formato de exibição da lista de resultados será produzido por uma pesquisa A ordem de classificação padrão dos formatos da lista de resultados Para obter mais informações, consulte a Seção 20.2.2, Definindo preferências da Lista de Pesquisa.
5	Testar as configurações	Verifique se as listas de resultados mostram os atributos desejados.
6	Definir os direitos do eDirectory e estabelecer os índices necessários para melhorar o desempenho	Direitos do eDirectory: Para executar uma pesquisa O usuário que executa a pesquisa precisa ter direitos de Pesquisar para os usuários ou objetos que estão sendo pesquisados. Para gravar uma pesquisa (para usuários não administrativos): Trustee da unidade organizacional e a organização onde a pesquisa será executada. Usuário requer direitos de gravação, de usuário e de supervisor.
6		Aprimoramento do desempenho — O desempenho da pesquisa pode ser melhorado com a inclusão do índice de valores do eDirectory no atributo em que a pesquisa se baseia.

Para obter mais informações sobre como definir diferentes formatos de exibição da lista de resultados, consulte a Seção 20.2.2, Definindo preferências da Lista de Pesquisa.

20.2.1 Configuração da camada de abstração do diretório

As entidades e os atributos que podem ser selecionados na lista suspensa de critérios de pesquisa e os dados retornados pelas pesquisas do cofre de identidade devem ser definidos na camada de abstração do diretório. A tabela a seguir mostra as propriedades que devem ser definidas para as entidades e os atributos usados pela lista de pesquisa.

Tipo de definição	Configuração	Valor da camada de abstração do diretório
entidade	exibir	Marcado (verdadeiro)
atributo	habilitar	Marcado (verdadeiro)
	pesquisar	Marcado (verdadeiro) Se for falso, você não poderá definir uma pesquisa neste atributo ou incluí-lo em um formato da lista de resultados
	ocultar	Desmarcado (falso) Qualquer atributo em que a pesquisa seja selecionada (verdadeiro) também deve ter ocultar definido como desmarcado (falso), pois o portlet Lista de Pesquisa não examina o valor da propriedade ocultar durante a pesquisa (porque ele prejudica o desempenho). Suponha que o Usuário 1 defina o atributo HomePhone seja ocultar=verdadeiro (no eDirectory). HomePhone pode ser pesquisado, de forma que a Lista de Pesquisa recupera o registro, mas não examina os valores dos outros atributos (devido ao impacto causado no desempenho). Se outro usuário pesquisar uma correspondência exata do atributo HomePhone, o registro oculto será exibido na lista de resultados.

Outras configurações da camada de abstração do diretório O tipo de dados, o tipo de formato, os filtros e o escopo da pesquisa da camada de abstração do diretório também causarão impacto no portlet Lista de Pesquisa. O tipo de dados e de formato afetam a aparência, o filtro e escopo da pesquisa afetarão como os dados serão retornados.

Para obter mais informações, consulte a Seção 4.3, Trabalhando com entidades e atributos.

20.2.2 Definindo preferências da Lista de Pesquisa

Você define dois tipos de preferências:

Preferências de pesquisa

As preferências de pesquisa estão contidas em uma única página de preferências:

As preferências de pesquisa são definidas abaixo:

Preferência	O que fazer
Modo Padrão	Especifique como deseja que o portlet seja exibido quando um usuário o acessar pela primeira vez. Os valores são: Pesquisa Básica — Permite que os usuários informem um único critério de pesquisa. Por exemplo: Nome começa com A Pesquisa Avançada — Permite que os usuários definam diversos critérios de pesquisa em um ou mais blocos. Os usuários podem usar os operadores lógicos e/ou nos critérios de pesquisa ou entre os blocos de pesquisa. Por exemplo, os usuários podem criar uma pesquisa como esta: (Nome começa com A ou Nome começa com B) e (Região= Nordeste ou Região = Sudeste) OU (Nome começa com A e Sobrenome começa com B) ou (Nome começa com B e Sobrenome começa com A) Minhas Pesquisas Gravadas — Exibe uma lista de pesquisas gravadas pelo usuário conectado. As pesquisas são gravadas no atributo srvprvQueryList do usuário conectado. NOTA:Os usuários podem acessar todos esses modos em tempo de execução por meio da execução ou edição de uma pesquisa ou ao clicar em um botão na parte inferior do portlet.
Paginação	O número máximo de linhas exibidas de uma vez.
Limite de Resultados	O número máximo de correspondências retornadas pela pesquisa. Se o valor for definido como 0, o máximo passa a ser a configuração da camada de abstração do diretório.
Preferência complexa da Lista de Pesquisa	Clique para refinar: As entidades a serem pesquisadas O tipo do conjunto de resultados Os atributos a serem incluídos nas páginas e a ordem em que eles aparecem Por padrão, todos os objetos listados na camada de abstração do diretório com o atributo exibir=verdadeiro são incluídos na pesquisa. A lista de atributos da entidade deriva-se dos atributos relacionados na camada de abstração do diretório e que estão definidos como habilitar=verdadeiro.

Preferências de formato da lista de resultados

A página de preferências complexas permite definir as entidades a serem incluídas na pesquisa e como formatar a lista de resultados. Esta é a aparência da página de preferências padrão:

As preferências complexas incluem:

Preferência	O que fazer
Definição de Entidade	Todo objeto válido para pesquisa (exibir=verdadeiro) tem um bloco de Definição de Entidade correspondente nesta página de preferências. Use as preferências para: Definir os objetos incluídos na pesquisa. Modificar as definições de formato da lista de resultados (como adicionar e remover os atributos exibidos e sua ordem de classificação padrão). Remover os objetos que não serão incluídos na pesquisa clicando no botão apagar que aparece na linha Definição de Entidade. O bloco de definição de entidade inteiro é apagado. Você pode adicionar o objeto novamente à pesquisa. Para isso, clique em Adicionar Definição de Entidade (localizada na parte inferior da página) e preencha os painéis de seleção do assistente. DICA:Se um objeto não aparecer na lista, mas estiver relacionado na camada de abstração do diretório, marque o modificador exibir(no objeto Entidade). Se estiver definido como falso, a entidade não poderá ser usada pelos portlets de identidade.
Mostrar e-mail como ícone	Quando verdadeiro e se houver um atributo E-mail especificado na lista de resultados, será exibido como um ícone. Quando falso, o atributo E-mail exibirá o endereço de e-mail completo. O atributo de e-mail (seja texto ou ícone) é um link mailto: em que se pode clicar.
Tipos de Lista de Resultados (padrão)	Especifica o formato padrão da lista de resultados da entidade atual. O padrão só é usado quando nenhum outro formato é selecionado pelo usuário.
Blocos de formato de exibição da Lista de Pesquisa	Especifica o formato de exibição (como páginas Identidade, Localização ou Organizacional) e inclui o conjunto de atributos a serem incluídos para o tipo. Para remover um tipo de lista de resultados: Clique no botão apagar ao lado do Tipo de Lista de Resultados. O tipo de página e todos os atributos associados são apagados da pesquisa. Para adicionar uma página de conjunto de resultados: Clique no botão expandir e selecione o formato do conjunto de resultados na lista de opções.
Atributos	Especifica o conjunto de atributos que aparecerão para o formato de exibição específico. Para adicionar ou remover um atributo: Clique no botão modificar atributos. Para adicionar um atributo, selecione-o (na lista de atributos disponíveis). Clique na seta para movê-lo para a lista Selecionado. Faça o inverso para remover um atributo na Lista de Resultados. Para reordenar a lista de atributos, clique nas setas para cima e para baixo à direita da lista selecionada. Clique em Submeter. Atributos e tipos de dados — O tipo de dados do atributo afeta a maneira como eles são exibidos. Por exemplo, se um atributo é definido como um subtipo de uma lista local ou uma lista global, os valores possíveis serão exibidos em uma caixa de listagem suspensa nas telas Critérios de Pesquisa Básica ou Avançada. Se o tipo for DN, um botão de localização e histórico será exibido para que os usuários possam selecionar um valor nas telas Critérios de Pesquisa Básica ou Avançada, e o DN será resolvido em uma tela simples na lista de resultados. O tipo e o subtipo dos dados também restringem o operador de comparação exibido para o usuário a fim de garantir que somente comparações válidas sejam elaboradas. Para obter mais informações, consulte o Seção 4.0, Configurando a Camada de Abstração do Diretório.
Classificação de blocos de formato de exibição da Lista de Pesquisa	A ordem de classificação da lista de resultados baseia-se neste atributo. A ordem de classificação padrão só será ativada se o Tipo de Conjunto de Resultados não for o formato de exibição da atual sessão do usuário. Atributos de vários valores e atributos de valor único — O número de registros exibidos em uma lista de resultados varia caso o atributo de classificação tenha valor único ou múltiplo. Classificar com atributos de vários valores em geral parece resultar em mais registros, embora o número total de correspondência seja o mesmo. Isso ocorre porque cada valor de um atributo com vários valores aparece em uma linha individual.

Preenchendo o painel de preferências

Para verificar se você enviou as entradas válidas, clique em Submeter. Se uma entrada não é válida, você verá uma mensagem de erro na parte superior da página de preferências. Depois de solucionar todos os erros, clique em Retorne à Tela de Lista e clique em Gravar Preferências.