Novell Documentation: Novell Identity Manager 3 - Configurando o portlet Organograma

18.2 Configurando o portlet Organograma

Para configurar o portlet Organograma, você precisará:

Etapa	Tarefa	Descrição
1	Definir o relacionamento que você deseja exibir	Você pode usar um dos relacionamentos predefinidos que são instalados com o aplicativo de usuário do Identity Manager ou criar os seus próprios relacionamentos. Para obter mais informações sobre como definir um relacionamento, consulte o Seção 4.0, Configurando a Camada de Abstração do Diretório.
2	Verificar se as entidades e os atributos a serem usados no relacionamento estão disponíveis na camada de abstração do diretório	Para obter mais informações sobre como definir um relacionamento, consulte a Seção 18.2.1, Configuração da camada de abstração do diretório.
3	Determinar onde exibir esse relacionamento	Deseja criar uma nova página para iniciar o organograma? Ou deseja iniciá-lo no portlet Detalhes ou em outro organograma? Para obter mais informações sobre como criar páginas e adicionar portlet a essas páginas, consulte o Seção 7.0, Administração de Página.
4	Definir preferências para o portlet	As preferências permitem definir: Os atributos a serem exibidos Como exibi-las (seu layout HTML) Para obter mais informações, consulte a Seção 18.2.2, Definindo preferências de organograma.
5	Testar	Testar as definições e o layout do relacionamento
6	Definir os direitos do eDirectory e estabelecer os índices necessários para melhorar o desempenho	Direitos efetivos — Para exibir os atributos definidos pelo portlet, os usuários devem ter os direitos Ler aos atributos. Aprimoramento do desempenho — O desempenho da exibição do organograma pode ser melhorado com a inclusão do índice de valores do eDirectory no atributo filho do relacionamento, pois o atributo filho é usado para uma pesquisa LDAP.

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

As entidades e os atributos exibidos em um Organograma devem ser definidos na camada de abstração do diretório. A tabela a seguir mostra os atributos e as propriedades que devem ser definidas para cada entidade e atributo exibidos em um organograma.

Tipo de definição	Configuração	Valor
entidade	exibir	Selecionado (verdadeiro)
atributo	ler	Selecionado (verdadeiro)
atributo	Pesquisar	Selecionado (verdadeiro)

Requisitos do link de pesquisa O link de pesquisa permite que os usuários naveguem pelo organograma procurando outros objetos do mesmo tipo da Chave de Entidade Pai. É preciso que a chave de entidade pai tenha ao menos um atributo com as propriedades de acesso require e search definidas como verdadeiras (selecionadas no editor da camada de abstração do diretório). Caso contrário, a caixa de diálogo Pesquisa de Objeto do link de pesquisa não poderá ser preenchida e permanecerá vazia.

Para obter mais informações sobre a configuração de entidades e atributos, consulte o Seção 4.0, Configurando a Camada de Abstração do Diretório.

18.2.2 Definindo preferências de organograma

Você define dois tipos de preferências:

Preferências de relacionamento de organograma

As preferências de relacionamento de organograma estão contidas em uma página de preferências.

Preferência	O que fazer
Layouts de Apresentação	Clique em Exibir/Edit Custom Preferences para acessar as preferências de layout. Elas estão descritas em Preferências de layout de organograma.
Chave de Relacionamento	Digite a chave de relacionamento. Esse valor deve corresponder a uma das chaves de relacionamento especificadas na camada de abstração do diretório.
Chave de Entidade Pai	Digite o DN da entidade que representa o nó da raiz do organograma a ser exibido, ou, para exibir o organograma do usuário, digite ${User/id}. (O parâmetro ${User/id} é resolvido no DN do usuário.) Esse valor deve estar dentro dos nós especificados pela propriedade da raiz de pesquisa na camada de abstração do diretório ou a pesquisa LDAP falhará. Estes são alguns exemplos de DNs válidos (usando amostra de dados): Para exibir a Chave de Relacionamento user2users com o funcionário chamado Jack Miller como a raiz do organograma, você especifica: cn=jmiller,ou=users,ou=sample,o=novell Para exibir a Chave de Relacionamento group2users com o grupo Contabilidade como o nó da raiz, você especifica: cn=Accounting,ou=groups,ou=sample,o=novell
Profundidade padrão	Especifica a profundidade do organograma quando ele é exibido pela primeira vez. 0 — Mostrar somente a raiz 1 — Mostrar a raiz e seus filhos 2 — Mostrar a raiz, seus filhos e netos e assim por diante. Se esse valor receber um incremento e ficar superior à Profundidade Máxima (abaixo), o valor da profundidade máxima terá precedência.
Profundidade Máxima	Define a profundidade máxima de detalhamento em um organograma. É como navegar em um organograma limitado por direitos efetivos.
Máscara de Organograma	Cartão Comercial eGuide Novell.com Conectado True Blue
Conectar cabos a itens	Especifica se os curingas do organograma são conectados por cabos. Falso indica não conectado.
Menu Tempo de Espera	Número de milissegundos antes do menu (para os links internos) em exibição desaparecer.
Apresentação de Árvore	Define a orientação, a distribuição e a aparência por nível de profundidade do organograma. Os n primeiros valores definirão orientação, distribuição e aparência dos níveis de 0 a n-1. O último valor será usado repetidamente para níveis de profundidade superiores a n-1. Os valores devem estar entre 0 e 5. Os valores são: 0: Coloca o curinga acima de uma lista vertical de itens 1: Linha acima de uma lista vertical de itens 2: Coloca o curinga acima de uma lista horizontal de itens 3: Linha acima de uma lista horizontal de itens 4: Coloca o curinga acima de uma lista horizontal de itens 5: Linha antes de uma lista vertical de itens
Apresentação de Folha	Define a orientação, a distribuição e a aparência para a maior profundidade de uma ramificação do organograma.
Largura mínima do item	Este valor deve ser igual ao valor arredondado ('altura mínima do item' * 1.618)
Altura mínima do item	Este valor deve ser igual ao valor arredondado ('largura mínima do item' / 1.618)
Separador para atributos multivalor	O caractere utilizado como um separador para atributos com mais de um valor.

Preferências de layout de organograma

As preferências de layout de organograma permitem que você defina o layout HTML para a exibição de entradas do organograma. Você pode usar o editor de HTML de sua escolha para uma edição mais precisa. Consulte Para usar um editor externo.)

Layout HTML para cartões comerciais — O layout padrão.

Layout HTML para tela simples — O layout exibido quando a preferência da apresentação de árvore está definida como 1.

Editor de HTML Para acessar o editor de HTML, você clica no botão editar. Assim é o editor de HTML:

Usando o Editor de HTML

O Editor de HTML tem uma interface cuja aparência visual é compatível com os resultados e que permite definir o layout das folhas do organograma. Ele tem os recursos típicos de um editor de HTML para definir a formatação do texto e das listas, e também especificar âncoras e imagens, entre outros. Use a lista suspensa Palavras-chave para posicionar atributos, comandos e URLs de navegação na área de layout. Quando você escolhe uma palavra-chave na lista suspensa, ela é inserida com a sintaxe apropriada, mas você também pode adicionar HTML na área de layout.

Palavras-chave Ao criar seu layout, você pode usar a lista suspensa Palavras-chave para inserir variáveis que serão substituídas em tempo de execução por valores de atributo específicos. Você também pode digitar as referências usando esta sintaxe:


$[[palavra-chave]]

Onde palavra-chave é o valor de um atributo de entidade como LastName.

Você pode concatenar atributos usando esta sintaxe:


$[[palavra-chave+palavra-chave]]

Por exemplo:


$[[FirstName+LastName]]

Você pode concatenar quantos atributos quiser e também incluir strings entre aspas como esta:


$[[palavra-chave+”exemplo de texto”+palavra-chave]]

Os valores das palavras-chave e do texto entre aspas serão renderizados.

NOTA:Palavras-chave com erros ortográficos no layout serão processadas com tais erros no organograma (incluindo $[[]]).

Recursos do Editor de HTML e o uso de palavras-chave Para usar recursos do Editor de HTML e a lista suspensa Palavras-chave:

Recurso	Dica
Botão Inserir Link	Para inserir um link: No Mozilla: Realce o texto do hiperlink e clique em Inserir Link. Digite o URL e clique em Criar Link. Grave as preferências. No IE: Clique em Inserir Link. Digite o URL na janela popup. Realce o texto do hiperlink e clique em Criar Link (na janela popup). Grave as preferências. NOTA:Se a imagem ou o URL estiver no quadrante superior esquerdo do Editor de HTML, a janela popup o sobreporá. Como a janela popup não pode ser movida, você terá que criar o texto em outra parte do editor, e depois cortá-lo e colá-lo no local correto.
Botão Adicionar Imagem	No Mozilla: Posicione o mouse onde você deseja inserir uma imagem e clique em Adicionar Imagem. Digite o URL e o texto e clique em Criar Imagem na janela popup. Grave as preferências. No IE: Clique em Adicionar Imagem. Digite o URL e o texto na janela popup e posicione o mouse onde deseja inserir uma imagem. Em seguida, clique em Criar Imagem na janela popup. Grave as preferências. NOTA:Se a imagem ou o URL estiver no quadrante superior esquerdo do Editor de HTML, a janela popup o sobreporá. Como a janela popup não pode ser movida, você terá que criar o texto em outra parte do editor, e depois cortá-lo e colá-lo no local correto.
Lista suspensa Palavra-chave: Atributos	É o conjunto de atributos que estão disponíveis para a entidade.
Lista suspensa Palavra-chave: Comandos	Estes comandos permitem que o portlet Organograma iniciem outros portlets de identidade ou recursos internos como as ferramentas de IM ou e-mail. Botão Ação do IM — Cria um botão para o envio de mensagens instantâneas Botão Ação do Correio — Cria um botão para o envio de e-mails Botão Ação do OrgChart — Cria um botão para alternar para outro relacionamento, com a instância de entidade selecionada como o pai Botão Ação de Informações — Inicia o portlet Detalhes Para obter exemplos dos botões que são gerados, consulte Links internos.
URLs	Link URL de Navegação de Organograma — Permite que você especifique um atributo de URL ou de entidade que será exibido como um link. Quando o usuário clicar no link, o portlet Organograma será reexibido com a entidade clicada como o nó da raiz. Restrição: Isso só é válido quando as entidades pai e filho de um relacionamento são do mesmo tipo de objeto. Por exemplo, no relacionamento entre Gerentes e Funcionários, os dois são usuários. Dicas de uso: Para usar esta palavra-chave, é preciso: Clique em Exibir Origem. Digite a palavra-chave @NavUrl usando esta sintaxe: <a href="javascript:$[[@NavUrl]]">Texto</a> onde Texto é o link a ser exibido em tempo de execução ou um atributo de entidade. No exemplo a seguir, Clique aqui é um link em que é possível clicar. <a href="javascript:$[[@NavUrl]]">Clique aqui</a> No exemplo, o atributo FirstName é um link em que é possível clicar: <a href="javascript:$[[@NavUrl]]">$[[FirstName]]</a> Restrição de uso: Com o Internet Explorer, você não pode usar a sintaxe a seguir. <a href="$[[@NavUrl]]">someText</a> Durante uma operação de gravação, o Internet Explorer adiciona: http://context before $[[@NavUrl]] Isso significa que <a href="$[[@NavUrl]]">someText</a> se torna <a href="http://localhost/.../$[[@NavUrl]]">someText</a> e isso não será exibido corretamente em tempo de execução.
	Link Clique de Navegação de Organograma — Use esta palavra-chave para um evento onClick. (Permite que somente a área do portlet de organograma seja atualizada, e não a página inteira.) Dicas de uso: Para usar esta palavra-chave, é preciso: Clicar em Exibir Origem. Digitar a palavra-chave @NavClick usando esta sintaxe: <A href="javascript:return false;" onClick="$[[@NavClick]]">$[[Atributo]]</A> onde Atributo é um atributo de entidade que se torna um link em que é possível clicar. "javascript:return false;" é obrigatório. Sua omissão causará um erro.

Para gravar os layouts definidos, clique em Submeter.

Para usar um editor externo Você pode usar um editor externo de HTML:

Criando a origem HTML dos atributos de entidade, comandos e palavras-chave com o Editor de Layout HTML disponível nas preferências.
Copiando a origem HTML para o editor de sua escolha.
Fazendo as mudanças desejadas.
Copiando a origem HTML de volta para a preferência do Editor de Layout HTML depois de editá-la.

18.2.3 Carregando imagens dinamicamente

Para exibir imagens, como fotografias do usuário, que estão armazenadas no cofre de identidade, é possível adicionar o nome do atributo ao cartão comercial. Por exemplo, a inclusão do atributo Fotografia do Usuário ao layout do cartão comercial exibe a foto do usuário.

Se você armazena imagens fora do cofre de identidade, precisará usar a tag IMG: no modo Exibir Origem do Editor de HTML da seguinte maneira:

Vá até as preferências do portlet Organograma e acesse o Editor de HTML.
Clique em Exibir Origem.
Use a tag IMG: para combinar um local, uma chave de atributo e uma extensão de arquivo usando uma sintaxe como esta:


$[[IMG:”URL” + atributo-chave-nome + ”fileextension”]]

O exemplo a seguir mostra a sintaxe usada caso você tenha armazenado fotografias dos funcionários como imagens JPG de acordo com Sobrenome no subdiretório /images do servidor de aplicativos:


$[[IMG:"http://myhost:8080/images/"+LastName+".jpg"]]

Em tempo de execução, o organograma concatena o URL com o atributo LastName e a extensão de arquivo .jpg.

Lembre-se de que o Editor de HTML oferece suporte a uma sintaxe flexível. Ele aceita qualquer combinação de texto e atributos de forma que se obtenha uma sintaxe como:


$[[IMG:”qualquer texto” + atributo-chave-nome + ...]]