Vous êtes sur la page 1sur 197

CA IdentityMinder

Guia de Design do Console de Usurio


12.6.4

A presente documentao, que inclui os sistemas de ajuda incorporados e os materiais distribudos eletronicamente (doravante
denominada Documentao), destina-se apenas a fins informativos e est sujeita a alteraes ou remoo por parte da CA a
qualquer momento. Esta Documentao contm informaes proprietrias da CA e no pode ser copiada, transferida,
reproduzida, divulgada, modificada nem duplicada, parcial ou completamente, sem o prvio consentimento por escrito da CA.
Se o Cliente for um usurio licenciado do(s) produto(s) de software referido(s) na Documentao, permitido que ele imprima
ou, de outro modo, disponibilize uma quantidade razovel de cpias da Documentao para uso interno seu e de seus
funcionrios envolvidos com o software em questo, contanto que todos os avisos de direitos autorais e legendas da CA
estejam presentes em cada cpia reproduzida.
O direito impresso ou, de outro modo, disponibilidade de cpias da Documentao est limitado ao perodo em que a
licena aplicvel ao referido software permanecer em pleno vigor e efeito. Em caso de trmino da licena, por qualquer motivo,
fica o usurio responsvel por garantir CA, por escrito, que todas as cpias, parciais ou integrais, da Documentao sejam
devolvidas CA ou destrudas.
NA MEDIDA EM QUE PERMITIDO PELA LEI APLICVEL, A CA FORNECE ESTA DOCUMENTAO "NO ESTADO EM QUE SE
ENCONTRA", SEM NENHUM TIPO DE GARANTIA, INCLUINDO, ENTRE OUTROS, QUAISQUER GARANTIAS IMPLCITAS DE
COMERCIABILIDADE, ADEQUAO A UM DETERMINADO FIM OU NO VIOLAO. EM NENHUMA OCASIO, A CA SER
RESPONSVEL PERANTE O USURIO OU TERCEIROS POR QUAISQUER PERDAS OU DANOS, DIRETOS OU INDIRETOS,
RESULTANTES DO USO DA DOCUMENTAO, INCLUINDO, ENTRE OUTROS, LUCROS CESSANTES, PERDA DE INVESTIMENTO,
INTERRUPO DOS NEGCIOS, FUNDO DE COMRCIO OU PERDA DE DADOS, MESMO QUE A CA TENHA SIDO EXPRESSAMENTE
ADVERTIDA SOBRE A POSSIBILIDADE DE TAIS PERDAS E DANOS.
O uso de qualquer software mencionado na Documentao regido pelo contrato de licena aplicvel, e tal contrato no deve
ser modificado de nenhum modo pelos termos deste aviso.
O fabricante desta Documentao a CA.
Fornecida com Direitos restritos. O uso, duplicao ou divulgao pelo governo dos Estados Unidos est sujeita s restries
descritas no FAR, sees 12.212, 52.227-14 e 52.227-19(c)(1) - (2) e DFARS, seo 252.227-7014(b)(3), conforme aplicvel, ou
sucessores.
Copyright 2014 CA. Todos os direitos reservados. Todas as marcas comerciais, nomes de marcas, marcas de servio e
logotipos aqui mencionados pertencem s suas respectivas empresas.

Referncias a produtos da CA Technologies


Este documento faz referncia aos seguintes produtos da CA Technologies:

CA CloudMinder Identity Management

Diretrio do CA

CA IdentityMinder

CA GovernanceMinder (anteriormente CA Role & Compliance Manager)

CA SiteMinder

CA User Activity Reporting

CA AuthMinder

Entrar em contato com o Suporte tcnico


Para assistncia tcnica online e uma lista completa dos locais, principais horrios de
atendimento e nmeros de telefone, entre em contato com o Suporte tcnico pelo
endereo http://www.ca.com/worldwide.

ndice
Captulo 1: Personalizando o console de usurio

11

Console de usurio padro......................................................................................................................................... 11


Tarefas, guias e telas ........................................................................................................................................... 13
Personalizaes do console de usurio ...................................................................................................................... 14

Captulo 2: Navegao em tarefas

15

Navegao com base em tarefas ............................................................................................................................... 15


Navegao com base em objetos ............................................................................................................................... 16
Configurar a navegao com base em objetos ................................................................................................... 17
Categorias de tarefas ................................................................................................................................................. 18
Desativar o cancelamento automtico de tarefa ................................................................................................ 19
Fluxo de tarefas .......................................................................................................................................................... 20
Configurar guias de tarefas independentes ........................................................................................................ 21
Configurar a tarefa como assistente ................................................................................................................... 22
Configurar uma sequncia de guias .................................................................................................................... 23

Captulo 3: Configurando guias e telas de perfil

25

Guias e telas de perfil ................................................................................................................................................. 25


Personalizaes da tela de perfil ................................................................................................................................ 26
Modificar uma tela de perfil ....................................................................................................................................... 27
Adicionar ou remover campos ................................................................................................................................... 29
Propriedades do campo em uma tela de perfil .......................................................................................................... 30
Estilos de campo......................................................................................................................................................... 36
Opes do Seletor de data .................................................................................................................................. 38
Opes do Seletor de objetos ............................................................................................................................. 41
Exibio de atributo estruturado ........................................................................................................................ 43
Como preencher as opes de campo ....................................................................................................................... 47
Como selecionar um mtodo de preenchimento de campo .............................................................................. 48
Usar listas simples para opes de campo .......................................................................................................... 50
Dados da caixa de seleo................................................................................................................................... 51
Usar JavaScript para opes de campo ............................................................................................................... 63
Usar manipuladores de atributos lgicos para opes de campo ...................................................................... 65
Preenchendo dinamicamente o campo Organizao ......................................................................................... 66
Como alterar dinamicamente as propriedades de exibio do campo ...................................................................... 67
Configurar propriedades de exibio de campo dinmico ................................................................................. 68
Atributos lgicos definidos pela tela .......................................................................................................................... 69

ndice 5

Adicionar atributos lgicos definidos pela tela ................................................................................................... 70


Atributos lgicos definidos pela tela em Exibir tarefas enviadas ........................................................................ 70
Componentes adicionais em uma tela de perfil ......................................................................................................... 71
Opes para o atributo separador ...................................................................................................................... 71
Adicionar um atributo binrio ou uma imagem a uma tela de perfil ................................................................. 72
Adicionar sees de pgina ................................................................................................................................. 75
Adicionar uma tarefa aninhada ........................................................................................................................... 77
Adicionar texto de ajuda s tela de perfil ........................................................................................................... 78
Adicionar um campo Editor de histrico ............................................................................................................. 79
Adicionar um campo Exibio de histrico ......................................................................................................... 81
Configurar validao em nvel de tarefa .................................................................................................................... 82
Atributos personalizados definidos pelo usurio para funes ................................................................................. 83
Configurar atributos personalizados na guia Perfil para funes ....................................................................... 84
Adicionar atributos personalizados a definies da tela de pesquisa ................................................................ 84

Captulo 4: Configurando guias de conta

87

Guias da conta ............................................................................................................................................................ 87


Pr-requisito para usar a guia Contas ........................................................................................................................ 88
Campos na guia Contas .............................................................................................................................................. 88
Funes adicionais na guia Contas ............................................................................................................................. 89

Captulo 5: Telas de pesquisa e lista

91

Configurao da tela de pesquisa .............................................................................................................................. 91


Tela Modificar uma pesquisa .............................................................................................................................. 91
Filtros de pesquisa .............................................................................................................................................. 93
Campos de pesquisa e resultados da pesquisa ................................................................................................... 96
Ajuda definida pelo usurio nas telas de pesquisa ............................................................................................. 98
Tipos de tela de pesquisa .................................................................................................................................... 98
Telas de lista ............................................................................................................................................................. 101
Adicionar uma lista de tarefas .......................................................................................................................... 103
Tarefas adicionais nas telas de pesquisa e lista ....................................................................................................... 105
Adicionar tarefas extras s telas de pesquisa e lista ......................................................................................... 106

Captulo 6: Tarefas de autoatendimento

109

Tarefas de autoatendimento do CA IdentityMinder ................................................................................................ 109


Como configurar tarefas de autoatendimento ........................................................................................................ 110
Configure a tarefa de autorregistro ......................................................................................................................... 111
Configurar uma organizao padro para usurios autorregistrados .............................................................. 112
Adicionar perguntas e respostas de verificao ............................................................................................... 112
Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.......................................... 114

6 Guia de Design do Console de Usurio

Tarefa de redefinio de senha esquecida ....................................................................................................... 114


Tarefa de ID de usurio esquecida .................................................................................................................... 114
Tarefas personalizadas de redefinio de senha esquecida e de ID de usurio esquecida .............................. 115
Coletar pares de perguntas e respostas para verificao de usurio ............................................................... 115
Configurar a tarefa de redefinio de senha esquecida ou de ID de usurio esquecida .................................. 116
Telas de identificao de design ....................................................................................................................... 117
Telas de verificao de design........................................................................................................................... 118
Bloquear a tarefa de redefinio de senha esquecida ou de ID de usurio esquecida .................................... 121
Determinar como os usurios redefinem as senhas ......................................................................................... 123
Determinar como os usurios recuperam uma ID de usurio esquecida ......................................................... 124
Pginas de logoff ...................................................................................................................................................... 124
Configurando pginas de logoff ........................................................................................................................ 125

Captulo 7: Aplicando marca visual ao Console de usurio

127

Capas ........................................................................................................................................................................ 127


Componentes de uma capa...................................................................................................................................... 128
Capas do CA IdentityMinder .................................................................................................................................... 129
Associaes de capa ................................................................................................................................................. 132
Como criar uma capa ............................................................................................................................................... 132
Copiar uma capa existente ................................................................................................................................ 133
Atualizar as imagens da capa ............................................................................................................................ 133
Atualizar as cores e fontes da capa ................................................................................................................... 134
Modificar o arquivo .properties ........................................................................................................................ 134
Modificar o arquivo index.jsp ........................................................................................................................... 135
Recompilar os arquivos .jsp e reiniciar o servidor de aplicativos ............................................................................. 136
Como usar vrias capas ............................................................................................................................................ 136
Priorizar capas ................................................................................................................................................... 137
Criar uma resposta de capa .............................................................................................................................. 138
Como editar pginas do console .............................................................................................................................. 139
Como modificar o cabealho no Console de usurio do CA IdentityMinder .................................................... 140
Como modificar e mostrar o rodap ................................................................................................................. 141

Captulo 8: Ajuda personalizada

143

Como a ajuda personalizada funciona ..................................................................................................................... 143


Formato da ajuda personalizada ....................................................................................................................... 144
Expresses da ajuda personalizada ................................................................................................................... 144
Como a ajuda determina quais links usar ................................................................................................................ 145
Como personalizar a ajuda ....................................................................................................................................... 146
Exemplos de como usar a ajuda personalizada ........................................................................................................ 146
Exemplo: personalizar a ajuda .......................................................................................................................... 146
Exemplo: criar ajuda wiki .................................................................................................................................. 147

ndice 7

Exemplo: localizar a ajuda ................................................................................................................................. 148


Exemplo: internacionalizar a ajuda ................................................................................................................... 148

Captulo 9: Localizao do CA IdentityMinder

151

Introduction ............................................................................................................................................................. 151


Pacotes de recursos ................................................................................................................................................. 151
Exemplo de ambientes localizadas do CA IdentityMinder ....................................................................................... 154
Restries sobre o uso dos conjuntos de caracteres internacionais ........................................................................ 155
Como configurar o suporte para localizao ............................................................................................................ 156
Pr-requisitos de localizao............................................................................................................................. 157
Configurar o Agente web do CA SiteMinder ..................................................................................................... 159
Alterar o server.xml do JBoss ............................................................................................................................ 160
Configurar a varivel PATH ............................................................................................................................... 160
Como usar o exemplo de ambientes localizados .............................................................................................. 161
Como criar arquivos de localizao personalizados .......................................................................................... 163
Traduzir modelos de email ................................................................................................................................ 164
Como localizar capas de identificao visual .................................................................................................... 164
Modificar a tarefa Alterar minha conta ............................................................................................................ 164
Localizando cdigo personalizado .................................................................................................................... 165
Como exibir o CA IdentityMinder em outro idioma ................................................................................................. 165
Enable Language Switching ............................................................................................................................... 166
Definir o cabealho HTTP imlanguage em uma resposta do CA SiteMinder ............................................................ 166

Captulo 10: Regras de validao

169

Introduo s regras de validao............................................................................................................................ 169


Sobre regras de validao ........................................................................................................................................ 169
Tipos de regras de validao ............................................................................................................................. 170
Conjuntos de regras de validao ..................................................................................................................... 171
Conceitos bsicos da definio da regra de validao ...................................................................................... 172
Usando regras de validao padro ......................................................................................................................... 173
Validaes de dados padro ............................................................................................................................. 173
Regras de validao predefinidas...................................................................................................................... 175
Como implementar regras de validao personalizadas.......................................................................................... 176
Implementao de expresso regular ............................................................................................................... 176
Implementao de JavaScript ........................................................................................................................... 177
Implementao de Java .................................................................................................................................... 179
Excees ............................................................................................................................................................ 182
Como configurar regras de validao ....................................................................................................................... 184
Como configurar a validao em nvel de tarefa .............................................................................................. 185
Como configurar a validao em nvel de diretrio .......................................................................................... 185
Como iniciar a validao........................................................................................................................................... 190

8 Guia de Design do Console de Usurio

Implementaes de amostra ................................................................................................................................... 191

Apndice A: Lista de guias padro

193

Apndice B: Compilar os JSPs do CA IdentityMinder

197

ndice 9

Captulo 1: Personalizando o console de


usurio
Esta seo contm os seguintes tpicos:
Console de usurio padro (na pgina 11)
Personalizaes do console de usurio (na pgina 14)

Console de usurio padro


Quando voc cria um ambiente, o CA IdentityMinder cria um console de usurio padro
usado para gerenciar o ambiente. O console de usurio inclui um conjunto de tarefas e
funes administrativas padro.

As tarefas so aes executadas pelos usurios do CA IdentityMinder. H dois tipos


de tarefa:

Tarefas administrativas, que so usadas para gerenciar usurios, organizaes,


grupos, funes e tarefas.

Tarefas externas, que executam funes em aplicativos de negcios, como


passar os atributos de usurio para um aplicativo de gerao de relatrio

As funes administrativas associam usurios e privilgios de ao CA IdentityMinder


ou outros aplicativos. Funes so compostas de tarefas. Um usurio que tenha
uma funo pode executar suas tarefas. Os usurios podem ter vrias funes. Por
exemplo, um usurio pode ter as funes de contador e funcionrio.
As funes administrativas so compostas de tarefas administrativas.

Captulo 1: Personalizando o console de usurio 11

Console de usurio padro

As tarefas que voc v quando efetua logon no ambiente do CA IdentityMinder


dependem de suas funes administrativas. No exemplo a seguir, a usuria Jane Green
tem a funo de Gerenciador de usurios. Ela v as categorias para as tarefas
administrativas que esto disponveis para os gerenciadores de usurios.

Neste exemplo, Bill Jergen tem a funo de Gerenciador de funes. Quando ele efetua
logon no console de usurio, v um conjunto diferente de categorias que incluem as
tarefas que ele pode usar.

Observao: para obter mais informaes sobre tarefas e funes, consulte o Guia de
Administrao.

12 Guia de Design do Console de Usurio

Console de usurio padro

Tarefas, guias e telas


Uma tarefa administrativa uma funo executada pelos usurios do CA
IdentityMinder. composta de guias, que logicamente agrupam um conjunto de
campos ou funcionalidades. Por exemplo, a tarefa padro Modificar usurio inclui as
seguintes guias:

Perfil

Funes de acesso

Funes administrativas

Funes de provisionamento

Grupos

Quando os administradores usam essa tarefa, selecionam a guia apropriada para inserir
informaes de perfil, gerenciar funes ou gerenciar associaes de grupos.
Uma guia pode ser associada a vrias tarefas.
O exemplo a seguir mostra uma tarefa administrativa com vrias guias.

Guias podem ser associadas a uma tela configurvel, que determina a aparncia e o
contedo da guia. Para alterar uma guia padro, voc pode modificar a tela que est
associada guia ou criar uma tela.
Uma tela pode ser associada a vrios guias.
Mais informaes:
Lista de guias padro (na pgina 193)

Captulo 1: Personalizando o console de usurio 13

Personalizaes do console de usurio

Personalizaes do console de usurio


Em geral, aps a criao do ambiente do CA IdentityMinder, um administrador do
sistema executa algumas configuraes iniciais para garantir que o ambiente atende s
necessidades de negcios existentes. A personalizao do console de usurio tambm
melhora a usabilidade, criando tarefas para corresponder aos fluxos de trabalho do
usurio, aumenta a segurana, garantindo que os usurios possam acessar apenas os
campos necessrios, e melhora o desempenho.
possvel personalizar os seguintes elementos no console de usurio:

Navegao em tarefas Determina como os administradores acessam as tarefas e


como acessam guias diferentes nessas tarefas.

Guias e telas Controla os campos que so exibidos em uma guia e como esses
campos so exibidos.
As tarefas administrativas no console de usurio padro so criadas com base nas
informaes do arquivo de configurao do diretrio (directory.xml), que define os
objetos e atributos que o CA IdentityMinder gerencia. Por exemplo, a guia Perfil da
tarefa padro Criar usurio inclui todos os atributos que so definidos no arquivo
directory.xml para o objeto de usurio.
A maioria dos usurios precisa gerenciar apenas um subconjunto de atributos para
qualquer objeto.

Tarefas de autoatendimento Determina como as tarefas de autoatendimento,


como Senha esquecida e ID de usurio esquecida, funcionam.

Identidade visual Exibe logotipos corporativos e cores no console de usurio.

Localizao Exibe o console de usurio em vrios idiomas.

Ajuda online personalizada Permite que voc fornea ajuda online especfica
para uma tarefa ou guia que voc personalizar.

14 Guia de Design do Console de Usurio

Captulo 2: Navegao em tarefas


Esta seo contm os seguintes tpicos:
Navegao com base em tarefas (na pgina 15)
Navegao com base em objetos (na pgina 16)
Categorias de tarefas (na pgina 18)
Fluxo de tarefas (na pgina 20)

Navegao com base em tarefas


Para executar uma ao no CA IdentityMinder, selecione uma tarefa e um objeto no
qual deseja executar essa tarefa. Por exemplo, ao modificar um perfil de usurio, a
tarefa Modificar usurio e o objeto o perfil do usurio que voc deseja modificar.
O CA IdentityMinder fornece dois mtodos para selecionar tarefas e objetos:

Navegao com base em tarefas

Navegao com base em objetos

Na navegao com base em tarefas, voc seleciona uma categoria e a tarefa e, em


seguida, pesquisa o objeto ao qual a tarefa se aplica.
Por exemplo, para modificar um perfil de usurio, selecione a categoria Usurios e, em
seguida, selecione a tarefa Modificar usurio. Em seguida, possvel procurar o usurio
a ser modificado.
O exemplo a seguir ilustra as categorias e tarefas no console de usurio.

A navegao com base em tarefas o mtodo de navegao padro. Use a navegao


com base em tarefas quando for mais provvel que os usurios executem uma nica
ao em um objeto.

Captulo 2: Navegao em tarefas 15

Navegao com base em objetos

Navegao com base em objetos


A navegao com base em objetos um mtodo que permite que os usurios
selecionem um objeto e exibam todas as tarefas que podem ser executadas nesse
objeto em um menu pop-up. No menu, o usurio poder selecionar a tarefa que deseja
usar. Depois que a tarefa for concluda, os usurios podem selecionar outra tarefa no
menu pop-up, sem precisar procurar o objeto novamente.

Por exemplo, para modificar um usurio usando esse mtodo, voc seleciona a
categoria Usurios e, em seguida, a tarefa Gerenciar usurios. possvel pesquisar e
selecionar o usurio que deseja gerenciar. Nos resultados da pesquisa, clique em um
cone para exibir uma lista de tarefas que podem ser usadas para gerenciar o usurio
selecionado. Nessa lista, possvel selecionar Modificar usurio ou qualquer outra
tarefa apropriada.
O exemplo a seguir mostra um menu de tarefas pop-up.

Considere a implementao da navegao com base em objetos quando os usurios


executarem vrias aes em um nico objeto.
O CA IdentityMinder inclui as seguintes tarefas administrativas padro que so
configuradas para a navegao com base em objetos:

Gerenciar usurios

Gerenciar grupos

Gerenciar organizaes

16 Guia de Design do Console de Usurio

Navegao com base em objetos

Gerenciar funes administrativas/Gerenciar tarefas administrativas

Gerenciar funes de acesso

Gerenciar funes de provisionamento

Tambm possvel adicionar menus de tarefas pop-up para listar e pesquisar telas de
resultados para ativar a navegao com base em objetos em tarefas existentes. Por
exemplo, voc pode adicionar a navegao com base em objetos tarefa Modificar
integrantes da funo administrativa para exibir um menu de tarefas pop-up para cada
integrante da funo. Os administradores podem usar os menus de tarefas para
gerenciar os integrantes da funo sem precisar executar uma nova pesquisa para cada
integrante da funo.

Configurar a navegao com base em objetos


As tarefas que so configuradas para a navegao com base em objetos incluem apenas
uma tela de pesquisa. Os usurios procuram um objeto para gerenciar e, em seguida,
usam os menus de tarefas pop-up para exibir todas as tarefas que podem ser
executadas nesse objeto.
Quando voc configurar a navegao com base em objetos, observe o seguinte:

A ao para a tarefa administrativa na guia Perfil deve ser Pesquisar.

A tarefa administrativa no pode conter guias.

Se voc desejar configurar todas as tarefas administrativas para usar a navegao


com base em objetos, adicione os botes Criar e Excluir tela de pesquisa para
oferecer suporte a essas operaes. As aes Criar e Excluir no so suportadas no
menu de tarefas pop-up.

Para configurar a navegao em tarefas-objeto:


1.

Execute uma das seguintes etapas:

Selecione Modificar tarefa administrativa de Funes e tarefas, Tarefa


administrativa. Procure e selecione a tarefa administrativa a ser modificada.

Selecione Criar tarefa administrativa de Funes e tarefas, Tarefa


administrativa. Em seguida, selecione Criar cpia de uma tarefa administrativa
e pesquise uma tarefa a ser copiada.

Observao: para simplificar a configurao, considere a criao de uma cpia de


uma tarefa de gerenciamento existente, como Gerenciar usurios. As tarefas de
gerenciamento padro incluem as configuraes necessrias para a navegao em
tarefas-objeto.
O CA IdentityMinder exibe as guias a serem configuradas para a tarefa selecionada.
2.

Defina as configuraes para a guia Perfil, conforme necessrio. Defina a ao para


a tarefa a pesquisar.

Captulo 2: Navegao em tarefas 17

Categorias de tarefas

3.

Selecione a guia Pesquisar e clique em Procurar para configurar a tela de pesquisa


para a tarefa.
O CA IdentityMinder exibe uma lista de telas de pesquisa que podem ser aplicadas a
essa tarefa.

4.

Selecione a tela de pesquisa de que voc precisa.


Observao: para simplificar a configurao, considere a criao de uma cpia de
uma definio de tela de pesquisa de gerenciamento existente com o mesmo tipo
de objeto, como Gerenciar pesquisas de usurios. As telas de pesquisa de
gerenciamento padro esto configuradas para oferecer suporte navegao em
tarefas-objeto.

5.

Preencha os campos na tela de configurao da tela de pesquisa, conforme


necessrio.
Observao: se voc no desejar incluir tarefas separadas nos menus para a criao
de um objeto ou a excluso de vrios objetos, voc pode configurar a tela de
pesquisa para ter botes para iniciar essas tarefas. Em seguida, voc pode ocultar
essas tarefas nos menus.

Categorias de tarefas
As categorias de tarefas permitem que voc organize as tarefas para torn-las mais
fceis de localizar no console de usurio.
Voc pode especificar trs categorias de tarefas:

A Categoria a maneira mais comum de agrupar as tarefas. Normalmente, o nvel


de categoria indica o tipo de objeto ao qual a tarefa se aplica, como Usurios.

A Categoria 2 determina o nome da categoria de nvel superior. Por padro,


Tarefas.

A Categoria 3 fornece um nvel de agrupamento adicional, se necessrio. Por


exemplo, voc pode usar um nome de Categoria 3 para agrupar tarefas para
prestadores de servio.

18 Guia de Design do Console de Usurio

Categorias de tarefas

Em cada categoria, voc pode controlar a ordem em que os itens so exibidos por meio
da especificao da ordem da categoria. Por exemplo, na ilustrao a seguir, a guia
Funcionrio tem uma ordem da categoria 3.

Observao: quando uma categoria contm vrias tarefas, a ordem da categoria que
est especificada no perfil de cada tarefa deve ser a mesma. Se a ordem da categoria for
diferente, vrias instncias da guia dessa categoria sero exibidas. Por exemplo, a
categoria Funcionrio contm duas tarefas: Criar funcionrio e Modificar funcionrio. Se
a ordem da categoria na tarefa Criar funcionrio for 3 e a ordem da categoria na tarefa
Modificar funcionrio for 6, a categoria Funcionrio ser exibida como duas guias.

Desativar o cancelamento automtico de tarefa


No console de usurio, quando um usurio seleciona uma nova guia de categoria de
tarefas, o CA IdentityMinder cancela a tarefa ativa no painel de tarefas. Se o usurio
tiver feito alteraes na tarefa ativa, uma mensagem ser exibida solicitando que o
usurio confirme o cancelamento. Por exemplo, se um usurio fizer alteraes nas
informaes usando a tarefa Modificar usurio e, em seguida, tentar acessar a guia
Principal antes de enviar as alteraes de Modificar usurio, o CA IdentityMinder
informar ao usurio que a tarefa ser cancelada e solicitar a confirmao do usurio.
possvel configurar o CA IdentityMinder para permitir que os administradores
selecionem uma nova guia de categoria de tarefas sem cancelar a tarefa ativa ou exibir
uma mensagem de confirmao. Nesse caso, selecionar a nova guia de categoria exibe o
menu de tarefas para essa categoria no painel de navegao esquerdo, mas deixa a
tarefa ativa no painel de tarefas. Quando o usurio seleciona uma nova tarefa, a tarefa
ativa cancelada sem notificao.
Para alterar o comportamento padro, de forma que o CA IdentityMinder no cancele a
tarefa antes de alternar para uma nova guia, adicione uma propriedade definida pelo
usurio no Management Console.

Captulo 2: Navegao em tarefas 19

Fluxo de tarefas

Para alterar o comportamento padro:


1.

Abra o console de gerenciamento.

2.

Selecione Ambiente e, em seguida, selecione o ambiente a ser modificado.


A pgina Propriedades do ambiente exibida.

3.

Selecione Configuraes avanadas, Diversos.

4.

Digite os valores a seguir e clique em Adicionar:

Propriedade: ConsoleDisableAutoTaskCancel

Valor: verdadeiro

5.

Clique em Salvar.

6.

Reinicie o ambiente.

Fluxo de tarefas
No CA IdentityMinder, uma tarefa administrativa consiste em uma ou mais guias que
representam um agrupamento lgico de funcionalidades. Por exemplo, a tarefa
Modificar usurio pode incluir uma guia Perfil, Funes administrativas e Grupos. Fluxo
de tarefas determina como os usurios passam de uma guia para a outra usando a
tarefa administrativa.
O CA IdentityMinder fornece trs opes de fluxo de tarefas:

Guias independentes Os usurios podem usar as guias em qualquer ordem.

Assistentes Os usurios so orientados pelas guias por uma interface do


assistente.

Sequncias Os usurios preenchem uma guia na tarefa e, em seguida, o CA


IdentityMinder abre automaticamente a prxima guia.
A opo de fluxo de guias em sequncia oferece suporte a fluxos de pginas
dinmicas usando a lgica personalizada (na pgina 23).

O fluxo de tarefas determinado pelo controlador de guias. Voc especifica o


controlador de guias na guia Guias quando voc cria ou modifica uma tarefa
administrativa.

20 Guia de Design do Console de Usurio

Fluxo de tarefas

Configurar guias de tarefas independentes


As guias nas tarefas administrativas padro so independentes das outras guias na
tarefa. Os usurios podem usar as guias na tarefa em qualquer ordem. Eles no
precisam preencher cada guia antes de enviar a tarefa.
Essa configurao de guia no exemplo a seguir usa o controlador de guias padro.

Siga estas etapas:


1.

No Console do usurio, selecione uma destas opes:

Funes e tarefas.

Tarefas, Funes e Tarefas.

2.

Selecione Tarefas administrativas, Modificar tarefa administrativa.

3.

Procure e selecione a tarefa administrativa a ser modificada.


O CA IdentityMinder exibe as guias para modificar uma tarefa administrativa.

4.

Selecione a guia Guias.

5.

Selecione o Controlador de guias padro na caixa de listagem.

6.

Clique em Enviar.
O CA IdentityMinder salva as alteraes na tarefa.

Captulo 2: Navegao em tarefas 21

Fluxo de tarefas

Configurar a tarefa como assistente


Usando o Controlador de guias do assistente, voc pode definir uma tarefa como
assistente. Nessa configurao de guia, os administradores usam cada guia em uma
determinada ordem. Quando os administradores preenchem uma guia, clicam no boto
Prximo para mover para a prxima guia na lista. Uma exibio na parte superior do
assistente indica o andamento e permite que o administrador retorne s telas visitadas
anteriormente.
O exemplo a seguir mostra uma tarefa personalizada, Criar prestador de servio, exibida
como assistente.

Siga estas etapas:


1.

No Console do usurio, selecione uma destas opes:

Funes e tarefas.

Tarefas, Funes e Tarefas.

2.

Selecione Tarefas administrativas, Modificar tarefa administrativa.

3.

Procure e selecione a tarefa administrativa a ser modificada.


O CA IdentityMinder exibe as guias para configurar a tarefa selecionada.

4.

Selecione a guia Guias.

5.

Selecione o Controlador de guias do assistente na caixa de listagem.

6.

Clique em Enviar.

O CA IdentityMinder salva as alteraes na tarefa.

22 Guia de Design do Console de Usurio

Fluxo de tarefas

Configurar uma sequncia de guias


Quando uma tarefa for configurada como uma sequncia de guias, o CA IdentityMinder
exibir uma guia como uma nica pgina de cada vez. Os usurios preenchem uma guia
e, em seguida, clicam em um boto ou link personalizado para ir para a prxima guia.
A sequncia de guias e os botes e links que so exibidos so determinados de forma
programtica pelo JavaScript que voc escreveu ao configurar o controlador de guias
em sequncia.
No JavaScript personalizado, voc pode especificar a aparncia e a ordem das guias com
base nas entradas do usurio. Por exemplo, se um usurio selecionar uma opo na
primeira guia, o CA IdentityMinder exibir uma pgina. Se um usurio selecionar uma
opo diferente, uma pgina diferente ser exibida.
Para configurar o controlador de guias em sequncia:
1.

No console de usurio, selecione Funes e tarefas, Tarefa administrativa,


Modificar tarefa administrativa.

2.

Procure e selecione a tarefa administrativa a ser modificada.


O CA IdentityMinder exibe as guias para configurar a tarefa selecionada.

3.

Selecione a guia Guias.

4.

Selecione o Controlador de guias em sequncia na caixa de listagem.

5.

Clique em Enviar.

O CA IdentityMinder salva as alteraes na tarefa.

Exemplo de Javascript para controladores de guias


O CA IdentityMinder inclui exemplos de arquivos JavaScript para JavaScript para
exibio de guia e JavaScript da guia ativa.
Esses arquivos so instalados no diretrio samples\WizardSequencerScripts, onde as
ferramentas administrativas esto instaladas. As Ferramentas administrativas so
colocadas nos seguintes locais padro:

Windows: <caminho_de_instalao>\tools

UNIX: <caminho_de_instalao2>/tools

Captulo 2: Navegao em tarefas 23

Captulo 3: Configurando guias e telas de


perfil
Esta seo contm os seguintes tpicos:
Guias e telas de perfil (na pgina 25)
Personalizaes da tela de perfil (na pgina 26)
Modificar uma tela de perfil (na pgina 27)
Adicionar ou remover campos (na pgina 29)
Propriedades do campo em uma tela de perfil (na pgina 30)
Estilos de campo (na pgina 36)
Como preencher as opes de campo (na pgina 47)
Como alterar dinamicamente as propriedades de exibio do campo (na pgina 67)
Atributos lgicos definidos pela tela (na pgina 69)
Componentes adicionais em uma tela de perfil (na pgina 71)
Configurar validao em nvel de tarefa (na pgina 82)
Atributos personalizados definidos pelo usurio para funes (na pgina 83)

Guias e telas de perfil


Para a maioria das tarefas, voc inclui uma guia Perfil, que mostra os atributos do objeto
principal da tarefa. O objeto principal o objeto a ser criado, exibido ou modificado pela
tarefa. Por exemplo, na tarefa Modificar usurio, o objeto principal um usurio. A guia
Perfil inclui atributos do usurio, como ID de usurio e Sobrenome.
Quando voc configura uma guia do perfil, define as caractersticas bsicas dessa guia e
especifica uma tela do perfil. A tela do perfil a parte da guia visvel para o usurio.
Controla quais os atributos do objeto principal so exibidos na guia e suas propriedades
de exibio.
Observao: voc pode usar a mesma tela do perfil na guia Perfil de vrias tarefas.

Captulo 3: Configurando guias e telas de perfil 25

Personalizaes da tela de perfil

Ao criar uma tela do perfil, selecione os campos que se aplicam a essa tela. Os campos
podem corresponder aos atributos do perfil. Por exemplo, o valor inserido no campo ID
de usurio da tarefa Criar usurio armazenado em um atributo de perfil do usurio.

Personalizaes da tela de perfil


Uma tela de perfil composta de campos, que coletam e exibem valores de atributos.
Por exemplo, a tela de perfil para objetos de usurio contm campos como Nome,
Sobrenome e Endereo de email. Uma tela de perfil tambm pode incluir os seguintes
componentes opcionais:

Separadores de pgina

Imagens

Arquivos anexados

Campos de histrico

Texto personalizado da ajuda online

Links para tarefas aninhadas

26 Guia de Design do Console de Usurio

Modificar uma tela de perfil

Ao criar o ambiente do CA IdentityMinder, o CA IdentityMinder cria telas de perfil


padro contendo campos para todos os atributos especificados para esse objeto no
arquivo de configurao do diretrio (directory.xml). Os administradores do sistema
devem personalizar as telas de perfil padro para garantir que atendam s necessidades
de negcios e forneam o melhor desempenho do CA IdentityMinder.
Observao: para obter mais informaes sobre o desempenho do CA IdentityMinder,
consulte o Guia de Implementao.
Os administradores do sistema podem personalizar as telas de perfil padro da seguinte
maneira:

Determinando os campos que aparecem na tela de perfil

Especificando o estilo dos campos

Definindo valores de campo para caixas de listagem e outros estilos de campo

Adicionando separadores de pgina para simplificar a exibio

Adicionando imagens

Anexando arquivos

Adicionando links para outras tarefas

Adicionando texto personalizado da ajuda online

Modificar uma tela de perfil


Voc pode modificar uma tela de perfil existente para:

Adicionar ou remover campos

Alterar o layout dos campos

Editar as propriedades do campo

Adicionar o texto de ajuda criando separadores que so do tipo HTML em qualquer


lugar da tela de perfil

Para modificar uma tela de perfil:


1.

No console de usurio, selecione Funes e tarefas, Tarefa administrativa,


Modificar tarefa administrativa.

2.

Procure e selecione a tarefa administrativa a ser modificada.


O CA IdentityMinder exibe as guias a serem configuradas para a tarefa selecionada.

3.

Selecione a guia Guias e, em seguida, selecione a guia Perfil.

4.

Clique em Procurar ao lado do campo Tela.


O CA IdentityMinder exibe uma lista das telas de perfil existentes.

Captulo 3: Configurando guias e telas de perfil 27

Modificar uma tela de perfil

5.

Selecione a tela de perfil que deseja modificar ou copiar e, em seguida, clique em


um dos seguintes botes:

Selecionar
Adiciona a tela selecionada guia que voc est configurando.

Editar
Abre uma nova tela em que voc pode alterar as configuraes, incluindo
campos, propriedades do campo e layout da tela selecionada.

Excluir
Exclui a tela selecionada.

Novo
Abre uma nova tela em que voc pode criar uma tela. A nova tela no inclui
campos padro.

Copiar
Cria uma tela utilizando as configuraes de uma tela existente. Para criar uma
tela com base em uma tela existente, voc adiciona um novo nome e tag tela
e modifica as configuraes, conforme necessrio.

Cancelar
Retorna tela de configurao de guia.

Se voc selecionou Editar, Novo ou Copiar, o CA IdentityMinder abrir uma nova


tela em que voc pode criar ou modificar uma tela de perfil.

28 Guia de Design do Console de Usurio

Adicionar ou remover campos

Adicionar ou remover campos


As telas de perfil padro incluem todos os atributos para o objeto na ordem usada na
configurao do diretrio (directory.xml). Voc pode adicionar ou remover campos ou
reorganizar a ordem dos campos usando os controles na parte inferior da lista de
atributos na definio da tela de perfil.

Para adicionar, remover ou reorganizar os campos:


1.

Modifique uma tela de perfil (na pgina 27).

2.

Selecione os campos que deseja modificar e, em seguida, selecione a ao a ser


executada.
Observao: ao editar as propriedades do campo na tela de perfil, talvez voc ache
mais fcil manipular as linhas de vrios campos da seguinte maneira:

3.

a.

Clique em Dividir cada linha selecionada em linhas separadas para colocar os


campos em linhas separadas.

b.

Manipule os campos em linhas separadas.

c.

Clique em Combinar as linhas adjacentes marcadas em uma para retornar os


campos para uma nica linha.

Se voc selecionar uma ao que exija um valor, selecione um valor, conforme


necessrio.
Por exemplo, se voc deseja mover as linhas selecionadas trs linhas acima,
selecione 3 na caixa de listagem em Nmero de posies para cima para mover as
linhas selecionadas.

Captulo 3: Configurando guias e telas de perfil 29

Propriedades do campo em uma tela de perfil

4.

Clique em Visualizar para exibir as alteraes feitas.


O CA IdentityMinder ir abrir uma nova janela e exibir as alteraes feitas.

5.

Clique em OK e, em seguida, clique em Selecionar para retornar tarefa Modificar


tarefa administrativa.

Propriedades do campo em uma tela de perfil


Voc deve selecionar um campo para editar suas propriedades. Cada estilo de campo
tem propriedades diferentes, que definem a exibio, as permisses e os padres para
essa propriedade.
Observao: a opo que voc selecionar no campo Estilo determina as propriedades
que so exibidas na tela Propriedades do campo. Talvez voc no veja todas as
propriedades descritas nesta lista.
Voc pode definir as seguintes propriedades (em ordem alfabtica) para um campo:

Nome do atributo
Especifica o nome do atributo do objeto.

Rtulo de valores disponveis


Define o texto que aparece acima da caixa de listagem, que contm os itens que
esto disponveis para seleo no seletor de opes.

Valor verificado
Especifica o valor de um campo quando a caixa de seleo estiver marcada. Por
exemplo, o valor verificado para o campo Ativado verdadeiro.
O valor padro verdadeiro.
Observao: esse campo fica visvel quando o estilo da caixa de seleo estiver
selecionado.

Colunas
Especifica a largura em caracteres para a rea do texto.
Observao: esse campo fica disponvel somente quando voc seleciona o estilo
rea do texto.

30 Guia de Design do Console de Usurio

Propriedades do campo em uma tela de perfil

Classe de CSS
Especifica a classe de folha de estilos em cascata que controla a apresentao deste
campo.

Estilo de CSS
Especifica as regras de folha de estilos em cascata que controlam a apresentao
deste campo.
Voc pode usar este campo para definir a largura de um campo. Por exemplo, para
definir a largura de um campo com o estilo Lista suspensa a 300 pixels, especifique
o texto a seguir no campo Estilo de CSS:

Observao: por padro, a largura dos campos que incluem uma lista de valores,
como uma lista suspensa ou uma caixa de seleo mltipla, definida como
automtica ({width:auto}). Essa configurao dimensiona o campo para acomodar o
maior valor no campo. Por exemplo, se o maior valor do campo do seletor de
opes de Cidade for So Francisco, a lista de opes ser dimensionada para exibir
o valor inteiro.
Voc tambm pode usar o campo Estilo de CSS para controlar outras propriedades
de exibio, como tamanho do texto e cor do plano de fundo.

Rtulo de valores atuais


Define o texto que aparece acima da caixa de listagem que contm os itens
selecionados no seletor de objetos.

Padro de exibio de data


Determina o formato de datas exibidas em um campo e no controle do Seletor de
data.

Padro de repositrio de datas


Determina como o CA IdentityMinder armazena datas em repositrios de usurios.

Captulo 3: Configurando guias e telas de perfil 31

Propriedades do campo em uma tela de perfil

Padro
Indica o valor exibido por padro e armazenado no perfil caso nenhum outro valor
tenha sido fornecido.
Para uma caixa de seleo, digite verdadeiro para ativar o padro; digite falso para
desativar o padro.
Observao: os valores padro se aplicam apenas a tarefas de criao. Se voc
definir um valor padro para um campo que est sendo usado em uma tarefa de
modificao ou exibio, o valor padro no ser exibido na tela.

JavaScript padro
Permite que voc use o JavaScript para definir o valor padro para um campo.
Usando JavaScript, possvel definir o valor de forma dinmica. Por exemplo, voc
pode definir um valor padro com base em outros atributos.
Use esse campo apenas para tarefas de criao.

Desativar preenchimento automtico


Desativa o recurso de preenchimento automtico no Internet Explorer. Se essa
caixa de seleo for marcada, o Internet Explorer no tentar fornecer sugestes
para os valores de campo com base em entradas anteriores.
Para obter mais informaes sobre o recurso de preenchimento automtico,
consulte a documentao do Internet Explorer.

JavaScript de inicializao
Permite que voc use o JavaScript para definir o valor padro para um campo. Use
esse campo para qualquer tipo de tarefa.

Observao: o JavaScript nesse campo executado aps o JavaScript no campo


JavaScript padro para tarefas de criao.

Abrangncia do campo
Especifica o nmero de colunas que o campo abrange (excluindo o rtulo).

Campo com o qual fazer correspondncia


Especifica o campo que o CA IdentityMinder verifica para encontrar um valor
correspondente. Voc pode usar esse recurso para verificar se o valor de dois
campos em uma tela correspondem. Esse campo geralmente usado para verificar
se uma senha ou outras informaes importantes foram inseridas corretamente.
Por exemplo, uma tela de perfil pode incluir os campos Senha e Confirmar senha.
No campo Confirmar senha, o valor do Campo com o qual fazer correspondncia
seria o campo Senha.
Observao: o CA IdentityMinder usa um atributo lgico definido pela tela para
verificar se o valor de dois campos em uma tela correspondem. Para que o Campo
com o qual fazer correspondncia seja exibido, o campo Nome do atributo deve ser
definido como (Atributo lgico na tela).

32 Guia de Design do Console de Usurio

Propriedades do campo em uma tela de perfil

Rtulo direita
Especifica o texto que exibido direita do campo. Voc pode usar o campo Rtulo
direita para fornecer uma descrio ou um texto de ajuda para os campos em
uma tela de perfil.

Abrangncia do rtulo
Especifica o nmero de colunas que o rtulo abrange.

Tamanho mximo
Define o nmero mximo de caracteres que podem ser inseridos para esse campo.

Nome
Especifica o rtulo desejado para esse atributo na tela.

Permisso
Determina o nvel de privilgio do campo.
Observao: se um campo for obrigatrio, escolha uma configurao Obrigatrio.
Os campos obrigatrios so indicados por um ponto na tela.

Leitura
Um administrador pode exibir, mas no modificar o campo.

Leitura/gravao
Um administrador pode ver o valor atual do campo (se houver) e digitar um
valor para o campo.

Leitura/gravao obrigatria
O campo obrigatrio, mas caso contrrio, funciona como a configurao de
Leitura/gravao.

Gravao
Um administrador no pode ver o valor atual do campo (se houver), mas pode
digitar um valor.
Por exemplo, um administrador pode alterar a senha de um usurio, mas no
pode exibir a senha atual do usurio.

Gravar uma vez


Um valor pode ser inserido uma vez, mas no modificado.
Por exemplo, um administrador pode especificar uma organizao quando um
usurio criado, mas no pode modificar essa organizao mais tarde.

Gravao obrigatria
Um campo obrigatrio, mas caso contrrio, funciona como a configurao de
Gravar.

Captulo 3: Configurando guias e telas de perfil 33

Propriedades do campo em uma tela de perfil

Preservar itens que no so opes


Controla se o CA IdentityMinder preserva os valores existentes para um atributo, se
esses valores no forem vlidos. Por exemplo, um campo Estado inclui as opes
Massachusetts e Nova York. No entanto, um usurio existente da Califrnia. Se
essa opo for selecionada, o CA IdentityMinder exibir Califrnia como se fosse
uma opo vlida para esse usurio. Se essa opo no for selecionada, o CA
IdentityMinder exibir a primeira opo na lista (Massachusetts). Se o campo no
for necessrio, o valor fica em branco.

Padro
O CA IdentityMinder fora o usurio a selecionar apenas as opes vlidas.

Linhas
Especifica o nmero de linhas que uma rea do texto para entradas do usurio deve
incluir.
Por exemplo, voc pode definir uma rea do texto para o campo Descrio, que
permite que os usurios insiram quatro linhas de texto.
Observao: esse campo fica disponvel somente quando voc seleciona o estilo
rea do texto.

Mostrar seletor de hora


Exibe um controle de calendrio que os usurios podem usar para selecionar uma
data e hora.

Tamanho
Especifica o tamanho do campo. Digite um nmero com base no estilo do campo.
Para texto e senha, digite o nmero de caracteres. Para lista suspensa, de seleo,
de seleo mltipla e multitexto, digite o nmero de linhas.

Origem das opes de seleo


Especifica como um campo que contm vrias opes preenchido.

Nenhum
O CA IdentityMinder no usa uma origem externa para as opes de seleo.

Dados da caixa de seleo


Especifica que o CA IdentityMinder preenche as opes no campo com dados
da caixa de seleo (na pgina 51).

Lista simples
Permite inserir uma lista de opes em uma caixa de texto. Se voc selecionar
essa opo, os seguintes campos so exibidos:
Opes de seleo
Digite as opes em linhas separadas. Se a opo tiver valores de exibio
e repositrio separados, digite-os assim: "valor-de-repositrio;
valor-de-exibio".

34 Guia de Design do Console de Usurio

Propriedades do campo em uma tela de perfil

Depende do valor de outro campo


Especifica que o CA IdentityMinder preenche as opes no campo com base
nas opes de outro campo na tela de tarefa. O outro campo tambm deve ser
preenchido com dados da caixa de seleo, ou tambm depender do valor de
outro campo.
A dependncia de outro campo definida na configurao dos dados da caixa
de seleo.

JavaScript
Especifica o JavaScript que contm as opes para o campo. Se voc selecionar
essa opo, os seguintes campos so exibidos:
Opes de seleo (JavaScript)
Esse JavaScript deve conter uma funo com a assinatura "function
getOptions (FieldContext)" e retornar uma sequncia de caracteres de
opes delimitada por pipe. Se a opo tiver valores de exibio e
repositrio separados, eles devem ser separados por um ponto-e-vrgula
(;).

Estilo
Determina a apresentao do campo.
As opes de estilo (na pgina 36) listam os estilos que voc pode selecionar para
um campo.

Texto da dica
Especifica o texto que descreve um campo. O texto exibido na tela ao lado do
campo ao qual se aplica.

Valor desmarcado
Especifica o valor de um campo quando a caixa de seleo estiver desmarcada. Por
exemplo, o valor desmarcado para o campo Ativado falso.
O valor padro falso.
Observao: esse campo fica visvel quando o estilo da caixa de seleo estiver
selecionado.

Permitir outros valores desmarcados


Quando essa opo est desmarcada, define o valor do atributo como falso no
repositrio de usurios se o atributo estiver em branco. Quando essa opo
est marcada, o CA IdentityMinder permite que o atributo seja deixado em
branco.
Use esse campo para definir automaticamente atributos em branco como
falsos no repositrio de usurios.

Expresso de validao
Contm uma expresso regular que executa a validao em nvel de tarefa.

Captulo 3: Configurando guias e telas de perfil 35

Estilos de campo

Classe de validao do Java


Contm o nome totalmente qualificado de uma classe do Java que executa a
validao, por exemplo:
com.mycompany.MyJavaValidator
O CA IdentityMinder espera que o arquivo da classe esteja localizado no diretrio
raiz designado para arquivos de classe Java personalizados.

JavaScript de validao
Contm o cdigo JavaScript completo que executa a validao.
Voc tambm pode usar esse campo para especificar o cdigo JavaScript que
dinamicamente oculta/mostra e ativa/desativa determinados campos com base nos
valores atuais de outros campos.
Observao: voc deve fornecer o cdigo JavaScript nesse campo. Com a validao
em nvel de tarefa, voc no pode fazer referncia a um arquivo que contm o
cdigo JavaScript.

Estilos de campo
O campo Estilo permite especificar o modo como um campo exibido em uma tela de
perfil. possvel selecionar os seguintes estilos:
Observao: a lista de estilos que esto disponveis no campo Estilo depende do tipo de
campo que voc est configurando. Talvez algumas dessas opes no apaream no
campo Estilo para o tipo de campo que voc est definindo.

Caixa de seleo
Adiciona uma caixa de seleo ao lado do nome do campo, que ativa ou desativa
uma configurao. Por exemplo, use uma caixa de seleo para o campo Ativar
usurio. Se a caixa de seleo estiver marcada, a conta do usurio ser ativada. Se a
caixa de seleo estiver desmarcada, a conta do usurio ser desativada.

Seleo mltipla de caixa de seleo


Adiciona uma caixa de seleo ao lado de cada opo em um campo. Os usurios
podem selecionar vrias opes na lista de opes.
Use esse campo apenas para atributos com vrios valores.

Seletor de data (na pgina 38)


Exibe um cone de calendrio ao lado de um campo de data, como Data de incio.
Os administradores clicam no cone de calendrio para exibir um controle de
calendrio onde possvel selecionar a data desejada.

36 Guia de Design do Console de Usurio

Estilos de campo

Lista suspensa
Permite que o usurio selecione um valor para o campo. Apenas um valor fica
visvel. Os usurios clicam em uma seta para ver outros valores na lista.
O usurio pode selecionar um nico valor na lista.

Caixa suspensa
Fornece a mesma opo de valores exibida por um estilo Lista suspensa, mas
adiciona uma caixa de texto onde o usurio pode inserir um novo valor.

Seletor de grupo
Exibe um controle para a seleo de um grupo.

Oculto
Recupera o valor do campo do objeto, mas o rtulo e o valor do campo no so
exibidos na tela de tarefa.

Seleo mltipla
Exibe uma lista de valores para um campo.
Em uma caixa de seleo mltipla, os possveis valores para o campo ficam visveis
na caixa de listagem. Os usurios podem selecionar vrios valores na lista.
Use apenas com atributos com vrios valores.

Multitexto
Permite que o usurio insira vrios valores em uma caixa de texto.
Use apenas com atributos com vrios valores.

Seletor de objetos
Exibe um controle para a seleo de um objeto gerenciado.
Esse estilo geralmente usado nas telas de gerenciamento de contas.
Use apenas com atributos com vrios valores.

Seletor de opes
Exibe duas caixas de listagem, que mostram os valores atuais e disponveis para o
campo. O usurio clica nos botes para adicionar ou remover os valores atuais.
Use apenas com atributos com vrios valores.

Combinao do seletor de opes


Exibe as duas caixas de listagem usadas para um estilo Seletor de opes, alm de
uma caixa de texto onde o usurio pode inserir um novo valor.
Use apenas com atributos com vrios valores.

Seletor de organizao
Exibe um controle para a seleo de uma organizao.

Captulo 3: Configurando guias e telas de perfil 37

Estilos de campo

Senha
Exibe o valor do campo como uma srie de asteriscos. Por exemplo, a senha secreta
exibida como ******.

Boto de opo de seleo nica


Exibe uma lista de valores para um campo. Um boto de opo aparece ao lado de
cada valor.

Sequncia
Exibe o valor do campo como somente leitura. Se no houver nenhum valor, o
campo ficar em branco.

Texto
Exibe uma caixa onde o usurio pode inserir um valor para o campo.
Se a permisso do campo for somente leitura, o valor ser exibido como um rtulo.

rea do texto
Exibe uma caixa onde o usurio pode inserir valores que so maiores do que um
campo de texto. Por exemplo, uma descrio pode exigir uma rea do texto.

Seletor de usurio
Exibe um controle para a seleo de um usurio.

Observao: voc pode especificar valores, chamados de opes nos menus suspensos,
caixas suspensas, caixas de seleo mltipla, seletor de opes, combinaes do seletor
de opes e caixas de seleo nica. Os usurios podem selecionar uma ou mais opes
para preencher o valor de um campo. Como preencher opes de campo (na pgina 47)
fornece informaes sobre os mtodos que voc pode usar para especificar as opes
de campo.

Opes do Seletor de data


O estilo Seletor de data permite adicionar um cone de calendrio a um campo em uma
tela de perfil. Os usurios podem clicar no cone para abrir um calendrio que pode ser
usado para selecionar uma data. A data selecionada armazenada no atributo do perfil
que est associado ao campo. Por exemplo, possvel adicionar o controle de
calendrio a um campo Data de incio na guia Perfil para uma tarefa Criar prestador de
servio. Quando um administrador seleciona o primeiro dia do contrato, o CA
IdentityMinder armazena essa data no perfil do usurio.

38 Guia de Design do Console de Usurio

Estilos de campo

O estilo Seletor de data tem as seguintes definies de configurao:

Padro de exibio de data (opcional)


Determina o formato de datas exibidas em um campo e no controle do Seletor de
data. Especifique o padro de exibio de data usando convenes Java. Por
exemplo, a seguinte expresso Java exibida como out de 2011:
MMM de aaaa
O campo Padro de exibio de data exibido apenas quando o estilo Seletor de
data selecionado.
Observe o seguinte ao especificar padres de exibio de datas:

O controle do Seletor de data suporta um subconjunto dos formatos de data


Java.
A lista completa de formatos de data Java exibida na documentao do Java
2 Platform Std. Ed. v1.4.2 no site da Oracle
(http://java.sun.com/j2se/1.4.2/docs). Pesquisar SimpleDateFormat.
Os seguintes formatos, que so suportadas no SimpleDateFormat, no so
suportados pelo controle do Seletor de data no CA IdentityMinder:

Smbolo

Significado

Tipo

Exemplo

Era

Texto

"GG" -> "AD"

Dia do ano (1 a 365 ou 1 a


364)

Nmero

"D" -> "65"

Semana do ms (1 a 5)

Nmero

"W" -> "3"

Hora (1 a 24)

Nmero

"k" -> "3"

"D" ->"065"

"kk" ->"03"
K

Hora (0 a 11 AM/PM)

Nmero

"K" -> "15"


"KK"->"15"

Milissegundo (0 e 999)

Nmero

"SSS" -> "007"

No recomendamos especificar um padro de exibio de data se o ambiente


oferecer suporte a vrias localidades. Se um padro de exibio no for
especificado, a data exibida no formato apropriado para a localidade do usurio.

Padro de repositrio de datas


Determina como a data armazenada no repositrio de usurios. Especifique o
padro de data usando convenes Java. (Consulte a descrio do Padro de
exibio de data para obter mais informaes.)

Captulo 3: Configurando guias e telas de perfil 39

Estilos de campo

Texto da dica
Especifica o texto que aparece ao lado do seletor de data na tela de perfil.
Voc pode usar esse campo para fornecer informaes adicionais sobre o controle
do seletor de data.

Mostrar seletor de hora


Permite que os usurios especifiquem a hora, alm da data, ao usar um controle de
calendrio em uma tela de perfil. A hora armazenada no repositrio de usurios.

Ocultar segundos
Oculta a exibio dos segundos no controle do seletor de hora.

Observao: os campos Padro de repositrio de datas, Mostrar seletor de hora e


Formato do seletor de hora so exibidos somente quando o atributo selecionado no
tiver o tipo de valor Date, ISODate ou UnicenterDate no arquivo de configurao do
diretrio (directory.xml). Para obter mais informaes sobre os tipos de valor, consulte
o Guia de Configurao.

40 Guia de Design do Console de Usurio

Estilos de campo

Opes do Seletor de objetos


O estilo Seletor de objetos permite que os administradores adicionem a funcionalidade
de pesquisa a um campo em uma tela de perfil. Os usurios podem usar essa
funcionalidade para pesquisar e selecionar um objeto a ser associado ao atributo
descrito no perfil. Por exemplo, um administrador pode adicionar um seletor de objetos
ao campo Gerente para permitir que os usurios pesquisem um gerente para um novo
usurio em uma tarefa Criar usurio. Quando o usurio seleciona um gerente e envia a
tarefa Criar usurio, o CA IdentityMinder armazena informaes sobre esse gerente no
perfil do novo usurio.

Na maioria dos casos, a pesquisa do seletor de objetos permite que os usurios


selecionem e armazenem um nico valor. No entanto, os administradores tambm
podem configurar o seletor de objetos para permitir que os usurios pesquisem e
selecionem vrios valores. Nesse caso, os valores selecionados so armazenados em um
atributo com vrios valores no objeto.

Configurar um Seletor de objetos


O estilo Seletor de objetos adiciona um boto Procurar a um campo. Os usurios podem
clicar no boto para pesquisar e selecionar um objeto para preencher o campo.
O seletor de objetos pode ser aplicado aos campos para atributos de valor nico ou com
vrios valores.
Para configurar um Seletor de objetos
1.

Edite a definio da tela de perfil (na pgina 27).

2.

Adicione outro campo tela de perfil usando os controles abaixo da lista de


campos.

3.

Clique no cone em forma de seta para a direita para abrir a caixa de dilogo
Propriedades do campo do atributo que estiver adicionando.

Captulo 3: Configurando guias e telas de perfil 41

Estilos de campo

4.

Especifique os valores para os seguintes campos:


Nome do atributo
Selecione o atributo associado ao campo.
Por exemplo, se estiver configurando o campo que especifica o gerente de um
usurio, selecione o atributo no repositrio de usurios que armazena essas
informaes.
Observao: se estiver configurando um campo para um atributo que
armazena vrios valores, certifique-se de que o atributo est definido como
com vrios valores no arquivo de configurao do diretrio (directory.xml).
Consulte o Guia de Configurao para obter mais informaes.
Estilo
Selecione o estilo Seletor de objetos.
Tipo de objeto
Especifique o tipo de objeto que o usurio pesquisar. Por exemplo, se estiver
configurando um seletor de objetos para o campo Gerente, selecione o tipo de
objeto Usurios.
Restringir a um nico valor
Permite que os administradores selecionem apenas um nico valor ao procurar
um objeto.
Observao: essa opo est disponvel somente quando voc especifica um
atributo com vrios valores no campo Nome do atributo.
Exibir atributo
Selecione o atributo do objeto selecionado que exibido quando o valor
selecionado.
No exemplo do Gerente, selecione Nome completo ou ID de usurio para que
os usurios possam identificar facilmente o gerente.
Observao: o identificador exclusivo do objeto ser armazenado no atributo.
Tela de pesquisa
Selecione a tela de pesquisa que os administradores usam para pesquisar o
objeto.
Tamanho
Especifica o nmero de itens que sero exibidos na caixa de listagem.
Observao: esse campo fica disponvel somente quando voc especifica um
atributo com vrios valores no campo Nome do atributo.
Padro
Selecione o objeto padro que o CA IdentityMinder usa quando nenhum outro
objeto est selecionado.

42 Guia de Design do Console de Usurio

Estilos de campo

5.

Clique em Aplicar e, em seguida, clique em OK para retornar pgina Selecionar


definio de tela.
O CA IdentityMinder adiciona o seletor de objetos ao campo que voc editou.

6.

Selecione a guia que voc editou e clique em OK.


O CA IdentityMinder salva as alteraes na tela.

Exibio de atributo estruturado


Um atributo estruturado permite que um nico valor de atributo armazene vrios
valores relacionados por exemplo, um atributo estruturado pode conter o nome, o
sobrenome e o endereo de email de um usurio em um nico valor. Esses tipos de
atributo so usados por determinados tipos de terminal, mas podem ser gerenciados no
CA IdentityMinder.
possvel configurar o CA IdentityMinder para exibir os valores em um atributo
estruturado em forma de tabela, que pode ser editada pelos usurios. Nesse caso, as
alteraes feitas nos valores do atributo so armazenadas no repositrio de usurios e
propagadas de volta para a conta do terminal (se a sincronizao estiver ativada).

Pr-requisitos para o suporte ao atributo estruturado


Para adicionar suporte ao atributo estruturado no console de usurio, a definio do
atributo estruturado no arquivo de configurao do diretrio (directory.xml) deve incluir
os seguintes parmetros:

multivalued="true"
O atributo deve ser um atributo com vrios valores padro no repositrio de
usurios.

displayhint="value1;value2;valueN"
O parmetro displayhint deve conter uma lista de campos disponveis no valor de
atributo, separados por um ponto-e-vrgula (;).

valuetype="structured"
O parmetro valuetype deve ser definido como "structured" para configurar uma
tabela de exibio no console de usurio. Se esse parmetro no for definido
corretamente, os campos necessrios para configurar a tabela de exibio no
sero exibidos.

Captulo 3: Configurando guias e telas de perfil 43

Estilos de campo

Uma descrio de atributo completa para um atributo estruturado deve se parecer com
o seguinte:
<ImsManagedObjectAttr physicalname="emailaddress" required="false"
searchable="false" multivalued="true" displayhint="email;type;primary"
valuetype="structured">
Observao: para obter mais informaes sobre como configurar o arquivo
directory.xml, consulte o Guia de Configurao.

Configurar uma exibio de atributo estruturado


Para permitir que os usurios adicionem ou modifiquem os valores em um atributo
estruturado, voc pode adicionar uma exibio de atributo estruturado a uma tela de
perfil. Essa exibio normalmente usada em modelos de conta para os tipos de
terminal que oferecem suporte a atributos estruturados.
Para configurar uma exibio de atributo estruturado:
1.

Configure os pr-requisitos (na pgina 43) para suporte ao atributo estruturado.

2.

Edite uma tela de perfil (na pgina 27).

3.

Adicione outro campo tela de perfil usando os controles abaixo da lista de


campos.

4.

Clique no cone em forma de seta para a direita para abrir a caixa de dilogo
Propriedades do campo para o campo que estiver adicionando.

5.

Selecione um atributo estruturado na lista de atributos disponveis no campo Nome


do atributo.
Observao: o atributo que voc selecionar dever ter o tipo de valor estruturado
no arquivo de configurao do diretrio (directory.xml).

6.

Selecione Item estruturado em aninhamento no campo Estilo.


Os campos na tela Propriedades do campo mudam de acordo com o estilo
selecionado.

7.

Adicione campos tabela de exibio, clicando no cone em forma de seta para a


direita e selecionando um valor na caixa de listagem.
Os valores que aparecem nessa lista so os valores que esto disponveis no
atributo estruturado, conforme definido no arquivo de configurao do diretrio
(na pgina 43) (directory.xml).
Quando voc selecionar um valor, o CA IdentityMinder adicionar esse valor
tabela de exibio e permitir que voc configure as propriedades para esse valor.

44 Guia de Design do Console de Usurio

Estilos de campo

8.

Especifique os campos a seguir para o valor na configurao da tabela de exibio:


Nome
Especifica o rtulo do campo.
Estilo
Especifica as propriedades de exibio do campo. possvel selecionar uma das
seguintes opes de estilo:

Caixa de seleo
Adiciona uma caixa de seleo ao lado do nome do campo, que ativa ou
desativa uma configurao.

Data
Exibe uma caixa de texto onde os administradores podem inserir uma
data.
O CA IdentityMinder valida o formato de data.

Lista suspensa
Permite que o usurio selecione um valor para o campo. Apenas um valor
fica visvel. Os usurios clicam em uma seta para ver outros valores na
lista.
O usurio pode selecionar um nico valor na lista.

Caixa suspensa
Fornece a mesma opo de valores exibida por um estilo Lista suspensa,
mas adiciona uma caixa de texto onde o usurio pode inserir um novo
valor.

Seletor de objetos
Permite adicionar uma tela de pesquisa para selecionar um objeto
gerenciado.

Boto de opo
Exibe uma lista de valores para um campo. Um boto de opo aparece ao
lado de cada valor. Os usurios podem selecionar um nico valor na lista.

Captulo 3: Configurando guias e telas de perfil 45

Estilos de campo

Sequncia
Exibe o valor do campo como somente leitura. Se no houver nenhum
valor, o campo ficar em branco.

Estruturado
Exibe um boto Adicionar que adiciona um novo valor tabela de atributo
aninhada e composta.

Texto
Exibe uma caixa onde o usurio pode inserir um valor para o campo.
Se a permisso do campo for somente leitura, o valor ser exibido como
um rtulo.

Classificvel
Determina se os usurios podem classificar a tabela de exibio de acordo
com o campo selecionado.
9.

Marque a caixa de seleo Permitir reordenar valores para permitir que


administradores reordenem a lista de atributos estruturados na exibio da tela de
perfil.
Quando marcada, essa opo adiciona setas para cima e para baixo ltima coluna
da exibio de atributo estruturado.

10. Adicione suporte para a adio de informaes de outros objetos gerenciados (na
pgina 46) em um atributo estruturado, se necessrio.
Observao: a configurao de suporte a outros objetos gerenciados adiciona uma
tela de pesquisa tabela de exibio de atributo estruturado que permite aos
usurios procurar e adicionar informaes armazenadas em outros tipos de objeto
gerenciado. Por exemplo, voc pode permitir que os usurios selecionem funes
SAP para adicionar a um atributo estruturado em um perfil de usurio.
11. Clique em Aplicar e em OK.
A exibio de atributo estruturado adicionada tela de perfil editada por voc.

Adicionar outros objetos gerenciados em uma exibio de atributo estruturado


Em alguns casos, voc pode adicionar outros objetos gerenciados a um atributo
estruturado. Por exemplo, voc pode ter um atributo estruturado em um perfil de
usurio que lista as funes SAP e uma data de incio e de trmino em que os usurios
podem usar essas funes.
Para configurar o suporte para esse caso de uso, possvel adicionar uma tabela de
exibio de atributo estruturado, conforme descrito em Configurar uma exibio de
atributo estruturado (na pgina 44) e, em seguida, configurar campos adicionais que
permitem pesquisar e armazenar informaes sobre um outro tipo de objeto
gerenciado no atributo estruturado.

46 Guia de Design do Console de Usurio

Como preencher as opes de campo

Quando esse suporte for configurado, o CA IdentityMinder exibir uma tela de pesquisa
que permite aos usurios procurar e selecionar valores de um objeto gerenciado para
adicionar ao atributo estruturado.
Para adicionar objetos gerenciados a uma exibio de atributo estruturado:
1.

Configure uma exibio de atributo estruturado (na pgina 44).

2.

Especifique os seguintes campos, conforme necessrio:


Campo de objeto
Selecione o campo que contm a referncia ao objeto gerenciado. Na maioria
dos casos, esse o identificador exclusivo para o objeto gerenciado.
Tipo de objeto
Selecione o tipo de objeto que contm os valores a serem adicionados ao
atributo estruturado.
Por exemplo, para adicionar funes SAP a um atributo estruturado no perfil de
usurio, selecione o objeto de funes SAP.
Atributo do objeto (opcional)
Selecione o atributo do objeto gerenciado que ser usado para preencher o
Campo de objeto.
Esse atributo s necessrio se o campo que contm a referncia ao objeto
gerenciado no for o nome exclusivo para o objeto gerenciado. Se nenhum
valor for fornecido para esse campo, o nome exclusivo usado.
Tela de pesquisa
Especifique a tela de pesquisa que os usurios vero ao clicar no boto
Adicionar para adicionar mais valores ao atributo estruturado.

3.

Clique em Aplicar e em OK.

Como preencher as opes de campo


H vrios estilos de campo que permitem fornecer as opes para que os usurios
escolham:

Seleo mltipla de caixa de seleo

Lista suspensa

Caixa suspensa

Seleo mltipla

Seletor de opes

Combinao do seletor de opes

Captulo 3: Configurando guias e telas de perfil 47

Como preencher as opes de campo

Boto de opo de seleo nica

Seleo nica

Por exemplo, o campo Escritrio pode conter a lista de todos os escritrios que uma
empresa possui. Os usurios podem selecionar o escritrio onde trabalham para
preencher o campo.
O CA IdentityMinder oferece os seguintes mtodos para preencher as opes:
Lista simples
Permite inserir uma lista de opes em uma caixa de texto. O CA IdentityMinder
usa o texto que voc digitar como as opes para o campo.
Dados da caixa de seleo
Permite configurar opes de campo usando dados da caixa de seleo.
JavaScript
Permite especificar o JavaScript que fornece as opes para o campo.
Manipuladores de atributos lgicos
Permite especificar um manipulador de atributos lgicos para fornecer opes de
campo.
Mais informaes:
Dados da caixa de seleo (na pgina 51)

Como selecionar um mtodo de preenchimento de campo


O CA IdentityMinder fornece quatro mtodos para preencher as opes de campo:

Listas simples

Dados da caixa de seleo

JavaScript

Manipulador de atributos lgicos

Ao selecionar um mtodo, considere os seguintes critrios:

Facilidade de implementao
Alguns mtodos permitem configurar opes de campo na caixa de dilogo de
propriedades do campo quando voc configura uma tela de perfil. Outras opes
exigem configurao adicional ou cdigo personalizado.

48 Guia de Design do Console de Usurio

Como preencher as opes de campo

Suporte a opes dinmicas


Determinados mtodos permitem escrever um cdigo personalizado para
preencher dinamicamente as opes de campo ou para recuperar opes de campo
de outra origem, como, por exemplo, um banco de dados.

Suporte a campos dependentes


Determinados mtodos permitem configurar uma dependncia entre dois campos
em uma tela de tarefa. Por exemplo, as opes disponveis no campo Cidade
podem depender de uma opo que o usurio seleciona no campo Estado.

A tabela a seguir resume as caractersticas de cada mtodo de preenchimento de


campo.
Mtodo

Descrio

Dinmico?

Oferece suporte a
campos
dependentes?

Listas simples

Os administradores digitam opes


estticas na caixa de dilogo de
propriedades do campo.

No

No

Dados da caixa de seleo

Uma lista esttica de opes


importada para um banco de dados a
partir de um arquivo XML, que pode ser
gerado dinamicamente.

Sim. As opes
em campos
dependentes
podem ser
alteradas, com
base nos valores
selecionados.

Sim, apenas para


campos hierrquicos

JavaScript

Uma funo JavaScript fornece uma lista Sim


dinmica de opes. O JavaScript
configurado na caixa de dilogo de
propriedades do campo. Esse JavaScript
do lado do servidor pode acessar
qualquer API do Java disponvel no
servidor de aplicativos que hospeda o
CA IdentityMinder.

No

Manipulador de atributos
lgicos

Um manipulador de atributos lgicos do Sim


Java personalizado fornece uma lista
dinmica de opes. Um administrador
grava o manipulador de atributos lgicos
usando a API de atributos lgicos do CA
IdentityMinder e, em seguida, configura
o ambiente do CA IdentityMinder para
usar o manipulador de atributos lgicos.
Em seguida, o administrador associa o
campo ao atributo lgico.

No

Captulo 3: Configurando guias e telas de perfil 49

Como preencher as opes de campo

Usar listas simples para opes de campo


Voc pode especificar uma lista esttica de opes para campos em uma tela de perfil
usando o estilo de opo de seleo Lista simples. Quando os usurios selecionam uma
ou mais das opes (de acordo com o estilo do campo), o CA IdentityMinder armazena
esse valor no repositrio de usurios.
Para usar uma lista simples para preencher opes de campo
1.

Modifique uma tela de perfil (na pgina 27).

2.

Selecione um campo para modificar ou adicionar um novo campo.

3.

Se voc estiver adicionando um novo campo, selecione o atributo que est


associado ao campo na caixa de listagem.

4.

Selecione um dos seguintes estilos:

Seleo mltipla de caixa de seleo

Lista suspensa

Caixa suspensa

Seleo mltipla

Seletor de opes

Combinao do seletor de opes

Boto de opo de seleo nica

Seleo nica

Os campos na caixa de dilogo Propriedades do campo mudam de acordo com o


estilo selecionado.
5.

Selecione Lista simples no campo Origem das opes de seleo.


Um campo adicional, Opes de seleo, exibido.

6.

Insira as opes para o campo no campo Opes de seleo.


Cada opo deve aparecer em uma linha separada.
Se desejar que o CA IdentityMinder armazene um valor no repositrio de usurios
que seja diferente do valor que exibido na lista de opes, especifique cada opo
da seguinte maneira:
"valor-de-armazenamento;valor-de-exibio"

50 Guia de Design do Console de Usurio

Como preencher as opes de campo

7.

Especifique um dos seguintes valores no campo Preservar itens que no so


opes:

Sim valores existentes que no correspondem a uma das opes vlidas so


preservados.

No os usurios devem selecionar um valor da lista de opes predefinidas.


Valores existentes que no correspondem a um valor existente no so
preservados.

8.

Especifique valores para os demais campos obrigatrios.

9.

Clique em Aplicar e em OK.


O CA IdentityMinder salva as propriedades de campo atuais.

Dados da caixa de seleo


Os administradores e criadores de telas que podem modificar telas de tarefas podem
especificar opes que aparecem nos campos de tarefa. Os usurios podem selecionar
uma opo para preencher o campo. Oferecer opes de campo ajuda os usurios a
fornecer os dados corretos e limita as respostas possveis.
possvel especificar opes para os seguintes tipos de campo:

Seleo mltipla de caixa de seleo

Lista suspensa

Caixa suspensa

Seleo mltipla

Seletor de opes

Combinao do seletor de opes

Boto de opo de seleo nica

Seleo nica

possvel especificar os dados personalizados que deseja usar para preencher caixas de
seleo em arquivos XML. Por exemplo, voc pode usar os arquivos XML de Dados da
caixa de seleo para preencher as opes de uma caixa suspensa de Cidade ou Estado
na tarefa Criar usurio.
Voc tambm pode usar o arquivo XML de dados da caixa de seleo para configurar
uma dependncia entre dois campos em uma tela de tarefa. Por exemplo, as opes
disponveis no campo Cidade podem depender de uma opo que o usurio seleciona
no campo Estado.

Captulo 3: Configurando guias e telas de perfil 51

Como preencher as opes de campo

Como preencher campos com dados da caixa de seleo


Como administrador, voc pode usar Dados da caixa de seleo para definir os dados
que voc deseja preencher nos campos da tarefa. necessrio criar um arquivo XML de
dados da caixa de seleo que contm os dados que voc deseja preencher nos campos
da tarefa e importar o arquivo XML no ambiente do CA IdentityMinder. Os dados
importados so usados como uma origem para os campos da tarefa para a qual voc
deseja preencher opes. Ao modificar uma tarefa de usurio, configure as
propriedades do campo da tarefa para usar os dados da caixa de seleo para preencher
as opes do campo da tarefa selecionada.
Observao: por meio do arquivo XML de dados da caixa de seleo, possvel manter
os campos para preencher dados precisos e limitar as respostas possveis.
possvel configurar os seguintes campos da tarefa para usar Dados da caixa de seleo:

Seleo mltipla de caixa de seleo

Lista suspensa

Caixa suspensa

Seleo mltipla

Seletor de opes

Combinao do seletor de opes

52 Guia de Design do Console de Usurio

Como preencher as opes de campo

Boto de opo de seleo nica

Seleo nica

possvel especificar os dados personalizados que deseja usar para preencher caixas de
seleo em arquivos XML. Por exemplo, ao criar um usurio, possvel usar arquivos
XML de dados da caixa de seleo para preencher as opes do menu suspenso Cidade
ou Estado.
Voc tambm pode usar o arquivo XML de dados da caixa de seleo para configurar
uma dependncia entre dois campos em uma tela de tarefa. Por exemplo, as opes
disponveis no campo Cidade podem depender de uma opo que o usurio seleciona
no campo Estado.
O diagrama a seguir ilustra o processo para preencher as opes dos campos de tarefa
usando os dados da caixa de seleo:

Siga estas etapas::


1.

Criar um arquivo XML de dados da caixa de seleo (na pgina 54).

2.

Importar o arquivo XML de dados da caixa de seleo (na pgina 57).

Captulo 3: Configurando guias e telas de perfil 53

Como preencher as opes de campo

3.

Configurar os campos de tarefa para usar os Dados da caixa de seleo (na


pgina 61). Se houver campos dependentes, faa o seguinte:

Criar campos dependentes (na pgina 61).

Criar um arquivo XML de dados da caixa de seleo


Cada arquivo XML de dados da caixa de seleo contm dados que podem ser usados
para preencher as opes nos controle do console de usurio ao modificar um perfil.
possvel preencher as opes de campos de tarefa em qualquer janela de perfil com os
elementos ou elementos filho em um arquivo XML de dados da caixa de seleo.
Observao: os nomes de atributos fazem distino entre maisculas e minsculas em
XML.
Siga estas etapas:
1.

Crie um arquivo de texto com uma extenso .XML usando um editor de texto ou
XML.

2.

Adicione o cdigo no arquivo de texto com base nas opes que voc deseja
preencher no campo da tarefa e salve o arquivo. Crie um arquivo usando o formato
descrito acima.
O arquivo XML de dados da caixa de seleo criado. Agora possvel importar
esse arquivo XML no ambiente do CA IdentityMinder para preencher as opes nos
controles do console de usurio.

Exemplo: Criar um arquivo XML de dados da caixa de seleo


Este exemplo cria o arquivo XML de dados da caixa de seleo que preenche os nomes
de estados e nomes de cidades quando o pas selecionado como Austrlia ou Reino
Unido:
<places name="places" displayName="places">
<country name="AU" displayName="Australia">
<state name="VIC" displayName="Victoria">
<city name="MEL" displayName="Melbourne"/>
<city name="GEEL" displayName="Geelong"/>
<city name="BAL" displayName="Ballarat"/>
</state>
<state name="NSW" displayName="New South Wales">
<city name="SYD" displayName="Sydney"/>
<city name="NCL" displayName="Newcastle"/>
<city name="WOD" displayName="Wodonga"/>
</state>

54 Guia de Design do Console de Usurio

Como preencher as opes de campo

<state name="QLD" displayName="Queensland">


<city name="BRIS" displayName="Brisbane"/>
<city name="CNS" displayName="Cairns"/>
<city name="TVL" displayName="Townesville"/>
</state>
</country>
<country name="UK" displayName="UK">
<state name="SU" displayName="Surrey">
<city name="LON" displayName="London"/>
<city name="READ" displayName="Reading"/>
</state>
<state name="WLS" displayName="Wales">
<city name="CDF" displayName="Cardiff"/>
<city name="SWN" displayName="Swansea"/>
</state>
</country>
</places>

Arquivo XML de dados da caixa de seleo


O arquivo XML de dados da caixa de seleo uma coleo de elementos e elementos
filho com base em rvore.
O arquivo XML de dados da caixa de seleo organizado desta forma:
Elemento raiz
Identifica o arquivo XML de dados da caixa de seleo. Um arquivo XML de dados
da caixa de seleo inclui apenas um elemento raiz. O elemento raiz um
recipiente para todos os elementos e elementos filho. Esses elementos no podem
ser usados para preencher os campos.
Elemento Provider
Especifica os ns na rvore de um arquivo XML de dados da caixa de seleo. Esses
elementos contm as opes que voc pode usar para preencher os campos. O
Elemento Provider no tem um elemento pai. Por exemplo, voc pode criar dois
campos dependentes que possuem as opes Melbourne e Victoria. Os elementos
correspondentes no arquivo XML de dados da caixa de seleo devem pertencer ao
mesmo Elemento Provider. Na ilustrao abaixo, a cidade Melbourne depende do
Estado Victoria. O Elemento Provider para ambas as opes Austrlia.
Elementos
Qualquer elemento XML no arquivo XML de dados da caixa de seleo
identificado como um elemento. Um elemento pode ser um elemento pai ou um
elemento filho. Na ilustrao a seguir, Victoria um elemento pai de Melbourne.
Da mesma forma, Victoria um elemento filho de Austrlia.

Captulo 3: Configurando guias e telas de perfil 55

Como preencher as opes de campo

Elementos filho
Todos os elementos XML contidos nos elementos mais altos na estrutura de rvore
so chamados de elementos filho.
A ilustrao a seguir identifica a estrutura de dados da caixa de seleo.

Cada elemento tem os seguintes atributos:


Nome de exibio
Identifica o nome do elemento que exibido quando o elemento aparece no
console de usurio do CA IdentityMinder. Por exemplo, Melbourne e Queensland
so os nomes de exibio.
Tipo
Identifica o tipo de elemento. Por exemplo, o nome do estado e o nome da cidade
so elementos de digitao.

56 Guia de Design do Console de Usurio

Como preencher as opes de campo

Importar o arquivo XML de dados da caixa de seleo


O arquivo XML de dados da caixa de seleo inclui dados que o CA IdentityMinder usa
como opes nos campos da tarefa selecionada nas janelas de tarefas. Voc deve
importar o arquivo XML de dados da caixa de seleo para o ambiente do CA
IdentityMinder para usar os dados como a origem para os campos de tarefas cujas
opes voc deseja preencher.
Siga estas etapas:
1.

Efetue logon no console de usurio como administrador.

2.

Selecione uma das seguintes opes:

3.

Tarefas, sistema

Sistema

Escolha Selecionar dados da caixa, Importar dados da caixa de seleo.


A pgina Importar dados da caixa de seleo exibida.

4.

Clique em Criar provedor.


A tela Criar dados da caixa de seleo exibida.

5.

Preencha os seguintes campos:


Nome
Define o nome exclusivo do arquivo XML de dados da caixa de seleo. O CA
IdentityMinder valida a exclusividade do nome do identificador.
Descrio
Define uma descrio de texto do arquivo XML de dados da caixa de seleo.
Precedncia
Indica a precedncia do arquivo XML de dados da caixa de seleo em relao a
outros arquivos XML de dados da caixa de seleo. A precedncia deve ser
numrica.

6.

Clique em Procurar para localizar o arquivo XML de dados da caixa de seleo,


localize o arquivo XML e clique em Criar.
O arquivo XML de dados da caixa de seleo importado.

7.

Clique em Fechar.
O arquivo XML de dados da caixa de seleo recm-importado exibido na janela.

Captulo 3: Configurando guias e telas de perfil 57

Como preencher as opes de campo

Configurar os campos de tarefa para usar Dados da caixa de seleo para opes de campo
necessrio configurar os campos (para os quais voc deseja preencher opes) na
janela da tarefa para usar os dados da caixa de seleo como origem.
Siga estas etapas:
1.

No Console do usurio, selecione uma destas opes:

Funes e tarefas.

Tarefas, Funes e Tarefas.

2.

Selecione Tarefas administrativas, Modificar tarefa administrativa.

3.

Procure e selecione a tarefa administrativa a ser modificada.


O CA IdentityMinder exibe as guias para configurar a tarefa selecionada.

4.

Selecione a guia Guias e, em seguida, selecione a guia Perfil.

5.

Clique em Procurar ao lado do campo Tela.


O CA IdentityMinder exibe uma lista das telas de perfil existentes.

6.

Selecione a janela de perfil que deseja modificar ou copiar e, em seguida, clique em


um dos seguintes botes:

Selecionar
Adiciona a janela selecionada guia que voc est configurando

Editar
Abre uma nova janela com a qual possvel alterar as configuraes, incluindo
campos, propriedades de campo e layout da janela selecionada.

Excluir
Exclui a janela selecionada

Novo
Abre uma nova janela com a qual possvel criar uma janela. A nova janela no
inclui campos padro.

Copy
Cria uma janela usando as configuraes de uma janela existente. Para criar
uma janela com base em uma janela existente, necessrio adicionar um novo
nome e marc-lo na janela, e modificar as configuraes conforme necessrio.

Cancelar
Retorna janela de configurao da guia.

58 Guia de Design do Console de Usurio

Como preencher as opes de campo

Se voc selecionar Editar, Novo ou Copiar, o CA IdentityMinder abre uma nova


janela em que voc pode criar ou modificar uma janela de perfil.
7.

Adicione ou selecione um campo na janela de perfil e clique no cone de seta para a


direita para exibir as propriedades do campo.

8.

Configure as propriedades do campo conforme apropriado para um dos seguintes


valores:

Seleo mltipla de caixa de seleo

Lista suspensa

Caixa suspensa

Seleo mltipla

Seletor de opes

Combinao do seletor de opes

Boto de opo de seleo nica

Seleo nica

O campo Origem das opes de seleo exibido.


9.

Selecione uma das opes a seguir:


Dados da caixa de seleo
Especifica que as opes para o campo de tarefa so preenchidas com os dados
da caixa de seleo. Se voc selecionar essa opo, a opo Editar para Dados
da caixa de seleo da janela Opes exibida.
Uma lista de elementos raiz dos dados da caixa de seleo importados tambm
exibida.
a.

Clique em Editar.
A janela Opes de dados da caixa de seleo exibida. Ao usar essa
janela, possvel procurar os dados da caixa de seleo importados.

b.

Clique no Nome do elemento para exibir informaes sobre os elementos


filho para aquele elemento. Quando a lista de elementos exibidos
representar a lista de opes a ser usada para o campo do perfil, clique em
OK.

Captulo 3: Configurando guias e telas de perfil 59

Como preencher as opes de campo

Quando houver grandes listas de elementos, use os dois campos a seguir para
filtrar a lista. Esses campos oferecem suporte a um caractere curinga (*).
Filtro de nome secundrio
Especifica o nome do elemento ou elemento filho em Dados da caixa de
seleo.
Filtro de tipo secundrio
Especifica o tipo de elemento ou elemento filho no arquivo XML de Dados
da caixa de seleo.
Observao: os valores que voc pode selecionar nesse campo so
preenchidos a partir do arquivo XML de Dados da caixa de seleo que foi
importado para o CA IdentityMinder.
c.

Clique no boto Atualizar para filtrar os resultados.

Depende do valor de outro campo


Especifica que o campo preenchido com base nos valores selecionados em
outro campo. Se tiver selecionado esta opo, crie campos dependentes.
10. Selecione um campo existente no formulrio Campo de origem das opes.
11. Selecione um valor no campo Preservar itens que no so opes.
12. Selecione um valor no campo Validar mediante alterao.
13. Clique em Aplicar e em OK para salvar as alteraes.
Os campos configurados aparecem na guia de perfil da tarefa administrativa
selecionada. Os valores para os controles com base em seleo que esto
configurados para usar Dados da caixa de seleo como origem so preenchidos
com os valores do arquivo XML de Dados da caixa de seleo.

60 Guia de Design do Console de Usurio

Como preencher as opes de campo

Criar campos dependentes


Quando cada opo em um campo de tarefa corresponde a um elemento ou um
elemento filho, crie uma dependncia entre esses campos na janela da tarefa do CA
IdentityMinder.
Siga estas etapas:
1.

Crie um campo que usa o arquivo XML de Dados da caixa de seleo para preencher
as opes.
Por exemplo, possvel criar um campo denominado Estado que usa o estilo Lista
suspensa e arquivo XML de Dados da caixa de seleo para as opes. Cada opo
em Estado corresponde a um elemento ou um elemento filho no arquivo XML de
Dados da caixa de seleo. Cada elemento de Estado tem elementos filho de
Cidade.

2.

Crie outro campo, que preenchido com base na opo que voc selecionou na
etapa 1.
Por exemplo, possvel criar um campo denominado Cidade, que tem um estilo
Lista suspensa e depende do campo Estado.

Depois de criar os campos dependentes, necessrio configur-los para usar os Dados


da caixa de seleo. Os campos configurados aparecem na guia de perfil da tarefa
administrativa selecionada. Os valores para os controles com base em seleo que esto
configurados para usar Dados da caixa de seleo como origem so preenchidos com os
valores do arquivo XML de Dados da caixa de seleo.

Usar dados da caixa de seleo para opes de campo


Configure os campos em uma tela de tarefa para usar dados da caixa de seleo como a
origem de seleo para os campos de opes.
Para configurar os campos para usar os dados da caixa de seleo:
1.

Modifique uma tela de perfil (na pgina 27).

2.

Adicione ou selecione um campo na tela de perfil e clique no cone em forma de


seta para a direita para exibir as propriedades do campo.

3.

Preencha as propriedades do campo que voc adicionou. Defina o estilo com um


dos seguintes valores:

Seleo mltipla de caixa de seleo

Lista suspensa

Caixa suspensa

Seleo mltipla

Seletor de opes

Captulo 3: Configurando guias e telas de perfil 61

Como preencher as opes de campo

Combinao do seletor de opes

Boto de opo de seleo nica

Seleo nica

O campo Origem das opes de seleo exibido.


4.

Selecione uma das seguintes opes para o campo Origem das opes de seleo.
Dados da caixa de seleo
Especifica que o campo preenchido com os dados da caixa de seleo. Se
voc selecionar essa opo, a opo Editar para Dados da caixa de seleo para
opes exibida.
Uma lista de elementos raiz para os dados importados da caixa de seleo
tambm exibida.
Clique no boto Editar para exibir uma pgina Opes de dados da caixa de
seleo, que permite que voc procure os dados importados da caixa de
seleo. Clique no Nome do elemento para exibir informaes sobre os
elementos filho para aquele elemento. Quando a lista de elementos exibidos
representar a lista de opes a ser usada para o campo do perfil, clique em OK.
Quando houver grandes listas de elementos, os dois campos a seguir podem
ser usados para filtrar a lista. Esses campos oferecem suporte a um caractere
curinga (*). Clique no boto Atualizar para filtrar os resultados.
Filtro de nome secundrio
Identifica o nome do elemento ou elemento filho nos dados da caixa de
seleo.
Filtro de tipo secundrio
Identifica o tipo do elemento ou elemento filho no arquivo XML de dados
da caixa de seleo.
Para obter mais informaes sobre o nome do elemento e os tipos de
elemento, consulte o tpico O arquivo XML de dados da caixa de seleo.
Observao: os valores que voc pode selecionar nesse campo so
preenchidos a partir do arquivo XML de dados da caixa de seleo que foi
importado para o CA IdentityMinder.
Depende do valor de outro campo
Especifica que o campo preenchido com base nos valores selecionados em
outro campo. Se voc tiver selecionado esta opo, consulte o tpico Como
criar campos dependentes usando dados da caixa de seleo (na pgina 63).
Selecione um campo existente no formulrio Campo de origem das opes.

5.

Selecione um dos valores para o campo Preservar itens que no so opes.

62 Guia de Design do Console de Usurio

Como preencher as opes de campo

6.

Preencha as outras propriedades de campos necessrios e clique em Aplicar.

7.

Clique em OK para salvar as alteraes.


Os campos definidos sero exibidos para o usurio na guia do perfil da tarefa
administrativa selecionada. Os valores para os controles com base em seleo que
esto configurados para usar dados da caixa de seleo como origem sero
preenchidos com os valores do arquivo XML de dados da caixa de seleo.

Como criar campos dependentes usando dados da caixa de seleo


possvel criar uma dependncia entre dois campos na tela de tarefa do CA
IdentityMinder. O processo a seguir descreve as etapas que voc deve seguir para criar
dependncia entre dois campos:
1.

Crie um campo que usa o arquivo de dados da caixa de seleo para preencher as
opes.
Por exemplo, possvel criar um campo denominado Estado que usa o estilo Lista
suspensa e Dados da caixa de seleo para as opes. Cada opo em Estado
corresponde a um elemento ou um elemento filho nos dados da caixa de seleo.
Cada elemento de Estado tem elementos filho de Cidade.

2.

Crie outro campo, que preenchido com base na opo que voc selecionou na
etapa 1.
Por exemplo, possvel criar um campo denominado Cidade, que tem um estilo
Lista suspensa e depende do campo Estado.

Usar JavaScript para opes de campo


Voc pode especificar as opes que aparecem nos campos em uma tela de perfil,
escrevendo JavaScript personalizado.
Para usar um JavaScript para preencher opes de campo
1.

Modifique uma tela de perfil (na pgina 27).

2.

Selecione um campo para modificar ou adicionar um novo campo.

3.

Se voc estiver adicionando um novo campo, selecione o atributo que est


associado ao campo na caixa de listagem.

4.

Selecione um dos seguintes estilos:

Seleo mltipla de caixa de seleo

Lista suspensa

Caixa suspensa

Seleo mltipla

Seletor de opes

Captulo 3: Configurando guias e telas de perfil 63

Como preencher as opes de campo

Combinao do seletor de opes

Boto de opo de seleo nica

Seleo nica

Os campos na caixa de dilogo Propriedades do campo mudam de acordo com o


estilo selecionado.
5.

Selecione JavaScript no campo Origem das opes de seleo.


Um campo adicional, Opes de seleo (JavaScript), exibido.

6.

Insira JavaScript para fornecer as opes para o campo Opes de seleo


(JavaScript).
O JavaScript inserido deve conter uma funo com a assinatura "function
getOptions(FieldContext)" e retornar uma sequncia de caracteres de opes
delimitada por pipe. Se a opo tiver valores de exibio e armazenamento
separados, digite-os assim "valor-de-armazenamento;valor-de-exibio"
Por exemplo:
function getOptions(FieldContext) {
return "1;one|2;two|3;three|4;four";
}

7.

8.

Especifique um dos seguintes valores no campo Preservar itens que no so


opes:

Sim valores existentes que no correspondem a uma das opes vlidas so


preservados.

No os usurios devem selecionar um valor da lista de opes predefinidas.


Valores existentes que no correspondem a um valor existente no so
preservados.

Especifique valores para os demais campos obrigatrios.


Observao: para obter informaes sobre os campos obrigatrios, consulte a
ajuda online do console de usurio.

9.

Clique em Aplicar e em OK.

O CA IdentityMinder salva as propriedades de campo atuais

64 Guia de Design do Console de Usurio

Como preencher as opes de campo

Usar manipuladores de atributos lgicos para opes de campo


possvel usar um atributo lgico para preencher uma lista de opes de campo. Os
valores de atributo lgico (nesse caso, as opes) no so diretamente associados ao
repositrio de usurios nem gravados nele. Os valores de atributo lgico so
apresentados em um campo de tela de perfil. Quando um usurio seleciona uma opo
e envia uma tarefa, o valor selecionado processada por um manipulador de atributos
lgicos, que armazena o valor no atributo fsico associado ao atributo lgico.
Observao: o CA IdentityMinder inclui uma amostra de manipulador de atributos
lgicos, denominado StateSelector, que voc pode usar como base para criar um
manipulador de atributos lgicos que preenche opes de campo. A pasta de amostra
StateSelector instalada em samples\LogicalAttributes em Ferramentas
administrativas. As Ferramentas administrativas so colocadas nos seguintes locais
padro:

Windows: <caminho_de_instalao>\tools

UNIX: <caminho_de_instalao2>/tools

Para obter informaes sobre como usar a amostra, consulte o arquivo leiame.txt no
diretrio StateSelector.
Para usar uma lista simples para preencher opes de campo
1.

Crie um manipulador de atributos lgicos.


Observao: voc usa a API de atributo lgico para criar um manipulador de
atributos lgicos. Para obter mais informaes, consulte o Guia de Programao do
Java.

2.

No console de usurio do CA IdentityMinder, modifique uma tela de perfil (na


pgina 27).

3.

Adicione um novo campo.

4.

Selecione o atributo lgico associado ao manipulador de atributos lgicos que voc


criou.
Observao: os atributos lgicos so indicados por um caractere de pipe (|) antes e
depois.

5.

Selecione um dos seguintes estilos:

Seleo mltipla de caixa de seleo

Lista suspensa

Caixa suspensa

Seleo mltipla

Seletor de opes

Combinao do seletor de opes

Captulo 3: Configurando guias e telas de perfil 65

Como preencher as opes de campo

Boto de opo de seleo nica

Seleo nica

Os campos na caixa de dilogo Propriedades do campo mudam de acordo com o


estilo selecionado.
6.

Selecione Nenhum no campo Origem das opes de seleo.


Um campo adicional, Opes de seleo, exibido.

7.

8.

Especifique um dos seguintes valores no campo Preservar itens que no so


opes:

Sim valores existentes que no correspondem a uma das opes vlidas so


preservados.

No os usurios devem selecionar um valor da lista de opes predefinidas.


Valores existentes que no correspondem a um valor existente no so
preservados.

Especifique valores para os demais campos obrigatrios.


Observao: para obter informaes sobre os campos obrigatrios, consulte a
ajuda online do console de usurio.

9.

Clique em Aplicar e em OK.

O CA IdentityMinder salva as propriedades de campo atuais.

Preenchendo dinamicamente o campo Organizao


Se o repositrio de usurios que o CA IdentityMinder gerencia incluir organizaes, a
tarefa Criar usurio padro incluir um campo Organizao. Um administrador deve
pesquisar e, em seguida, selecione a devida organizao antes de criar um perfil de
usurio.
Para simplificar a tarefa Criar usurio, possvel configurar o CA IdentityMinder para
preencher o campo Organizao dinamicamente, de acordo com o administrador que
est executando a tarefa. Nesse caso, o administrador no precisar especificar uma
organizao. O usurio criado na organizao em que o perfil do administrador est
localizado. Por exemplo, se um administrador, cujo perfil existe na organizao
Funcionrios, criar um perfil de usurio para uma nova contratao, o CA
IdentityMinder criar o novo perfil na organizao Funcionrios. Se um administrador na
organizao Fornecedores usar a mesma tarefa Criar usurios, o perfil do novo usurio
que o segundo administrador criar dever existir no organizao Fornecedores.

66 Guia de Design do Console de Usurio

Como alterar dinamicamente as propriedades de exibio do campo

Configurar um campo de organizao dinmica


Quando voc configura um campo de organizao dinmica para a tarefa Criar usurio,
o CA IdentityMinder cria novos usurios na organizao em que o perfil do
administrador que est criando o usurio j existe.
Para configurar um campo de organizao dinmica
1.

No console de usurio, v para Funes e tarefas, Tarefa administrativa, Modificar


tarefa administrativa.

2.

Procure e selecione a tarefa Criar usurio.

3.

Na guia Guias, clique no cone Editar para editar a guia Perfil.

4.

No campo Tela, clique em Procurar para exibir uma lista de telas a serem editadas.

5.

Selecione a tela Criar perfil do usurio e clique em Editar.

6.

Localize a Organizao e clique no cone Editar para editar suas propriedades.

7.

Defina Estilo para Oculto.

8.

No campo JavaScript padro, digite o seguinte:


function defaultValue(FieldContext)
{
return FieldContext.getAdministrator().getOrg(null).getUniqueName();
}

9.

Clique em Aplicar.

10. Clique na seta para a esquerda ao lado das Propriedades do campo e retornar
tela.

Como alterar dinamicamente as propriedades de exibio do


campo
O CA IdentityMinder pode definir determinadas propriedades de exibio do campo
com base no valor de outros campos em uma tela de perfil. Usando JavaScript, voc
pode ocultar e mostrar o campo, ou ativar e desativar um campo. Por exemplo, voc
pode usar o JavaScript para mostrar um campo Agncia se o Tipo de funcionrio estiver
definido como Temp. Se o Tipo de funcionrio for Tempo integral ou Meio perodo, o
campo Agncia ser ocultado.
Insira o JavaScript nos campos JavaScript de inicializao ou JavaScript de validao na
caixa de dilogo Propriedades do campo na definio da tela de perfil. Os mtodos
controlam a exibio de um campo esto disponveis na classe FieldContext dos
mtodos init e validate.

Captulo 3: Configurando guias e telas de perfil 67

Como alterar dinamicamente as propriedades de exibio do campo

Por exemplo, para controlar a exibio do campo Agncia descrito acima, voc deve
informar o cdigo JavaScript a seguir no campo JavaScript de validao nas
Propriedades do campo Tipo de funcionrio, pois as alteraes no campo Tipo de
funcionrio controlam a exibio do campo Agncia:
function validate(FieldContext, attributeValue, changedValue, errorMessage) {
if (attributeValue == "Temp") {
FieldContext.showField("Agency");
}
else {
FieldContext.hideField("Agency");
}
return true;
}

Para garantir que o JavaScript seja acionado quando o valor do campo for alterado,
defina o campo Validar mediante alterao como Sim.

Configurar propriedades de exibio de campo dinmico


possvel configurar o CA IdentityMinder para ocultar e mostrar, ou ativar e desativar
um campo em uma tela de perfil de acordo com o valor de outro campo na tela.
Para configurar propriedades de exibio de campo dinmico
1.

Edite a tela do perfil (na pgina 27).


O CA IdentityMinder exibe uma lista de campos configurados para a tela.

2.

Adicione o campo para o qual voc est configurando as propriedades do campo


dinmico, se necessrio.

3.

Clique no cone Editar prximo ao nome do campo para edit-lo.


O CA IdentityMinder exibe a caixa de dilogo Propriedades do campo.

4.

Insira o cdigo JavaScript no campo JavaScript de validao usando o seguinte


mtodo:
function validate(FieldContext, attributeValue, changedValue, errorMessage)

A classe FieldContext inclui os seguintes mtodos para mostrar/ocultar e


ativar/desativar um campo:
public void hide();
Oculta o campo.
public void show();
Exibe o campo.

68 Guia de Design do Console de Usurio

Atributos lgicos definidos pela tela

public void hideField(String attrName);


Oculta o campo atual.
public void showField(String attrName);
Exibe o campo atual.
public void disable();
Desativa o campo atual.
public void enable();
Ativa o campo atual.
public void disableField(String attrName);
Desativa um campo para um atributo especfico.
public void enableField(String attrName);
Ativa um campo para um atributo especfico.
5.

Clique em Aplicar e em OK.

Atributos lgicos definidos pela tela


Os atributos lgicos definidos pela tela so campos em uma guia Perfil definidos
localmente para a tarefa atual. Voc pode usar esses atributos lgicos definidos pela
tela para manipular objetos em uma tela de tarefa ou modificar atributos fsicos que
esto armazenados no repositrio de usurios.
Os atributos lgicos definidos pela tela so definidos, inicializados, validados,
preenchidos e implementados usando o JavaScript.
Por exemplo, se voc tivesse 3 atributos fsicos que armazenassem uma data (ms, dia,
ano), mas desejasse apresentar ao usurio um nico campo para inserir a data, voc
poderia configurar um atributo lgico na tela para o campo de data. Depois que o
usurio insere uma data, possvel configurar o JavaScript de validao para analisar a
data detalhadamente quanto aos valores de ms, dia e ano e defini-los nos atributos
fsicos (que provavelmente seriam atributos ocultos na tela).
Observao: os atributos colocados entre '|' so identificados como atributos lgicos
definidos pela tela.
O os atributos lgicos definidos pela tela so teis quando voc est criando tarefas
genricas no vinculadas a nenhum objeto principal. Nesse caso, voc cria os campos na
guia Perfil usando somente atributos lgicos definidos pela tela. No possvel
especificar atributos fsicos.

Captulo 3: Configurando guias e telas de perfil 69

Atributos lgicos definidos pela tela

Adicionar atributos lgicos definidos pela tela


Qualquer campo em uma tarefa de perfil pode ser definido como um atributo lgico
definido pela tela. Voc pode usar esses atributos lgicos definidos pela tela para
manipular objetos localmente no escopo dessa tela de perfil ou modificar atributos
fsicos no repositrio de objetos. Por exemplo, voc pode usar os atributos lgicos
definidos pela tela para capturar uma anotao ou um aviso em uma tela de perfil, ou
processar um valor fornecido pelo usurio antes de armazen-lo no atributo fsico.
Para definir campos como atributos lgicos definidos pela tela
1.

Modifique a tela de perfil (na pgina 27) para adicionar ou modificar campos para
usar atributo lgico definido pela tela.

2.

Crie ou atualize as propriedades do campo com os valores especficos de atributo


lgico definido pela tela:
Nome do atributo
Selecione (Atributos lgicos na tela) no campo Nome do atributo.
|Nome do atributo|
Identifica o nome do atributo para o campo. Pode ser qualquer nome de sua
escolha.
Com valores mltiplos
Especifica que o atributo lgico definido pela tela tem valores mltiplos.
Observao: por padro, essa opo desmarcada. Se esse campo for
desmarcado, o atributo ser somente valor nico.
Nome
Insira o nome de exibio do nome do atributo lgico definido pela tela.
Observao: se o atributo lgico definido pela tela tiver o mesmo nome que o
Manipulador de atributos lgicos, o primeiro substituir o segundo.

3.

Preencha todas as propriedades do campo (na pgina 30) necessrias.

Atributos lgicos definidos pela tela em Exibir tarefas enviadas


Ao enviar uma tarefa que contm atributos lgicos definidos pela tela, os valores
original e atualizado para os atributos lgicos definidos pela tela so exibidos na tela
Detalhes da tarefa na guia Exibir tarefas enviadas.

70 Guia de Design do Console de Usurio

Componentes adicionais em uma tela de perfil

Componentes adicionais em uma tela de perfil


Alm dos campos, uma tela de perfil pode incluir um ou mais dos seguintes
componentes:

Separadores de pgina

Imagens

Arquivos anexados

Exibio de histrico

Texto HTML personalizado

Links ou botes para iniciar tarefas

Opes para o atributo separador


Ao selecionar Separador no campo Atributo da caixa de dilogo de propriedades do
campo, voc pode adicionar mais componentes a uma tela de perfil. O atributo
Separador tem as seguintes opes de estilo:
Binrio (somente para diretrios de usurios LDAP)
Permite adicionar um arquivo binrio, como um certificado ou outro documento, a
tela Perfil do usurio.
HTML
Exibe HTML em um a tela Perfil.
Exibio de histrico
Exibe uma tabela somente leitura contendo detalhes de entradas de histrico
anteriores em ordem cronolgica.
As entradas de histrico so anotaes que podem ser adicionadas a uma tarefa
enviada. Elas podem ser adicionadas medida que a tarefa passa pelo fluxo de
trabalho e exibidas usando a tarefa Exibir tarefas enviadas.
Editor de histrico
Exibe uma caixa de texto para inserir novas entradas do histrico e um boto
opcional para enviar a nova entrada.
Seo da pgina
Permite dividir a tela de perfil em vrias sees, o que pode ter um nmero
diferente de colunas que outras sees de pgina na mesma tela.
Por exemplo, o estilo Seo da pgina permite criar uma tela de perfil que tenha
uma seo de pgina inicial com uma nica coluna e outra seo de pgina com
duas colunas.

Captulo 3: Configurando guias e telas de perfil 71

Componentes adicionais em uma tela de perfil

Imagem (somente para diretrios de usurios LDAP)


Permite adicionar uma imagem a uma tela Perfil do usurio.
Espao
Adiciona um espao em branco tela para separar visualmente um conjunto de
campos.
Tarefa
Adiciona um link ou boto a uma tarefa diferente na guia Perfil.

Adicionar um atributo binrio ou uma imagem a uma tela de perfil


possvel configurar o CA IdentityMinder para incluir um arquivo binrio ou exibir uma
imagem em uma tela de perfil do usurio. Por exemplo, voc pode configurar uma tela
de perfil do usurio para permitir que os usurios anexem um documento, como um
certificado, tela de perfil, ou exibir uma fotografia digital do usurio que est sendo
gerenciado.
Observao: esse recurso est disponvel apenas para telas de perfil do usurio. O
repositrio de usurios deve ser um diretrio LDAP e o atributo binrio ou a imagem
devem ser armazenados em um atributo que definido no arquivo de configurao de
diretrio (directory.xml).
Para adicionar um atributo binrio ou uma imagem a uma tela de perfil
1.

Modifique a tela do perfil (na pgina 27).

2.

Selecione o campo abaixo da linha onde voc deseja adicionar a imagem e clique no
boto Adicionar para adicionar uma linha com um campo acima da linha
selecionada.
O CA IdentityMinder adiciona um novo campo acima do campo selecionado.

3.

Clique no cone Editar para editar o novo campo.


A caixa de dilogo Propriedades do campo exibida.

4.

Marque o atributo (Separador) no campo Nome do atributo.

5.

Selecione uma das seguintes opes no campo Estilo:

Binrio

Imagem

O CA IdentityMinder exibe novos campos de configurao campos na caixa de


dilogo Propriedades do campo.

72 Guia de Design do Console de Usurio

Componentes adicionais em uma tela de perfil

6.

Preencha os seguintes campos, conforme necessrio:

Nome
O rtulo que voc deseja aplicar para esse campo na tela do perfil.

Permisso
O nvel de privilgio do campo.
Observao: se um campo for exigido pelo repositrio de usurios, escolha
uma configurao obrigatria. Os campos obrigatrios so indicados por um
ponto vermelho na tela.

Leitura
Um administrador pode exibir, mas no modificar o campo.

Leitura/gravao
Um administrador pode ver o valor atual do campo (se houver) e digitar
um valor para o campo.

Leitura/gravao obrigatria
Um campo obrigatrio, mas caso contrrio, funciona como a
configurao de Leitura/gravao.

Gravar uma vez


Um administrador no pode ver o valor atual do campo (se houver), mas
pode digitar um valor.
Por exemplo, um administrador pode alterar a senha de um usurio, mas
no pode exibir a senha atual do usurio.

Gravao obrigatria
Um campo obrigatrio, mas caso contrrio, funciona como a
configurao de Gravao.

Abrangncia do rtulo
O nmero de colunas que o rtulo alcanar.

Abrangncia do campo
O nmero de colunas que o campo abranger (excluindo o rtulo)

Classe de CSS
A classe de folha de estilos em cascata que controla a apresentao desse
campo.
Observao: esse campo est disponvel somente para atributos de imagem.

Captulo 3: Configurando guias e telas de perfil 73

Componentes adicionais em uma tela de perfil

Estilo de CSS
Propriedades do campo e o estilo definidos atravs do recurso regras de CSS.
Voc pode usar este campo para definir a largura de um campo. Por exemplo,
para definir a largura do campo de onde a imagem ser exibida em 300 pixels,
especifique o seguinte no campo de Estilo de CSS:

Observao: esse campo est disponvel somente para atributos de imagem.

Nome do atributo binrio


Especifica o nome do atributo que armazena a imagem. Esse atributo deve
existir no repositrio de usurios, mas no deve ser definido no arquivo de
configurao de diretrio (directory.xml).

Tipo de contedo
Especifica o tipo de MIME de uma imagem a ser exibida. Por exemplo, para um
arquivo binrio, voc pode especificar aplicativo/fluxo-octet. Para uma
imagem, possvel especificar imagem/gif ou image/jpg.

Contedo alternativo
Especifica o URI de uma imagem alternativa que o CA IdentityMinder exibe
quando uma imagem no est disponvel para um determinado usurio.
O CA IdentityMinder inclui uma imagem padro, que exibida quando outra
imagem no est disponvel; no entanto, voc poder usar esse campo para
substituir a imagem padro.
A imagem padro est localizado em
iam_im.ear\user_console.war\ui\images\user_photo_default.jpg
iam_im.ear o local de implantao do CA IdentityMinder no servidor de
aplicativos.
Especifique o caminho para a imagem alternativa, que tem o mesmo tipo de
contedo do atributo, em relao a user_console.war.
Observao: esse campo estar disponvel apenas quando voc selecionar o
estilo Imagem.

7.

Clique em Aplicar e em OK para salvar as alteraes.

74 Guia de Design do Console de Usurio

Componentes adicionais em uma tela de perfil

Adicionar sees de pgina


As sees de pgina separam campos visualmente em uma tela de perfil adicionando
um cabealho e aplicando um nmero diferente de colunas para parte de uma tela de
perfil. O layout da seo de pgina se aplica at que outra seo de pgina seja definida
para a tela do perfil.
O exemplo de guia de perfil a seguir mostra duas sees de pgina.

Para adicionar uma seo de pgina


1.

Modifique a tela do perfil (na pgina 27).

2.

Selecione o primeiro campo que aparece na seo de pgina que voc est criando
e adicione uma linha com um campo antes do campo selecionado.
O CA IdentityMinder adiciona um novo campo acima do campo selecionado. Esse
campo indica onde a seo de pgina inicia.

3.

Clique no cone de seta para direita para editar o novo campo.


A caixa de dilogo Propriedades do campo exibida.

4.

Marque o atributo (Separador) no campo Nome do atributo.

5.

Selecione Seo de pgina no campo Estilo.


O CA IdentityMinder adiciona campos extras caixa de dilogo Propriedades do
campo.

Captulo 3: Configurando guias e telas de perfil 75

Componentes adicionais em uma tela de perfil

6.

Especifique os valores para os seguintes campos:

Colunas para layout


Especifica o nmero de colunas que a seo de pgina contm.
Depois de especificar o nmero de colunas, clique no cone de seta para direita
para aplicar as alteraes. Depois que as alteraes forem aplicadas, sero
exibidos campos adicionais que permitem especificar a largura de cada coluna.
Observao: cada campo inclui duas colunas, uma coluna para o rtulo de
campo e uma coluna para valores do campo. Para exibir dois campos em uma
nica linha, adicione quatro colunas.

Cabealho da tabela
Especifica o texto que aparece acima da seo de pgina como um ttulo.

Texto da dica
Especifica o texto que aparece abaixo do separador de pgina.
Voc pode usar esse campo para fornecer uma descrio sobre a seo de
pgina ou instrues para completar campos na seo de pgina.

Ativar os botes Ocultar e Mostrar


Determina se os usurios podem optar por ocultar uma seo de pgina.
Quando essa opo selecionada, o CA IdentityMinder adiciona um cone de
seta no cabealho da tabela que permite mostrar ou ocultar as seo de
pgina.

Ocultar inicialmente
Especifica que uma seo de pgina ocultada por padro.
Se os usurios puderem usar a seo de pgina, selecione a opo Ativar os
botes Ocultar/Mostrar ao selecionar a opo Ocultar inicialmente para
permitir que os usurios mostrem a seo de pgina.

Especifique a largura das colunas


Determina a largura de cada coluna na seo de pgina. Cada largura da coluna
especificada como uma porcentagem da tela do perfil.
Por exemplo, para adicionar quatro colunas de largura igual, voc pode
especificar cada largura da coluna como 25%.
Observao: a largura total das colunas deve ser 100%.

7.

Clique em OK para salvar as alteraes nas propriedades do campo.

8.

Clique em Selecionar para escolher a tela que voc editou ou copiou.

9.

Clique em OK e em Enviar para salvar as alteraes na tarefa.

76 Guia de Design do Console de Usurio

Componentes adicionais em uma tela de perfil

Adicionar uma tarefa aninhada


Uma tarefa aninhada uma tarefa administrativa que pode ser aberta na guia Perfil de
outra tarefa. Os usurios da primeira tarefa abrem a tarefa aninhada clicando em um
link ou boto. Por exemplo, voc pode adicionar um boto Excluir usurio tarefa
Modificar usurio. Se a conta de usurio no for mais vlida, um administrador poder
clicar no boto Excluir usurio para remover a conta, sem precisar retornar ao painel de
navegao para selecionar uma nova tarefa.
Observao: a tarefa aninhada no aparecer se o administrador no possuir privilgios
adequados para acess-la.
Para adicionar uma tarefa aninhada
1.

Modifique a tela do perfil (na pgina 27).

2.

Selecione o campo abaixo da linha onde voc deseja adicionar a tarefa aninhada e
clique no boto Adicionar para adicionar uma linha com um campo acima da linha
selecionada.
O CA IdentityMinder adiciona um novo campo acima do campo selecionado.

3.

Clique no cone Editar para editar o novo campo.


A caixa de dilogo Propriedades do campo exibida.

4.

Marque o atributo (Separador) no campo Nome do atributo.

5.

Selecione Tarefa no campo Estilo.


O CA IdentityMinder exibe novos campos de configurao campos na caixa de
dilogo Propriedades do campo.

6.

Preencha os seguintes campos, conforme necessrio:

Abrangncia do campo
O nmero de colunas que o campo abranger (excluindo o rtulo)

Tarefa padro
Especifica a tarefa que adicionada tarefa existente.

Substituir o nome da tarefa


Especifica o nome do link da tarefa ou o boto que aparecero na tela Perfil
para a tarefa ativa.

Link da tarefa
Determina se a tarefa aninhada exibida como um link ou um boto.

Captulo 3: Configurando guias e telas de perfil 77

Componentes adicionais em uma tela de perfil

Usar o objeto atual como entidade da tarefa


Quando essa opo selecionada, o Identity CA IdentityMinder usa a entidade
da tarefa ativa como a entidade da tarefa. Por exemplo, suponha que a tarefa
Modificar usurio inclua um link para a tarefa Excluir usurio. Um
administrador usa a tarefa Modificar usurio para modificar o perfil de John
Smith. O administrador decide que o perfil de John Smith no mais
necessrio, assim, ele usa o link Excluir usurio para abrir a tarefa Excluir
usurio. Quando a tarefa aberta, o CA IdentityMinder pergunta ao
administrador se ele deseja excluir o perfil de John Smith. O administrador no
precisa procurar o perfil para excluir.

Comportamento da tarefa
Determina como o CA IdentityMinder abre a tarefa.

Substituir tarefa ativa


Abre uma nova tarefa antes que a tarefa ativa seja concluda. A nova tarefa
substitui a tarefa anterior. Quando a tarefa aninhada concluda, os
usurios no so retornados tarefa original.

Aninhar tarefa na tarefa ativa


Envia a nova tarefa antes que a tarefa ativa seja concluda. Quando os
usurios concluem a nova tarefa, eles so retornados tarefa original.

Aninhar tarefa na tarefa ativa e executar somente depois que a tarefa


ativa for concluda
Envia a nova tarefa depois que a tarefa original concluda. Isso
chamado de ps-tarefa.

Adicionar texto de ajuda s tela de perfil


possvel adicionar texto em qualquer lugar na tela de perfil para fornecer informaes
adicionais, como texto de ajuda online para um campo, aos usurios.
Para adicionar texto de ajuda tela do perfil
1.

Modifique a tela do perfil (na pgina 27).

2.

Selecione o campo abaixo da linha onde voc deseja adicionar o texto de ajuda
online e clique no boto Adicionar para adicionar uma linha com um campo acima
da linha selecionada.
O CA IdentityMinder adiciona um novo campo acima do campo selecionado.

3.

Clique no cone Editar para editar o novo campo.


A caixa de dilogo Propriedades do campo exibida.

4.

Marque o atributo (Separador) no campo Nome do atributo.

78 Guia de Design do Console de Usurio

Componentes adicionais em uma tela de perfil

5.

Selecione HTML no campo Estilo.


O campo HTML exibido.

6.

Insira o texto que voc deseja exibir nas tags HTML, por exemplo:
<h1>Adicionar o texto da Ajuda online aqui</h1>

7.

Clique em OK.

Observao: para exibir HTML personalizado em um idioma diferente, especifique uma


chave de recurso com o formato a seguir no campo HTML personalizado:
${bundle=PacoteRecursos:key=IDchave}

PacoteRecursos
Identifica o pacote de recursos que inclui o mapeamento da sequncia de
caracteres de texto para a ID de chave.
IDchave
Identifica a ID de chave que mapeada para a sequncia de caracteres de texto
a ser exibida. O mapeamento deve existir em um pacote de recursos.
Por exemplo, o HTML para um campo localizado deve se parecer com este:
<p>
${bundle=MyResourceBundle;key=MyResourceKey}
</p>

Para obter mais informaes sobre pacotes de recursos, consulte o Guia de Design do
Console de Usurio.

Adicionar um campo Editor de histrico


O editor de histrico uma rea de texto que cria novas entradas do histrico, se essa
rea de texto contiver texto quando a tarefa for enviada. O editor de histrico pode
incluir um boto de envio opcional, que permite a criao de entradas de histrico, sem
enviar a tarefa.
Para adicionar um campo de editor de histrico a uma tela de perfil
1.

Modifique uma tela de perfil (na pgina 27).

2.

Selecione um campo para modificar ou adicionar um novo campo.

3.

Selecione (Separador) no campo Nome do atributo.


O CA IdentityMinder altera os campos que so exibidos.

4.

Selecione Editor de histrico no campo Estilo.

5.

No campo Rtulo, digite o nome do campo do editor de histrico que ser exibido
na tela do perfil.

Captulo 3: Configurando guias e telas de perfil 79

Componentes adicionais em uma tela de perfil

6.

Insira o texto que est vinculado s entradas do log de histrico que descreve a
funo do usurio que criou a entrada de log no campo Parte interessada.
Por exemplo, a descrio a seguir exibida na coluna Origem de uma exibio de
histrico para um usurio com um rtulo Parte interessada do aprovador:
Comentrio do usurio por SalesMgr (John Doe) que age como aprovador
Pode ser uma sequncia de caracteres ou uma chave de localizao, especificada de
acordo com as regras de localizao do CA IdentityMinder. O tipo da parte
interessada est em branco por padro e opcional.

7.

Insira o nmero de linhas e colunas para o editor de histrico.


Observao: se voc no especificar um valor para linhas e colunas, o editor de
histrico no ser exibido corretamente na tela do perfil.

8.

9.

Selecione uma das seguintes opes no campo Nvel de histrico:

Nvel da tarefa para tarefas de aprovao, a tarefa que pertence ao evento


que est sendo aprovado. Para tarefas de no aprovao, essa a tarefa atual.

Nvel do evento para tarefas de aprovao, esse o evento que est sendo
aprovado. Para das tarefas de no aprovao, isso no retornar nenhum
resultado.

Especifique o texto que aparece no envio no boto de envio no campo Adicionar


rtulo de boto.
O texto pode ser uma sequncia de caracteres ou uma chave de localizao,
especificada de acordo com as regras de localizao do CA IdentityMinder. Se
estiver em branco (o valor padro), o rtulo do boto ser "Adicionar evento ao
histrico".

10. Especifica a classe de CSS a ser usada para o boto Adicionar no campo Adicionar
classe CSS de boto.
Essas sequncias de caracteres sero includas no elemento <input> na tela de
perfil, como o contedo da classe e elementos de estilo, respectivamente.
11. Especifique a classe CSS a ser usada para o boto Adicionar no campo Adicionar
estilo CSS de boto.
Essas sequncias de caracteres sero includas no elemento <input> na tela de
perfil, como o contedo dos elementos 'style' e 'class', respectivamente.
12. Especifique se o editor de histrico de trabalho inclui seu prprio boto Adicionar
independente marcando ou desmarcando o campo Ativar o boto Adicionar.
Se marcada, esse boto enviar somente a nova entrada de histrico, e no tarefa
inteira.
Mais informaes:
Adicionar um campo Exibio de histrico (na pgina 81)

80 Guia de Design do Console de Usurio

Componentes adicionais em uma tela de perfil

Adicionar um campo Exibio de histrico


A exibio de histrico uma lista de entradas de texto criada usando o editor de
histrico. A exibio de histrico pode aparecer em qualquer tela de perfil,
independentemente do tipo de entidade. A exibio de histrico tem as seguintes
configuraes de propriedade de campo:
Para adicionar um campo de exibio de histrico a uma tela de perfil
1.

Modifique uma tela de perfil (na pgina 27).

2.

Selecione um campo para modificar ou adicionar um novo campo.

3.

Selecione (Separador) no campo Nome do atributo.


O CA IdentityMinder altera os campos que so exibidos.

4.

Selecione Exibio de histrico no campo Estilo.

5.

No campo Rtulo, digite o nome do campo do editor de histrico que ser exibido
na tela do perfil.

6.

No campo Nvel de histrico, selecione uma das seguintes opes:

7.

Nvel da tarefa para tarefas de aprovao, a tarefa que pertence ao evento


que est sendo aprovado. Para tarefas de no aprovao, essa a tarefa atual.

Nvel do evento para tarefas de aprovao, esse o evento que est sendo
aprovado. Para das tarefas de no aprovao, isso no retornar nenhum
resultado.

No campo Mostrar tipos de entrada, selecione uma das seguintes opes:

Apenas entradas criadas pelo usurio mostra apenas entradas de tempo de


execuo criadas usando o editor de histrico.

Todas as entradas mostra todas as entradas, inclusive aquelas criadas pelo


fluxo de trabalho ou controlador de tarefa.

Captulo 3: Configurando guias e telas de perfil 81

Configurar validao em nvel de tarefa

Configurar validao em nvel de tarefa


Voc configura a validao em nvel de tarefa no console de usurio ao definir as
propriedades do campo em um a de tarefas de perfil.
Para configurar a validao em nvel de tarefa
1.

Na tela de perfil, selecione o campo a ser validado e clique em Propriedades do


campo.
Voc define uma tela Perfil como parte da definio de guias para a tarefa.

2.

Especifique um valor em um dos campos a seguir, dependendo de como a regra de


validao deve ser implementada:

Expresso de validao - contm uma expresso regular que executa a


validao.

Classe de validao do Java - contm o nome totalmente qualificado de uma


classe Java que executa a validao, por exemplo:
com.mycompany.MyJavaValidator
O CA IdentityMinder espera que o arquivo da classe esteja localizado no
diretrio raiz designado para arquivos de classe Java personalizados. Para obter
informaes sobre a implantao de arquivos de classe Java, consulte o Guia de
Programao do Java.

JavaScript de validao - contm o cdigo completo do JavaScript que executa


a validao.
O cdigo JavaScript deve ser fornecido nesse campo. Com a validao em nvel
de tarefa, voc no pode fazer referncia a um arquivo que contm o cdigo
JavaScript.

3.

(Opcional) Ative a validao mediante alterao para que a validao do campo


ocorra assim que ele for alterado.

4.

(Opcional) Para usurio, grupo ou organizao, voc pode usar o boto Validar na
guia Perfil. O boto Validar fica oculto por padro. Para tornar esse boto visvel,
desmarque a opo Ocultar o boto Validar ao configurar a guia de perfil da tarefa.
Se Validar mediante alterao estiver ativada em um campo e o valor desse campo
for alterado, o boto Validar atualizar outros campos na tela.
Observao: o boto Validar tambm executa Manipuladores de atributos lgicos
que incluem o mtodo de validao. Para obter mais informaes sobre
Manipuladores de atributos lgicos, consulte o Guia de Programao do Java.

82 Guia de Design do Console de Usurio

Atributos personalizados definidos pelo usurio para funes

A validao no nvel de diretrio valida campos, dependendo do contedo do arquivo


directory.xml.
Observao: para obter mais informaes sobre a Validao no nvel de diretrio ou
compreender a validao padro includa com o CA IdentityMinder, consulte o Guia de
Configurao.

Atributos personalizados definidos pelo usurio para funes


O CA IdentityMinder oferece suporte a atributos personalizados definidos pelo usurio
que permitem que voc especifique informaes adicionais sobre funes. Voc pode
usar essas informaes para filtrar as funes em sua organizao. Por exemplo, um
ambiente corporativo pode ter mais de mil funes. Essa organizao pode especificar
informaes adicionais, tais como unidade de negcios ou localizao geogrfica, para
cada funo. Dessa forma, os administradores podem usar essas informaes para
facilitar as pesquisas de funes.
Voc pode usar atributos personalizados nas tarefas Criar, Modificar e Exibir para as
seguintes funes:

Funes administrativas

Funes de provisionamento

Funes de acesso

Para configurar atributos personalizados para funes, execute estas etapas de alto
nvel:
1.

Adicione suporte para atributos personalizados guia do perfil das tarefas que
criam, modificam ou exibem funes administrativas, funes de provisionamento
ou funes de acesso.

2.

Configure telas de pesquisa e de lista para as funes para incluir os atributos


personalizados.

Mais informaes:
Configurar atributos personalizados na guia Perfil para funes (na pgina 84)
Adicionar atributos personalizados a definies da tela de pesquisa (na pgina 84)

Captulo 3: Configurando guias e telas de perfil 83

Atributos personalizados definidos pelo usurio para funes

Configurar atributos personalizados na guia Perfil para funes


O CA IdentityMinder permite configurar at 10 atributos personalizados na guia Perfil
de tarefas que permitem criar, modificar ou exibir funes.
Para configurar os atributos personalizados na guia Perfil:
1.

2.

Clique em uma destas opes:

Tarefas, funes e tarefas

Funes e tarefas

Clique em Tarefas administrativas, Modificar tarefas administrativas.


A pgina Selecionar tarefa administrativa exibida.

3.

Procure e selecione a tarefa administrativa que deseja modificar.


O CA IdentityMinder exibe os detalhes da tarefa para a tarefa administrativa
selecionada.

4.

Clique na guia Guias.


As guias que esto configuradas para uso com essa tarefa administrativa so
exibidas.

5.

Clique no cone em forma de seta para editar a guia Perfil.


A tela Configurar perfil exibida.

6.

Marque a caixa de seleo ao lado de cada campo personalizado a ser adicionado


guia Perfil e fornea um rtulo sugestivo.

7.

Clique em OK.
Os atributos personalizados ficaro disponveis na guia Perfil da tarefa modificada
aps o seu envio.
Observao: para usar os atributos personalizados nas pesquisas de funes,
configure a tela de pesquisa (na pgina 84) para exibir esses atributos
personalizados.

Adicionar atributos personalizados a definies da tela de pesquisa


Quando desejar filtrar funes no CA IdentityMinder, poder usar apenas os atributos
que estiverem disponveis na tela de pesquisa. Para filtrar as funes com base nos
atributos personalizados que voc definiu, preciso adicionar os atributos
personalizados tela de pesquisa das funes.

84 Guia de Design do Console de Usurio

Atributos personalizados definidos pelo usurio para funes

Para adicionar atributos personalizados s telas de pesquisa das funes:


1.

2.

Clique em uma destas opes:

Tarefas, funes e tarefas

Funes e tarefas

Clique em Tarefas administrativas, Modificar tarefas administrativas.


A pgina Selecionar tarefa administrativa exibida.

3.

Procure e selecione a tarefa administrativa que deseja modificar.


Para adicionar atributos personalizados a telas de pesquisa, selecione a tarefa
Modificar ou Exibir para o tipo de funo (administrativa, de provisionamento ou de
acesso) que inclui atributos personalizados.
O CA IdentityMinder exibe os detalhes da tarefa para a tarefa administrativa
selecionada.

4.

Clique na guia Pesquisar, na tela Modificar funo administrativa.


Os detalhes da tela de pesquisa so exibidos.

5.

Clique no boto Procurar para exibir uma lista de definies de tela de pesquisa que
esto disponveis para a tarefa.
A pgina Selecionar definio de tela exibida.

6.

Selecione uma definio de tela de pesquisa para editar, ou crie uma cpia de uma
definio de tela de pesquisa existente.
A tela de pesquisa Configure Standard exibida.

7.

Adicione os atributos personalizados s seguintes tabelas:

Selecione os campos em que um usurio pode pesquisar

Selecione os campos que so exibidos nos resultados da pesquisa

8.

Altere o nome do atributo personalizado para corresponder ao nome que voc


especificou durante a configurao da guia Perfil.

9.

Clique em OK para salvar as alteraes feitas na definio de tela de pesquisa.


A pgina Selecionar definio de tela exibida novamente.

10. Selecione a tela criada ou editada e, em seguida, clique em Selecionar.


11. Selecione Todas as funes administrativas na lista Opes de pesquisa.
12. Clique em Enviar.
A tela de pesquisa ir incluir os atributos personalizados nas opes de pesquisa e
exibir os atributos nos resultados da pesquisa.

Captulo 3: Configurando guias e telas de perfil 85

Captulo 4: Configurando guias de conta


Esta seo contm os seguintes tpicos:
Guias da conta (na pgina 87)
Pr-requisito para usar a guia Contas (na pgina 88)
Campos na guia Contas (na pgina 88)
Funes adicionais na guia Contas (na pgina 89)

Guias da conta
A guia Contas lista as contas em terminais gerenciados para usurios que receberam
funes de provisionamento. Em geral, essa guia adicionada s tarefas que permitem
exibir ou modificar um usurio.

Quando a guia Contas adicionada a uma tarefa Modificar usurio, os administradores


podem executar outras aes nas contas do usurio. Por exemplo:

Suspender ou retomar uma conta.

Desbloquear uma conta que tenha sido bloqueada automaticamente devido a um


acesso incorreto ou inadequado. Por exemplo, uma conta pode ser bloqueada
quando um usurio excede o nmero aceitvel de tentativas de logon sem xito
definido em uma poltica de senha do CA IdentityMinder.

Alterar a senha do usurio em uma ou mais contas.

Atribuir e remover a atribuio de contas para um usurio.

Para obter detalhes sobre as outras opes que voc pode fornecer na guia Contas,
consulte a ajuda do console de usurio para a configurao da guia Contas.

Captulo 4: Configurando guias de conta 87

Pr-requisito para usar a guia Contas

Pr-requisito para usar a guia Contas


Para usar a guia Contas, o CA IdentityMinder deve ser configurado com suporte a
provisionamento, e o ambiente do CA IdentityMinder deve incluir um diretrio de
provisionamento.
Observao: para configurar o suporte a provisionamento de um ambiente, consulte o
Guia de Configurao.

Campos na guia Contas


A guia Contas exibe detalhes sobre as contas do usurio nos sistemas do terminal.
Alguns dos campos mais significativos so os seguintes:

Nome O nome de logon, nome de email ou outro nome para a conta.

Tipo de terminal O tipo de terminal, como um diretrio LDAP, que associado


conta.

Terminal O terminal especfico que associado conta.

Suspenso Um dos trs estados.

Ativo ser exibido se a conta estiver ativada.

Suspenso ser exibido se a conta estiver desativada.

Ativao pendente (manual) ser exibido se ela no puder ser retomada ou


suspensa. Efetue logon no sistema do terminal para retomar ou suspender a
conta.

Indisponvel ser exibido se o estado no puder ser recuperado porque no h


comunicao com o terminal.

Bloqueado Mostra se a conta est bloqueada. O bloqueio ocorre quando um


usurio faz vrias tentativas de efetuar logon na conta com a senha errada.
Indisponvel ser exibido se o estado no puder ser recuperado porque no h
comunicao com o terminal.

88 Guia de Design do Console de Usurio

Funes adicionais na guia Contas

Funes adicionais na guia Contas


Quando a guia Contas includa em uma tarefa que modifica um usurio, os
administradores podem usar essa tarefa para executar funes nas contas do usurio.
As funes disponveis so determinadas pela configurao da guia.
Voc pode selecionar quais funes estaro disponveis usando a opo Modificar tarefa
administrativa em uma tarefa que contm a guia Contas. Edite a guia Contas para
determinar se funes como Atribuir contas e Remover atribuio de contas esto
disponveis na guia.
Observao: consulte a ajuda online de configurao da guia Contas para obter mais
informaes.

Captulo 4: Configurando guias de conta 89

Captulo 5: Telas de pesquisa e lista


Esta seo contm os seguintes tpicos:
Configurao da tela de pesquisa (na pgina 91)
Telas de lista (na pgina 101)
Tarefas adicionais nas telas de pesquisa e lista (na pgina 105)

Configurao da tela de pesquisa


Configure uma tela de pesquisa para limitar o escopo da tarefa e controlar os campos
nos quais os usurios podem pesquisar. Telas de pesquisa se aplicam a dois tipos de
objeto:

Um objeto principal O objeto a ser modificado ou exibido pela tarefa.

Um objeto secundrio O objeto que est relacionado ao objeto principal.


Por exemplo, se voc incluir uma guia de grupo em uma tarefa de criao de
usurios, o usurio ser o objeto principal e o grupo ser o objeto secundrio. A
guia de grupo precisa de uma tela de pesquisa de grupos.
Observao: depois de configurar uma tela de pesquisa, voc pode us-la para
qualquer tarefa para procurar um objeto principal ou secundrio.

Tela Modificar uma pesquisa


Voc pode modificar uma tela de pesquisa existente para:

Configurar padres de filtro de pesquisa

Modificar os campos nos filtros de pesquisa

Modificar os campos nos resultados de pesquisa

Adicionar texto de ajuda na tela de pesquisa

Para modificar uma tela de pesquisa


1.

No console de usurio, selecione Funes e tarefas, Tarefa administrativa,


Modificar tarefa administrativa.

2.

Procure e selecione a tarefa administrativa a ser modificada.


O CA IdentityMinder exibe as guias a serem configuradas para a tarefa selecionada.

Captulo 5: Telas de pesquisa e lista 91

Configurao da tela de pesquisa

3.

Selecione a guia Pesquisar.

4.

(Opcional) Marque a caixa de seleo Os objetos modificados devem permanecer


no escopo do administrador.
Quando essa caixa de seleo for marcada, o CA IdentityMinder exibir um erro se
alteraes na tarefa fizerem o administrador perder o escopo sobre o objeto
principal. Por exemplo, um administrador pode usar Modificar usurio para alterar
um atributo Tipo de funcionrio de um usurio para Gerente. Essa alterao pode
colocar o usurio fora do escopo do administrador.
Observao: essa opo no exibida para as tarefas que gerenciam funes.

5.

Clique em Procurar ao lado do campo Tela.


O CA IdentityMinder exibe uma lista de telas aplicveis.

6.

Selecione a tela de pesquisa que deseja modificar ou copie e clique em um dos


botes a seguir:

Selecionar
Adiciona as telas selecionadas pesquisa que voc est configurando.

Editar
Abre uma nova tela em que voc pode alterar as configuraes, incluindo
campos, propriedades de campo e layout da tela selecionada.

Excluir
Exclui a tela selecionada.

Novo
Abre uma nova tela em que voc pode criar uma tela. A nova tela no inclui
campos padro.

Copiar
Cria uma nova tela usando as configuraes de uma tela existente. Para criar
uma tela com base em uma tela existente, voc adiciona um novo nome e tag
tela e modifica as configuraes, conforme necessrio.

Cancelar
Retorna tela de configurao Pesquisar.

Se voc selecionou Editar, Novo ou Copiar, o CA IdentityMinder abrir uma nova tela em
que voc pode criar ou modificar uma tela de pesquisa.

92 Guia de Design do Console de Usurio

Configurao da tela de pesquisa

Filtros de pesquisa
Os filtros de pesquisa limitam quais objetos a pesquisa retorna. Por exemplo, se o
objeto forem usurios, possvel limitar a pesquisa para localizar apenas prestadores de
servio. Voc pode configurar um filtro para encontrar os usurios com Tipo de
funcionrio definido como prestador de servio.
possvel configurar os campos a seguir para realizar pesquisas:
Mostrar apenas os objetos em conformidade com as regras abaixo
Define os critrios adicionais a serem combinados com o filtro definido pelo usurio
para limitar a pesquisa.
Observe o seguinte ao usar este campo:

Devido s limitaes das pesquisas de funes de provisionamento, esses


critrios substituem os campos de filtro pelo mesmo nome inserido pelo
usurio.

Os atributos usados quando voc configurar este campo no devem ser


adicionados como campos de pesquisa disponveis na tela de pesquisa.
Por exemplo, se voc configurar a tela de pesquisa para exibir somente as
funes em que o atributo Ativado definido como Sim, remova o atributo
Ativado da lista de atributos que os usurios podem especificar nos critrios de
pesquisa.
Caso contrrio, os critrios inseridos pelo usurio sero ignorados.

Filtro de pesquisa padro


Define um filtro que, por padro, exibido quando um administrador usa a tela de
pesquisa. Por exemplo, se estiver configurando uma tela de pesquisa para a tarefa
Modify Contractor e souber que os administradores geralmente pesquisam
prestadores de servio com base no nome da empresa de contrato, voc poder
definir o filtro padro como Contract Firm = *. Os administradores podem substituir
o filtro padro, especificando critrios de pesquisa diferentes. A definio de um
filtro padro melhora o desempenho ao limitar o nmero de resultados retornados
se um administrador no especificar um filtro antes de iniciar uma pesquisa.
Selecionar automaticamente todos os resultados de pesquisa quando usados com
tarefas de seleo mltipla
Especifica que todos os resultados de pesquisa so selecionados por padro. Se
voc marcar essa caixa de seleo, todos os objetos na lista de resultados da
pesquisa sero exibidos com uma caixa de seleo ao lado do nome do objeto.

Captulo 5: Telas de pesquisa e lista 93

Configurao da tela de pesquisa

Executar pesquisa automaticamente


Especifica que um campo de pesquisa exibido com os resultados da pesquisa.
Definir automaticamente a entidade da tarefa quando houver apenas um nico
resultado de pesquisa
Define o objeto principal da tarefa automaticamente quando somente um objeto
corresponde ao filtro de pesquisa.
Por exemplo, suponha que se essa opo seja selecionada para uma tela de
pesquisa de usurio que est associada tarefa Modificar usurio. Quando um
administrador abre a tarefa Modificar usurio e digita um filtro de pesquisa que
retorna apenas um usurio, o CA IdentityMinder abre a tarefa Modificar usurio
para esse usurio. O administrador no precisa selecionar o usurio para abrir a
tarefa Modificar usurio.
Observao: para que essa configurao seja aplicada, Executar pesquisa
automaticamente tambm dever ser selecionada.
Salvar filtro de pesquisa
Especifica que o filtro de pesquisa para a tarefa est salvo para o usurio na sesso
atual. Na prxima vez que esse usurio pesquisar na tarefa, o filtro de pesquisa
salvo ser exibido.
Observao: o CA IdentityMinder salva o filtro de pesquisa para a durao da
sesso do usurio. Quando o usurio efetua logoff, o filtro de pesquisa
desmarcado.
Pesquisar na organizao
Exibe um filtro de organizao na tela de pesquisa. Se essa caixa de seleo for
marcada, os administradores podero especificar um filtro que limita as
organizaes nas quais o CA IdentityMinder pesquisar um objeto. Voc pode
especificar valores padro para o filtro de pesquisa de organizao, especificando
uma tela de pesquisa no campo Pesquisa de organizao.
Salvar a organizao da pesquisa
Especifica que a organizao para a tarefa salva se uma organizao tiver sido
estabelecida para a pesquisa. Na prxima vez em que um usurio pesquisar na
tarefa, a organizao ser exibida.

94 Guia de Design do Console de Usurio

Configurao da tela de pesquisa

Pesquisa de organizao
Especifica a tela de pesquisa que o CA IdentityMinder usa para permitir que os
administradores pesquisem uma organizao.
Escopo da pesquisa de organizao padro
Especifica o escopo da pesquisa de organizao padro que exibido quando um
administrador usa uma tela de pesquisa. O escopo da pesquisa determina os nveis
em uma rvore da organizao que so includos na pesquisa. Os administradores
podem substituir o escopo da pesquisa de organizao padro, especificando
critrios de pesquisa diferentes na tela de pesquisa.
Por exemplo, se voc configurar uma tela de pesquisa para uma tarefa
personalizada Modify Contractor em um ambiente que armazena as informaes
do prestador de servio em vrios nveis da rvore da organizao, possvel definir
o escopo da pesquisa de organizao padro como e inferior.
Pesquisa de expresso simples
Define o tipo de filtro de pesquisa que exibido na tela de pesquisa. Quando essa
caixa de seleo for marcada, os usurios podero especificar um nico filtro de
pesquisa, como <attribute><comparator><value>. Quando voc desmarcar essa
caixa de seleo, os usurios podero especificar vrios filtros de pesquisa. Por
exemplo, <attribute1><comparator><value1> AND <attribute2><comparator>
<value2>. Os objetos que atendem s condies em todos os filtros so retornados
nos resultados da pesquisa. No exemplo anterior, objetos que incluem <value1> e
<value2> seriam retornados como resultados da pesquisa.
Igual apenas pesquisa
Probe que os administradores usem operadores de pesquisa que no sejam iguais.
Exibir nmero de resultados
Exibe o nmero de resultados da pesquisa correspondentes. Quando essa caixa de
seleo for marcada, todas as pesquisas retornaro a mensagem "H X resultados".
Adicionar boto de tarefa para <nome da tarefa>
Adiciona um link para outra tarefa na tela de pesquisa. O link exibido como um
boto.
Esse campo geralmente usado para adicionar um Criar tarefa a uma tela de
pesquisa que esteja configurada para navegao em tarefas-objeto.
Rtulo opcional
Especifica um rtulo para a tarefa selecionada no campo anterior. Esse rtulo
aparece no boto para a tarefa.
Adicionar boto de excluso mltipla para <nome da tarefa>
Adiciona um link para uma tarefa que permite aos administradores selecionar
vrios objetos a serem excludos. O link exibido como um boto.
Esse campo geralmente tem navegao em tarefas-objeto.

Captulo 5: Telas de pesquisa e lista 95

Configurao da tela de pesquisa

Campos de pesquisa e resultados da pesquisa


Em outra parte da tela de pesquisa, voc deve selecionar campos que um administrador
pode usar em uma consulta de pesquisa e os campos que sero exibidos nos resultados
da pesquisa.
Selecione os campos em que um usurio pode pesquisar
Selecione os campos que um administrador pode usar para criar uma consulta de
pesquisa.
Para adicionar outros campos, selecione os campos na caixa de listagem abaixo da
tabela de campos de pesquisa.
Depois de selecionar os campos, voc pode alterar a ordem em que eles aparecem
usando os cones em forma de seta para cima e para baixo, direita do campo.
Observao: se voc no especificar os campos nos quais um administrador pode
pesquisar, o CA IdentityMinder iniciar a pesquisa automaticamente.
Selecione os campos que so exibidos nos resultados da pesquisa
Selecione os campos que o CA IdentityMinder exibe nos resultados da pesquisa.
possvel selecionar campos que no esto disponveis na consulta de pesquisa.
Para adicionar outros campos, selecione os campos na caixa de listagem abaixo da
tabela de campos de pesquisa.
Estilo
Ao selecionar um campo a ser exibido nos resultados da pesquisa, voc poder
selecionar uma das seguintes opes de estilo:

Nome booleano para exibio


Exibe o nome do campo para todos os resultados que forem verdadeiros.
Por exemplo, se voc digitar Ativado como o nome do atributo que indica
um status da conta de usurio, "Ativado" ser exibido nos resultados da
pesquisa para todas as contas de usurio ativas.

Marca de seleo
Exibe o valor como uma marca de verificao selecionada, com base no
valor do atributo. Por exemplo, se voc selecionar o estilo da marca de
verificao para representar o estado Ativado/Desativado de contas de
usurio, o CA IdentityMinder exibir uma marca de verificao selecionada
para todas as contas ativas.

Sequncia de caracteres com vrios valores


Exibe os valores em um atributo de vrios valores em linhas separadas. Os
valores so listados em ordem alfabtica.

Caixa de seleo somente leitura


Exibe o valor como uma caixa de seleo de somente leitura.

96 Guia de Design do Console de Usurio

Configurao da tela de pesquisa

Sequncia
Exibe o valor como uma sequncia de caracteres de texto.

Tarefa
Adiciona uma lista de tarefas a um campo. Os usurios clicam em um cone
em forma de seta para visualizar uma lista das tarefas que podem ser
executadas no objeto associado ao campo de pesquisa. Por exemplo, se
voc adicionar uma lista de tarefas a um campo Sobrenome nos resultados
da pesquisa, os usurios podero clicar no cone em forma de seta desse
campo para ver uma lista das tarefas que podem ser executadas no
usurio selecionado.
Essa configurao tambm pode ser usada para fazer com que um valor de
atributo seja exibido como um link para uma tarefa.
Se voc selecionar o estilo Tarefa, um cone em forma de seta para a
direita ser exibido ao lado da coluna Estilo. Clique na seta para abrir uma
caixa de dilogo Propriedades do campo. Use essa caixa de dilogo para
configurar uma lista de tarefas (na pgina 103).

Lista de tarefas
Adiciona mais tarefas que os usurios podem executar nos objetos em
telas de pesquisa e de lista. Por exemplo, possvel configurar a tela de
pesquisa na tarefa Modificar usurio para permitir que os usurios
executem uma tarefa, como desativar um usurio, na lista de usurios
retornados pela pesquisa.
Ao selecionar essa opo, possvel determinar se os usurios acessam a
tarefa clicando em um cone ou em um vnculo de texto.

Menu de tarefas
Adiciona mais tarefas (similar ao estilo Lista de Tarefas) como itens de
menu pop-up.
Ao selecionar essa opo, um boto de ao aparece ao lado de cada
objeto em uma tela de pesquisa ou de lista. Os usurios clicam no boto de
ao para visualizar a lista de tarefas que podem ser executadas para esse
objeto.

Observao: para ver as opes de estilo Lista de tarefas e Menu de tarefas,


selecione (Separador) quando adicionar um campo tabela de resultados da
pesquisa. Para obter mais informaes sobre como adicionar outras tarefas a telas
de pesquisa e de lista, consulte o Guia de Design do Console de Usurio.
Classificvel
Marque esta caixa de seleo para permitir que os administradores
classifiquem os resultados da pesquisa por campo ou campos.

Captulo 5: Telas de pesquisa e lista 97

Configurao da tela de pesquisa

Defina a ordem de classificao padro para os resultados da pesquisa


Especifica a ordem em que os resultados da pesquisa so exibidos. Os resultados da
pesquisa so classificados inicialmente pelo primeiro campo na lista e, em seguida,
por cada campo adicional na ordem em que aparecem. Marque a caixa de seleo
Decrescente para classificar os resultados em ordem decrescente.
Selecionar objetos com alteraes no campo nome
Especifica que os objetos nos quais o campo especificado foi alterado so
selecionados quando o usurio clica no boto Selecionar.
Retornar N resultados por pgina
Selecione o nmero de resultados a serem exibidos por pgina. Quando os
resultados da pesquisa excedem o nmero especificado, o CA IdentityMinder exibe
um link para cada pgina de resultados.

Ajuda definida pelo usurio nas telas de pesquisa


Se desejar adicionar texto personalizado tela de pesquisa, possvel definir o texto na
caixa de texto HTML correspondente. possvel adicionar texto nas seguintes reas:

Incio ou no fim da pgina

Antes ou depois da criao

Antes ou depois dos resultados

Tipos de tela de pesquisa


O CA IdentityMinder inclui estas telas de pesquisa pr-configuradas.
Tela de pesquisa de funo de acesso
A tela de pesquisa de funo de acesso permite configurar filtros de pesquisa para
encontrar as funes de acesso que correspondem a determinados critrios.
Tela de pesquisa de tarefa de acesso
A tela de pesquisa de tarefa de acesso permite configurar filtros de pesquisa para
encontrar as tarefas de acesso que correspondem a determinados critrios. Essa
tela de pesquisa usada para localizar uma tarefa de acesso para exibir ou
modificar, ou para adicionar uma tarefa a uma funo de acesso.
Tela de pesquisa de funo administrativa
A tela de pesquisa de funo administrativa permite configurar filtros de pesquisa
para encontrar as funes administrativas que correspondem a determinados
critrios.

98 Guia de Design do Console de Usurio

Configurao da tela de pesquisa

Tela de pesquisa de tarefa administrativa


A tela de pesquisa de tarefa administrativa permite configurar filtros de pesquisa
para encontrar as tarefas administrativas que correspondem a determinados
critrios. Essa tela de pesquisa usada para localizar uma tarefa administrativa para
exibir ou modificar, ou para adicionar uma tarefa a uma funo administrativa.
Tela de pesquisa de aprovao
A tela de pesquisa de aprovao permite configurar a exibio que aparece na parte
superior de uma tarefa de aprovao.
Tela de pesquisa de usurio com certificao inicial
A tela de pesquisa de usurio com certificao inicial permite configurar filtros de
pesquisa para localizar usurios e defini-los para exigir certificao. Os usurios
selecionados tero seu status de certificao configurado para exigindo a
certificao.
Tela de pesquisa de certificao de usurio
A tela de pesquisa de certificao de usurio permite configurar os filtros de
pesquisa para localizar usurios que exigem certificao.
Tela de pesquisa de delegao
A tela de pesquisa de delegao permite configurar os filtros de pesquisa para
localizar outros usurios para adicionar como representantes. Um representante
outro usurio ao qual voc poder conceder temporariamente permisso para
exibir e resolver os itens de trabalho do fluxo de trabalho.
Tela de pesquisa Ativar/desativar usurio
A tela de pesquisa Ativar/desativar usurio permite configurar filtros de pesquisa
para ativar/desativar os usurios que correspondem a determinados critrios.
Tela de pesquisa de usurio com certificao final
A tela de pesquisa de usurio com certificao final permite configurar filtros de
pesquisa para identificar usurios cujo ciclo de certificao deve ser concludo.
Tela da pesquisa de Contrato de Licena de Usurio Final
A tela da pesquisa de Contrato de Licena de Usurio Final permite configurar a
tarefa Autorregistro com uma pgina especfica do seu aplicativo com base em
identidades.
Pesquisa para a opo Explorar e correlacionar
A tela de pesquisa para a opo Explorar e correlacionar permite configurar filtros
de pesquisa para explorar e correlacionar as definies que corresponderem a
determinados critrios.

Captulo 5: Telas de pesquisa e lista 99

Configurao da tela de pesquisa

Pesquisa de upload de arquivo do alimentador


A tela de pesquisa de upload de arquivo do alimentador permite procurar pelo
arquivo do alimentador para fazer upload. Um arquivo do alimentador usado para
automatizar aes repetidas realizadas em um grande nmero de objetos
gerenciados.
Tela de pesquisa de senha esquecida/Tela de pesquisa de ID de usurio esquecida
A tela de pesquisa de senha esquecida permite configurar a tarefa Senha esquecida
para solicitar aos usurios informaes que verificam sua identidade.
Tela de pesquisa de grupo
A tela de pesquisa de grupo permite configurar filtros de pesquisa para grupos,
como grupos dentro da organizao financeira.
Tela de pesquisa de conjunto de polticas de identidade
A tela de pesquisa de conjunto de polticas de identidade permite configurar filtros
de pesquisa para localizar conjuntos de polticas de identidade que corresponderem
a determinados critrios.
Tela de pesquisa de manipulador de atributos lgicos
A tela de pesquisa de manipulador de atributos lgicos permite configurar filtros de
pesquisa para localizar manipuladores de atributos lgicos. Essa tela de pesquisa
usada para localizar um manipulador de atributos lgicos para exibir ou modificar
suas configuraes.
Tela de pesquisa Gerenciar relatrios
A tela de pesquisa Gerenciar relatrios permite configurar filtros de pesquisa para
localizar um relatrio para exibir ou excluir.
Tela de pesquisa de usurio no certificado
A tela de pesquisa de usurio no certificado permite configurar filtros de pesquisa
para localizar os usurios que no foram certificados at o final do perodo de
certificao.
Tela de pesquisa de organizao
A tela de pesquisa de organizao permite configurar filtros de pesquisa para limitar
a escolha de organizaes para determinadas suborganizaes.
Tela de pesquisa de funo de provisionamento
A tela de pesquisa de funo de provisionamento permite configurar os filtros de
pesquisa para recuperar funes de provisionamento.
Tela de pesquisa de modelo de conta
A tela de pesquisa de modelo de conta permite configurar os filtros de pesquisa
para recuperar modelos de contas.

100 Guia de Design do Console de Usurio

Telas de lista

Tela de pesquisa de poltica de senha


A tela de pesquisa de poltica de senha permite configurar os filtros de pesquisa
para localizar polticas de senha que correspondem a determinados critrios.
Tela de pesquisa de definio de instantneo
A tela de pesquisa de definio de instantneo permite configurar os filtros de
pesquisa para localizar uma definio de instantneo para exibir, modificar ou
excluir.
Tela de pesquisa padro
A tela de pesquisa padro permite configurar filtros para localizar objetos
gerenciados personalizados.
Tela de pesquisa de usurio
A tela de pesquisa de usurio permite configurar filtros de pesquisa para localizar
usurios que correspondem a determinados critrios. Por exemplo, possvel
procurar por usurios que so prestadores de servio.
Depois de preencher a guia Pesquisar, v para Escolher guias para a tarefa.

Telas de lista
Na configurao de guias, geralmente voc precisa exibir uma lista de itens, como uma
lista de usurios ou funes. A lista exibida na guia que voc est configurando. Nessas
situaes, crie uma Tela de lista para controlar as colunas e classificao dos objetos na
guia.
Voc pode configurar os seguintes campos para uma Tela de lista:
Nome
Define o nome da tarefa.
Qualificador
Um identificador que seja exclusivo dentro da tarefa. Ele pode conter caracteres
ASCII (a-z, A-Z), nmeros (0-9) ou caracteres de sublinhado, comeando com uma
letra ou sublinhado. O qualificador usado para definir valores de dados por meio
de documentos XML ou parmetros HTTP.
Campo
Especifica os atributos que so exibidos como campos nos resultados da pesquisa.
Nome
Especifica o rtulo para o campo nos resultados da pesquisa.

Captulo 5: Telas de pesquisa e lista 101

Telas de lista

Estilo
Determina o formato do campo nos resultados da pesquisa. Voc pode especificar
as seguintes opes de estilo:
Nome booleano para exibio
Exibe o nome do campo para todos os resultados que forem verdadeiros. Por
exemplo, se voc digitar Ativado como o nome do atributo que indica um
status da conta de usurio, "Ativado" ser exibido nos resultados da pesquisa
para todas as contas de usurio ativas.
Marca de seleo
Exibe o valor como uma marca de verificao selecionada ou no, com base no
valor do atributo. Por exemplo, se voc selecionar o estilo da marca de
verificao para representar o estado Ativado/Desativado de contas de usurio,
o CA IdentityMinder exibir uma marca de verificao selecionada para todas
as contas ativas.
Sequncia de caracteres com vrios valores
Exibe os valores em um atributo de vrios valores em linhas separadas. Os
valores so listados em ordem alfabtica.
Caixa de seleo somente leitura
Exibe o valor como uma caixa de seleo de somente leitura.
Sequncia
Exibe o valor como uma sequncia de caracteres de texto.
Tarefa
Adiciona uma lista de tarefas a um campo. Os usurios clicam em um cone de
seta para a direita para exibir uma lista das tarefas que podem ser executadas
no objeto associado ao campo de pesquisa. Por exemplo, se voc adicionar
uma lista de tarefas a um campo Sobrenome nos resultados da pesquisa, os
usurios podero clicar no cone em forma de seta desse campo para ver uma
lista das tarefas que podem ser executadas no usurio selecionado.
Classificvel
Determina se os usurios podem classificar os resultados da pesquisa de acordo
com o campo selecionado.
Decrescente
Determina a ordem em que os resultados da pesquisa so exibidos. Quando a caixa
de seleo Decrescente estiver marcada, os resultados da pesquisa sero
classificados em ordem alfabtica na ordem decrescente. Os resultados so
classificados na ordem em que aparecem na lista.

102 Guia de Design do Console de Usurio

Telas de lista

Resultados por pgina


Indica o nmero de resultados da pesquisa a serem exibidas nos resultados da
pesquisa.
Insira o HTML para que aparea antes da lista
Especifica o texto que aparece acima da lista dos resultados da pesquisa.
Insira o HTML para que aparea aps a lista
Especifica o texto que aparece abaixo da lista dos resultados da pesquisa.
Voc tambm pode adicionar texto acima e abaixo de uma tela de lista.

Adicionar uma lista de tarefas


Uma lista de tarefas um menu de tarefas que voc acessa de uma lista de objetos,
como uma lista ou tela de resultados da pesquisa. As listas de tarefas permitem exibir e
usar as tarefas que se aplicam a um objeto sem precisar procurar esse objeto toda vez
que voc usar uma nova tarefa. Por exemplo, voc pode configurar o CA IdentityMinder
para exibir um menu de tarefas para cada integrante da funo listado na guia
Associao da tarefa Modificar integrantes da funo administrativa. Os
administradores podem usar os menus de tarefas para gerenciar os integrantes da
funo sem precisar executar uma nova pesquisa para cada integrante da funo.
Para adicionar uma lista de tarefas
1.

Execute uma das seguintes etapas:

Selecione Modificar tarefa administrativa de Funes e tarefas, Tarefa


administrativa. Procure e selecione a tarefa administrativa a ser modificada.

Selecione Criar tarefa administrativa de Funes e tarefas, Tarefa


administrativa. Em seguida, selecione Criar cpia de uma tarefa administrativa
e pesquise uma tarefa a ser copiada.

O CA IdentityMinder exibe as guias a serem configuradas para a tarefa selecionada.


2.

Selecione a guia em que deseja adicionar a lista de tarefas.


Em geral, essa uma guia que inclui uma pesquisa ou tela de lista, como a guia
Associao.

3.

Pesquise uma lista ou tela de pesquisa para editar clicando em Procurar.

4.

Selecione o campo para a lista de tarefas da lista de campos que aparecem nos
resultados da pesquisa.

5.

Selecione Tarefa no campo Estilo.

6.

Clique no cone de seta para direita para abrir uma seo Propriedades do campo
na qual possvel configurar a lista de tarefas.

Captulo 5: Telas de pesquisa e lista 103

Telas de lista

7.

Preencha os seguintes campos, conforme necessrio:

Tarefa padro
Especifica a tarefa que exibida quando um usurio clica em um valor no
campo. Ao configurar um campo para oferecer suporte s listas de tarefas, e
especificar uma tarefa padro, o valor do campo exibido em azul, indicando
que um link.
Por exemplo, se voc configurar o campo Sobrenome para incluir uma lista de
tarefas, um administrador poder clicar no sobrenome de um usurio para
abrir a tarefa padro.

Tarefa alternativa
Especifica a tarefa que exibida quando um usurio clica no valor do campo e
no possui privilgios para usar a tarefa padro.

Ativar o menu de tarefas pop-up


Exibe um cone de seta para a direita ao lado do campo. Os usurios clicam no
cone para exibir a lista de tarefas que eles podem executar no objeto nesse
campo.
Quando voc marca essa caixa de seleo, as seguintes opes so exibidas:

Incluir todas as tarefas que o administrador pode executar no objeto

Incluir todas as tarefas que o administrador pode executar no objeto, a


menos que estejam ocultas nos menus

Incluir apenas as tarefas especificadas


Exibe apenas as tarefas que voc seleciona no campo Tarefa.
Observao: os usurios no vero uma tarefa especificada se no tiverem
privilgios para us-la.

Excluir as tarefas especificadas


Exibe as tarefas que um administrador pode executar no objeto, exceto
tarefas listadas no campo Tarefa.

Tarefa
Especifica as tarefas aparecem ou no em uma lista de tarefas, o que
depende das caixas de seleo Incluir apenas as tarefas especificadas ou
Excluir as tarefas especificadas estarem ou no marcadas.

Aninhar tarefa
Quando marcada, especifica que o CA IdentityMinder deve abrir a tarefa como
uma tarefa aninhada. Quando os usurios concluem a tarefa aninhada, eles so
retornados tarefa original.
Se essa opo no for selecionada, a nova tarefa substituir a tarefa original.

8.

Clique em OK.

104 Guia de Design do Console de Usurio

Tarefas adicionais nas telas de pesquisa e lista

Tarefas adicionais nas telas de pesquisa e lista


possvel configurar o CA IdentityMinder para adicionar aes extras que os usurios
podem executar em telas de pesquisa e lista. Por exemplo, possvel configurar a tela
de pesquisa na tarefa Modificar usurio para permitir que os usurios executem uma
tarefa, como desativar um usurio, na lista de usurios retornados pela pesquisa.
A adio de tarefas s telas de pesquisa e lista reduz o nmero de cliques necessrios
para concluir uma tarefa, alm de simplificar o console de usurio.
As tarefas nas telas de pesquisa e lista podem ser exibidas usando um dos seguintes
mtodos:

cones ou links de tarefas


Exibe cada tarefa como link ou cone nas telas de lista ou resultados da pesquisa.
Use esse mtodo para exibir um pequeno nmero de tarefas.

Menus da tarefa
Exibe um boto Ao em cada linha nas telas de lista ou resultados da pesquisa. Os
administradores clicam no boto Ao para visualizar a lista de tarefas que eles
podem executar para esse usurio.
Use esse mtodo se os usurios puderem executar mais de duas ou trs tarefas.

Captulo 5: Telas de pesquisa e lista 105

Tarefas adicionais nas telas de pesquisa e lista

Adicionar tarefas extras s telas de pesquisa e lista


possvel configurar o CA IdentityMinder para iniciar tarefas adicionais em telas de
pesquisa ou lista de modo a reduzir o nmero de etapas que os usurios executam para
concluir determinadas tarefas.
Para adicionar tarefas extras s telas de pesquisa e lista
1.

Modifique uma tela de pesquisa ou lista.


A janela Configurar a tela de pesquisa padro exibida.

2.

Adicione uma linha na seo de campos dos resultados da pesquisa, como se segue:
a.

Adicione uma nova linha clicando no cone de adio abaixo da tabela de


resultados da pesquisa.

b.

Selecione o estilo do separador.

c.

Selecione uma das opes a seguir e clique no cone de edio para configurar
as tarefas adicionais:

Link da tarefa
Exibe as tarefas adicionais como links de texto ou cones.

Menu de tarefas
Exibe um boto Ao que os usurios clicam para exibir um menu das
tarefas que eles podem executar.

106 Guia de Design do Console de Usurio

Tarefas adicionais nas telas de pesquisa e lista

3.

Se voc selecionou o Link da tarefa, execute as seguintes etapas:


a.

Especifique a tarefa que exibida quando um usurio clica no cone ou link de


tarefa no campo Tarefa padro.

b.

Especifique uma tarefa alternativa que ser exibida se os usurios no tiverem


privilgios para abrir a tarefa padro.

c.

Determine como o CA IdentityMinder abrir a tarefa marcando ou


desmarcando o campo Aninhar tarefa.
Quando essa opo selecionada, a tarefa aberta como uma tarefa aninhada.
Quando os usurios concluem a tarefa aninhada, eles retornam tela de
pesquisa ou lista.

d.

Determine se as tarefas adicionais sero exibidas como cones ou links de


texto, marcando ou desmarcando o campo cone de tarefa.
Se voc desmarcar essa opo, o CA IdentityMinder exibir a tarefa como um
link de texto.

4.

Se voc selecionou Menu de tarefas, execute as seguintes etapas:


a.

Selecione o tipo de tarefa que o CA IdentityMinder exibir no menu de tarefas.

b.

Especifique as tarefas a serem exibidas se voc tiver selecionado as opes


Incluir apenas as tarefas especificadas ou Excluir tarefas especificadas na etapa
a.

c.

Determine se o CA IdentityMinder abrir o menu de tarefas como tarefas


aninhadas marcando ou desmarcando a opo Aninhar tarefa.
Quando voc seleciona a opo Aninhar tarefa, o CA IdentityMinder retorna os
usurios para o local em que eles iniciaram a tarefa quando a tarefa adicional
concluda.

5.

Clique em OK e em Selecionar.

6.

Clique em OK e em Enviar para salvar as alteraes nas telas.

Captulo 5: Telas de pesquisa e lista 107

Captulo 6: Tarefas de autoatendimento


Esta seo contm os seguintes tpicos:
Tarefas de autoatendimento do CA IdentityMinder (na pgina 109)
Como configurar tarefas de autoatendimento (na pgina 110)
Configure a tarefa de autorregistro (na pgina 111)
Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.
(na pgina 114)
Pginas de logoff (na pgina 124)

Tarefas de autoatendimento do CA IdentityMinder


As tarefas de autoatendimento so tarefas do CA IdentityMinder que os usurios podem
usar para gerenciar seus prprios perfis. Essas tarefas so divididas em dois tipos:

Tarefas pblicas - tarefas que os usurios podem acessar sem fornecer suas
credenciais de logon. Exemplos de tarefas pblicas so tarefas de autorregistro,
senha esquecida e ID de usurio esquecida.

Tarefas protegidas - tarefas para as quais os usurios fornecem credenciais vlidas.


Os exemplos incluem tarefas para alterar senhas ou informaes do perfil. Para
obter acesso a essas tarefas, os usurios devem receber uma funo, como a
funo Autogerenciador.

A tabela a seguir lista as tarefas de autoatendimento padro, que so disponibilizadas


quando o CA IdentityMinder instalado.

Tipo de tarefa

Tarefas

Tarefa pblica

Autorregistro - permite que os usurios se registrem em um site corporativo.

Redefinio de senha esquecida - permite que os usurios redefinam uma senha


esquecida.

Senha esquecida - exibe uma senha temporria que os usurios podem usar para efetuar
logon no CA IdentityMinder. Quando os usurios efetuam logon, eles so solicitados a
inserir uma nova senha.

ID de usurio esquecida - recupera ou redefine uma ID de usurio esquecida.

Captulo 6: Tarefas de autoatendimento 109

Como configurar tarefas de autoatendimento

Tipo de tarefa

Tarefas

Tarefa protegida

Alterar minha senha - permite que os usurios redefinam sua senha.

Modificar meu perfil - mantm informaes de perfil, como endereo e nmeros de


telefone.

Modificar meus grupos - permite que os usurios se inscrevam em grupos.

Exibir minhas funes - exibe funes de um usurio.

Exibir minhas tarefas enviadas - exibe as tarefas do CA IdentityMinder que o usurio


iniciou.

Como configurar tarefas de autoatendimento


A tabela a seguir descreve as etapas para configurar as tarefas de autoatendimento para
o ambiente do CA IdentityMinder. Algumas etapas so opcionais.
Etapa

Consulte...

1. Configure um alias pblico no Management Console para permitir Guia de Configurao


que os usurios acessem tarefas pblicas, como o autorregistro, a
redefinio de senha esquecida e a ID de usurio esquecida.
2. Configure as tarefas de autoatendimento que se aplicam ao seu
ambiente.

Configure a tarefa de autorregistro (na


pgina 111)

Configure as tarefas de redefinio de


senha esquecida e de ID de usurio
esquecida. (na pgina 114)

3. Personalize as tarefas de autoatendimento para o seu ambiente.

Personalize as tarefas de autoatendimento

4. Adicione links para acessar as tarefas de autoatendimento ao seu


site corporativo.

Acesse as tarefas de autoatendimento

5. Configure a funo Autogerenciador. (Opcional).

Guia de Administrao

Por padro, a funo Autogerenciador atribuda a todos os


usurios. Execute esta etapa apenas se desejar restringir os usurios
que tm acesso funo.

110 Guia de Design do Console de Usurio

Configure a tarefa de autorregistro

Configure a tarefa de autorregistro


Para permitir o autorregistro de usurios, primeiramente certifique-se de que voc tem
um alias para tarefas pblicas para o ambiente do CA IdentityMinder. (Consulte o Guia
de Configurao.) Em seguida, configure a tarefa de autorregistro.
Observao: para evitar substituir a tarefa de autorregistro padro, crie uma cpia da
tarefa. Personalize a nova tarefa, conforme necessrio.
1.

No console de usurio, selecione Funes e tarefas, Tarefa administrativa,


Modificar tarefa administrativa.

2.

Selecione a tarefa de autorregistro.

3.

Na guia Pesquisar, selecione a tela Contrato de Licena de Usurio Final clicando em


Procurar.
Edite a tela para fornecer um ttulo adequado e um URL da mensagem.
Para o URL da mensagem, use uma pgina que voc criar para solicitar que novos
usurios concordem com as restries de licena para o aplicativo.

4.

Na guia Guias, edite as guias Perfil e Grupos, conforme necessrio:

Se o ambiente do CA IdentityMinder oferecer suporte a organizaes, fornea


uma organizao padro onde perfis de usurios autorregistrados so
armazenados (na pgina 112).

Se as tarefas padro no atenderem s suas necessidades de negcios,


personalize as telas de perfil e de lista.

Se o ambiente do CA IdentityMinder incluir suporte a senhas esquecidas ou IDs


de usurio esquecidas, adicione campos para coletar perguntas e respostas de
senha (na pgina 112).

Captulo 6: Tarefas de autoatendimento 111

Configure a tarefa de autorregistro

Configurar uma organizao padro para usurios autorregistrados


Se o ambiente do CA IdentityMinder oferecer suporte a organizaes, voc pode
especificar a organizao em que o CA IdentityMinder cria contas para usurios
autorregistrados.
Observao: para armazenar perfis para tipos de usurio diferentes, como clientes e
fornecedores, em ambientes diferentes, crie vrias tarefas de autorregistro com
diferentes organizaes padro. Por exemplo, se os clientes fizerem um autorregistro na
organizao de clientes, e os fornecedores se registrarem na organizao de
fornecedores, crie duas tarefas de autorregistro, como Registro de cliente e Registro de
fornecedor. Em cada tarefa, defina a organizao padro apropriada.
1.

V at a tela Configurar perfil da tarefa de autorregistro, se necessrio:


a.

No console de usurio, selecione Funes e tarefas, Tarefa administrativa,


Modificar tarefa administrativa.

b.

Selecione a tarefa de autorregistro.

c.

Selecione a guia Guias.

d.

Clique na seta direita ao lado da guia Perfil.

2.

Na tela Configurar perfil, clique em Procurar ao lado de Organizao padro.

3.

Selecione a organizao onde usurios devem ser criados.

4.

Salve as alteraes.

Adicionar perguntas e respostas de verificao


Para permitir que os usurios especifiquem pares de perguntas e respostas, que podem
ser usados para recuperar uma senha esquecida ou uma ID de usurio, adicione campos
de perguntas e respostas tela de autorregistro.
Observao: antes de adicionar campos de perguntas e respostas para coletar
informaes de verificao, verifique se os atributos lgicos para os pares de perguntas
e respostas esto configurados no manipulador de atributos lgicos de senha esquecida.
possvel configurar os manipuladores de atributos lgicos no console de usurio ou no
Management Console. Para obter mais informaes, consulte a ajuda online do console
que deseja usar.

112 Guia de Design do Console de Usurio

Configure a tarefa de autorregistro

Para adicionar perguntas e respostas de verificao:


1.

2.

V at a tela Configurar perfil da tarefa de autorregistro, se necessrio.


a.

No console de usurio, selecione Funes e tarefas, Tarefa administrativa,


Modificar tarefa administrativa.

b.

Selecione a tarefa de autorregistro.

c.

Selecione a guia Guias.

d.

Clique no cone Editar ao lado da guia Perfil.

Na tela Configurar perfil padro, clique no boto Procurar ao lado do campo Tela.
A tela Selecionar definio de tela exibida.

3.

Selecione o Perfil de autorregistro e clique em Copiar.

4.

Fornea um novo nome e qualificador para a tela de perfil de autorregistro


personalizada que estiver criando.
O qualificador pode conter caracteres ASCII (a-z, A-Z), nmeros (0-9) ou caracteres
de sublinhado, comeando com uma letra ou sublinhado.

5.

Adicione o nmero de linhas e os campos que voc deseja exibir para as perguntas
e respostas de verificao.
Por exemplo, se os usurios devem fornecer dois pares de perguntas/respostas,
adicione duas linhas de dois campos.

6.

Nas propriedades do campo para a primeira pergunta, selecione |Pergunta 1| na


lista de atributos disponveis. Configure as propriedades do campo, conforme
necessrio.
Observao: se o manipulador de atributos lgicos ForgottenPasswordHandler
estiver configurado para exibir uma lista de perguntas que os usurios podem
selecionar, especifique o estilo Seletor de opes.

7.

Repita a etapa 6 para cada um dos novos campos que voc adicionar.

8.

Clique em Aplicar.
A tela Selecionar definio de tela aberta novamente.

9.

Verifique se a definio de tela est selecionada e clique em Selecionar.


A tela Configurar perfil exibida.

10. Clique em OK para fechar a tela Configurar perfil e retornar guia Guias.

Captulo 6: Tarefas de autoatendimento 113

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

Configure as tarefas de redefinio de senha esquecida e de ID


de usurio esquecida.
O CA IdentityMinder inclui tarefas padro para usurios que no podem acessar suas
contas devido a um caso de esquecer a senha ou ID de usurio:

Tarefa de redefinio de senha esquecida (na pgina 114)

Tarefa de ID de usurio esquecida (na pgina 114)

possvel usar essas tarefas instaladas ou personaliz-las para atender s suas


necessidades.

Tarefa de redefinio de senha esquecida


A tarefa de redefinio de senha esquecida permite que um usurio redefina a senha
depois que o CA IdentityMinder verifica sua identidade. O CA IdentityMinder usa dois
tipos de pergunta para verificar a identidade de um usurio:

Perguntas de identificao - Determinam quem um usurio. Os exemplos incluem


nome completo, ID de usurio ou endereo de email de um usurio.

Perguntas de verificao - Confirmam a identidade de um usurio. Dependendo de


como o CA IdentityMinder estiver configurado, os usurios podem especificar suas
prprias perguntas de verificao, ou podem selecionar as perguntas a partir de
uma lista predefinida.

Na tarefa padro de redefinio de senha esquecida, um usurio deve fornecer uma ID


de usurio e responder a cinco perguntas de verificao. Cada pergunta de verificao,
que apresentada em uma tela separada, aleatoriamente selecionada de uma lista de
cinco perguntas que o usurio fornece durante o registro.
Assim que o CA IdentityMinder verifica a identidade de um usurio, uma tela onde o
usurio pode inserir uma nova senha exibida.

Tarefa de ID de usurio esquecida


Na tarefa padro de ID de usurio esquecida, um usurio deve fornecer um endereo de
email e responder a uma pergunta de verificao para exibir sua ID de usurio no
console de usurio. A pergunta de verificao, que apresentada em uma tela
separada, aleatoriamente selecionada de uma lista de cinco perguntas que o usurio
fornece durante o registro.

114 Guia de Design do Console de Usurio

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

Tarefas personalizadas de redefinio de senha esquecida e de ID de usurio


esquecida
Voc pode usar a tarefa de redefinio de senha esquecida ou de ID de usurio
esquecida instalada ou personalizar a tarefa para o seu ambiente. Voc pode:

Especificar o nmero de perguntas (na pgina 115) que os usurios devem


responder com xito para verificar sua identidade.

Determinar se os usurios fornecem suas prprias perguntas de verificao (na


pgina 115) ou se selecionam as perguntas de uma lista predefinida.

Definir a apresentao (na pgina 118) das perguntas de verificao na tela.

Exigir que os usurios forneam informaes adicionais, tais como o nmero de


previdncia social, para verificar sua identidade (na pgina 120).

Determinar como os usurios recebem sua senha (na pgina 123) ou ID de usurio
(na pgina 124).

Especificar critrios, como mais de trs tentativas de verificao com falha, para
bloquear um usurio da tarefa (na pgina 121).

Observao: a tarefa de redefinio de senha esquecida geralmente no deve ser


configurada para sincronizao de sada. A senha temporria pode no coincidir com as
regras de composio de senha em cada conta associada ao usurio de
provisionamento. Por esse motivo, o evento ForgottenPasswordEvent no est includo
nos Mapeamentos de sada de provisionamento padro.

Coletar pares de perguntas e respostas para verificao de usurio


Os usurios devem fornecer os pares de perguntas e respostas que sero usados para
verificar sua identidade.
Voc pode permitir que os usurios criem suas prprias perguntas, ou exigir que eles
selecionem as perguntas predefinidas em uma lista.
Para configurar o CA IdentityMinder para coletar pares de perguntas e respostas,
execute as seguintes aes:

Adicione campos para a coleta das perguntas e respostas para as tarefas (na
pgina 111) de autorregistro, Modificar meu perfil e Alterar minha senha.

Configurar o manipulador ForgottenPasswordHandler no console de usurio ou no


Management Console. Para obter instrues de configurao, consulte a ajuda
online do console que deseja usar.

Captulo 6: Tarefas de autoatendimento 115

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

Configurar a tarefa de redefinio de senha esquecida ou de ID de usurio


esquecida
A configurao das tarefas de redefinio de senha esquecida e de ID de usurio
esquecida semelhante.
Para configurar essas tarefas:
1.

Verifique se os seguintes itens esto configurados no Management Console:

Alias pblico
Uma sequncia de caracteres de texto que o CA IdentityMinder adiciona ao
URL para o acesso a tarefas pblicas, incluindo as tarefas de redefinio de
senha esquecida e de ID de usurio esquecida.
Observao: consulte o Guia de Configurao para obter mais informaes.

ForgottenPasswordHandler
Um manipulador de atributos lgicos que permite aos usurios criar uma ou
mais perguntas de verificao ou escolher as perguntas a partir de uma lista
predefinida.
Consulte o Guia de Programao do Java para obter mais informaes.

Observao: tambm possvel configurar o ForgottenPasswordHandler no console


de usurio. Clique no boto Ajuda no console de usurio para obter mais
informaes.
2.

No console de usurio, faa o seguinte:

Para criar uma cpia da tarefa de redefinio de senha esquecida ou de ID de


usurio esquecida (recomendado), selecione Funes e tarefas, Tarefa
administrativa, Criar tarefa administrativa. Selecione Criar cpia de uma tarefa
administrativa e procure a tarefa a ser copiada.

Para modificar a tarefa padro, selecione Funes e tarefas, Tarefa


administrativa, Modificar tarefa administrativa. Pesquise a tarefa a ser
modificada.

O CA IdentityMinder exibe as tarefas que correspondem aos critrios definidos.


3.

Selecione a tarefa de redefinio de senha esquecida ou de ID de usurio


esquecida.

4.

Na guia Pesquisar, clique em Procurar para exibir uma lista de telas para editar.

5.

Selecione uma das telas a seguir e clique em Editar:

Pesquisa de senha esquecida

Pesquisa de ID de usurio esquecida

116 Guia de Design do Console de Usurio

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

6.

Configure os itens a seguir de acordo com suas necessidades:

Identificao de tela
Determina quem um usurio. Esta a primeira tela que os usurios vero ao
acessar a tarefa de redefinio de senha esquecida ou de ID de usurio
esquecida.

Tela de verificao
Apresenta uma ou mais perguntas de verificao para os usurios.

7.

Insira o nmero de perguntas que os usurios devem responder para verificar sua
identidade.
Observao: se voc configurar o CA IdentityMinder para exibir vrias perguntas de
verificao em uma nica tela, o nmero de perguntas ser determinado pelo
manipulador de atributos lgicos associado tarefa. A configurao Nmero de
perguntas no se aplica.

8.

Configure os critrios para bloquear a tarefa de ID de usurio ou senha esquecida.

9.

Envie a tarefa.

Telas de identificao de design


A tela de identificao a primeira tela que os usurios vero ao acessar a tarefa de
redefinio de senha esquecida ou de ID de usurio esquecida.
A tela de identificao padro solicita que os usurios forneam uma ID de usurio.
Voc pode adicionar ou alterar os campos na tela de identificao para atender s suas
necessidades.
Siga estas etapas:
1.

V at a opo para configurar a tela de pesquisa de senha esquecida ou de ID de


usurio esquecida no console de usurio do CA IdentityMinder, se necessrio:
a.

Selecione Funes e tarefas, Tarefa administrativa, Modificar tarefa


administrativa.

b.

Selecione a tarefa de redefinio de senha esquecida ou de ID de usurio


esquecida.

c.

Na guia Pesquisar, clique em Procurar para exibir uma lista de telas para editar.

d.

Selecione uma das telas a seguir e clique em Editar:


Pesquisa de senha esquecida
Pesquisa de ID de usurio esquecida

2.

Digite o texto que ser exibido acima da rea onde usurios fornecem informaes
de conta no campo Prompt.

Captulo 6: Tarefas de autoatendimento 117

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

3.

Selecione a tela apropriada no campo Tela do perfil para identificao.

4.

Modifique a tela para incluir sua opo de atributos que os usurios devero inserir.

Telas de verificao de design


Depois que um usurio preencher com xito a tela de identificao, ser redirecionado
para uma tela de verificao na qual dever fornecer informaes para verificar a
identidade. O usurio pode ser solicitado a responder a uma ou mais perguntas ou
fornecer um atributo, como um nmero de previdncia social.
Se os usurios precisarem responder a vrias perguntas de verificao, o CA
IdentityMinder poder exibir essas perguntas na mesma tela ou em telas separadas.

Exibir vrias perguntas de verificao de uma vez


Se os usurios responderem a vrias perguntas para verificar sua identidade, voc
poder exibir essas perguntas em uma nica tela.
Observao: se uma nica tela exibir vrias perguntas, o nmero de perguntas que um
usurio dever responder determinado pelo nmero de pares de perguntas e
respostas que voc adicionar tela do perfil para a verificao principal, no pelo
nmero de perguntas que voc configurar na tela de pesquisa para a tarefa.
Para exibir vrias perguntas de verificao em uma nica tela:
1.

Configure o manipulador de atributos lgicos de senha esquecida para vrios pares


de perguntas e respostas.
Voc pode configurar o ForgottenPasswordHandler no console de usurio ou no
Management Console. Para obter instrues, consulte a ajuda online do console
que deseja usar.
Adicione os pares |VerifyQuestion1| , |VerifyAnswer1| de acordo com o nmero
de perguntas que deseja configurar.

2.

V at a opo para configurar a tela de pesquisa de senha esquecida ou de ID de


usurio esquecida, se necessrio.

3.

Digite o texto que aparece acima da rea onde os usurios fornecem informaes
de verificao no campo Solicitar tela de verificao principal.

118 Guia de Design do Console de Usurio

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

4.

No campo Solicitar tela de verificao principal, selecione uma definio de tela,


como a tela de verificao de senha esquecida.

5.

Modifique a definio de tela para incluir os atributos lgicos para cada um dos
pares de perguntas e respostas de verificao que sero exibidos na tela. Por
exemplo, adicione campos como a seguir:
|VerifyQuestion1| - Somente leitura.
|VerifyAnswer1| - Gravao obrigatria.
Observao: para obter mais informaes, consulte a ajuda online do manipulador
de atributos ForgottenPasswordLogical.

6.

Certifique-se de que os campos Solicitar tela de verificao secundria e Profile


Screen for Secondary Verification esto em branco na opo para configurar a tela
de pesquisa de senha esquecida ou de ID de usurio esquecida.

7.

Digite o nmero de perguntas que o usurio deve responder corretamente no


campo Nmero de perguntas.

8.

Clique em OK.

Exibir uma pergunta de verificao por vez


Para obter mais segurana, voc pode exibir apenas uma pergunta de verificao de
cada vez. As prximas perguntas sero exibidas apenas depois que a pergunta anterior
tiver sido respondida com xito.
Para exibir cada pergunta de verificao em uma pgina separada, defina uma tela de
verificao principal e uma tela de verificao secundria.
A tela de verificao principal exibida depois que os usurios fornecem uma
identificao vlida, como uma ID de usurio. Quando o usurio responde com xito a
uma pergunta na tela de verificao principal, o CA IdentityMinder exibe a tela de
verificao secundria para cada pergunta restante.
Para configurar as telas de verificao principal e secundria:
1.

Certifique-se de que os atributos lgicos |VerifyQuestion| e |VerifyAnswer| esto


configurados no manipulador de atributos lgicos ForgottenPasswordHandler.
Consulte o Guia de Programao do Java.

2.

V at uma das seguintes telas, se necessrio:

3.

Configurar Tela de pesquisa de senha esquecida

Configurar Tela de pesquisa de ID de usurio esquecida

Digite o texto que aparece acima da rea onde os usurios fornecem informaes
de verificao no campo Solicitar tela de verificao principal.

Captulo 6: Tarefas de autoatendimento 119

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

4.

No campo Solicitar tela de verificao principal, selecione uma definio de tela,


como a tela de verificao de senha esquecida.
Observao: modifique a definio de tela para incluir os atributos lgicos para
cada um dos pares de perguntas e respostas que sero exibidos na tela.

5.

Digite o texto que aparece acima da rea onde os usurios fornecem informaes
de verificao no campo Solicitar tela de verificao secundria.

6.

Selecione a tela de verificao secundria de senha esquecida tela no campo Profile


Screen for Secondary Verification.
Modifique a tela para incluir os atributos lgicos |VerifyQuestion| e
|VerifyAnswer|.
Observao: para usar uma tela de verificao secundria, preciso configurar uma
tela de verificao principal.

7.

Digite o nmero de perguntas que o usurio deve responder corretamente no


campo Nmero de perguntas.

8.

Clique em OK.

Verificar um atributo de usurio


O CA IdentityMinder pode verificar a identidade do usurio solicitando que o usurio
fornea um ou mais atributos do perfil. Voc pode exigir esses atributos alm das
perguntas de verificao ou substituir as perguntas por eles.
Para usar os atributos do usurio no processo de verificao:
1.

2.

Configure a tela de verificao, conforme descrito em uma das sees a seguir:

Exibir vrias perguntas de verificao de uma vez (na pgina 118)

Exibir uma pergunta de verificao por vez (na pgina 119)

Adicione um ou mais campos para coletar o atributo de usurio na tela de


verificao de senha esquecida ou em uma tela de verificao principal
personalizada, se voc tiver criado uma.
Por exemplo, para coletar o nmero de funcionrio de um usurio, juntamente com
uma ID de usurio, modifique a tela do perfil de identificao de senha esquecida.
Adicione uma linha contendo um nico campo antes ou depois do campo de ID de
usurio. Clique na seta para a direita para o novo campo para definir suas
propriedades.

120 Guia de Design do Console de Usurio

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

Bloquear a tarefa de redefinio de senha esquecida ou de ID de usurio


esquecida
Para proteger a tarefa de redefinio de senha esquecida ou de ID de usurio esquecida,
voc pode limitar o nmero de falhas em tentativas de verificao do usurio. Depois
que um usurio exceder o limite de tentativas mal-sucedidas, a tarefa ser bloqueada e
o usurio no poder mais acess-la.
Voc pode determinar o que o CA IdentityMinder considera uma falha de tentativa de
verificao. A definio de uma tentativa mal-sucedida pode ser muito estrita, como
responder a uma pergunta de verificao incorretamente, ou mais tolerante,
permitindo erros, como erros de digitao de uma resposta.
Observao: tambm possvel configurar o CA IdentityMinder para bloquear a tarefa
de redefinio de senha esquecida ou de ID de usurio esquecida aps um nmero
especificado de tentativas de verificao bem-sucedidas (na pgina 122). Isso impede
que os usurios usem a tarefa de redefinio de senha esquecida ou de ID de usurio
esquecida em vez de se lembrarem das credenciais de logon.

Configurar um limite de tentativas mal-sucedidas


Para configurar o CA IdentityMinder para bloquear a tarefa de redefinio de senha
esquecida ou de ID de usurio esquecida aps tentativas de verificao com falha:
1.

V at a opo para configurar a tela de pesquisa de senha esquecida, se


necessrio.

2.

Configure os critrios de falha na verificao, conforme necessrio:

Nmero aceitvel de respostas incorretas - O nmero de respostas incorretas


que um usurio pode fornecer antes que o CA IdentityMinder registre uma
falha na verificao.

Tempo limite da pgina de verificao - A quantidade de tempo que um usurio


tem para responder a todas as perguntas em uma pgina.
Limite de tentativas da pgina de verificao - O nmero de vezes que um
usurio pode tentar responder s perguntas em uma pgina.
Se somente uma pergunta for exibida por pgina, o Limite de tentativas da
pgina de verificao ser o nmero de vezes que um usurio pode tentar
responder a essa pergunta.

Observao: especifique 0 para as opes que no se aplicam.


Se um usurio exceder um dos critrios especificados, o CA IdentityMinder
registrar uma falha na verificao.

Captulo 6: Tarefas de autoatendimento 121

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

3.

No campo Limite de tentativas mal-sucedidas, digite o nmero de vezes


consecutivas que o usurio pode no ter xito no processo de verificao antes que
seja bloqueado da tarefa.
O CA IdentityMinder bloqueia o usurio da tarefa e, opcionalmente, desativa a
conta do usurio se ele tentar verificar sua identidade quando o Limite de
tentativas mal-sucedidas tiver sido atingido. Por exemplo, se o limite de tentativas
mal-sucedidas for 3, o usurio ser bloqueado e desativado na terceira tentativa
mal-sucedida.

4.

Marque a caixa de seleo Desativar usurio para desativar a conta de um usurio


alm de bloquear a tarefa quando o limite de tentativas mal-sucedidas tiver sido
excedido.

5.

No campo Durao do bloqueio aps tentativa mal-sucedida, digite por quanto


tempo o usurio ser bloqueado da tarefa se exceder o limite de tentativas
mal-sucedidas.
Voc pode especificar minutos, horas e dias. Para indicar que um determinado
limite no se aplica, digite 0.
Observao: o atributo especificado deve ser definido no arquivo de configurao
do diretrio (directory.xml) para o ambiente do CA IdentityMinder.

6.

Selecione o atributo que o CA IdentityMinder usar para acompanhar as tentativas


de verificao no campo Atributo de rastreamento de tentativa.

Configurar um limite de tentativas bem-sucedidas


Limitar o nmero de tentativas de verificao bem-sucedidas impede que o usurio faa
uso indevido da tarefa de redefinio de senha esquecida ou de ID de usurio
esquecida. Por exemplo, um usurio pode depender da tarefa de redefinio de senha
esquecida para redefinir a senha em vez de ter que se lembrar de uma senha que
atende a uma rgida poltica de senha.
Para limitar o nmero de tentativas de verificao bem-sucedidas:
1.

V at a opo para configurar a tela de pesquisa de senha esquecida, se


necessrio.

2.

Selecione o atributo que o CA IdentityMinder usar para acompanhar as tentativas


de verificao no campo Atributo de rastreamento de tentativa.

3.

Digite o nmero de dias que os usurios devem aguardar antes de usar a tarefa no
campo Limite de tentativas bem-sucedidas.

122 Guia de Design do Console de Usurio

Configure as tarefas de redefinio de senha esquecida e de ID de usurio esquecida.

Determinar como os usurios redefinem as senhas


Assim que o CA IdentityMinder verifica a identidade de um usurio na tarefa de senha
esquecida, realiza uma das seguintes aes:

Redireciona os usurios a uma tela onde possvel inserir uma nova senha.
(padro)

Envia por email ou exibe uma senha temporria. Os usurios podem usar a senha
temporria para efetuar logon no CA IdentityMinder, onde so obrigados a
configurar uma nova senha.

Para configurar o CA IdentityMinder para exibir ou enviar por email uma senha
temporria, use a tarefa de senha esquecida em vez da tarefa de redefinio de senha
esquecida.
A tarefa de senha esquecida est associada a um manipulador de tarefas de lgica de
negcios, um objeto Java que forma uma lgica de negcios personalizada, que gera
uma senha temporria.
Por padro, a tarefa de senha esquecida exibe a senha temporria no console de
usurio.
Para configurar a tarefa de senha esquecida para enviar por email a senha temporria:
1.

No Management Console, configure notificaes por email para o ambiente do CA


IdentityMinder. Consulte o Guia de Configurao para obter instrues.

2.

No console de usurio, selecione Funes e tarefas, Tarefa administrativa,


Modificar tarefa administrativa.

3.

Selecione a tarefa de senha esquecida.

4.

Na guia Perfil, clique em Manipuladores de tarefas de lgica de negcios.


A tela Manipuladores de tarefas de lgica de negcios exibida. O manipulador
BLTHGenerateTemporaryPassword deve aparecer na lista de manipuladores.

5.

Clique no cone em forma de seta para a direita para editar as propriedades do


manipulador.

6.

No campo Propriedade, clique no cone de sinal de menos para excluir a


propriedade ShowPwdOnScreen.

7.

No campo Propriedade, digite ShowPwdOnScreen novamente.

8.

No campo Valor, digite:


falso

9.

Clique em Adicionar.

Captulo 6: Tarefas de autoatendimento 123

Pginas de logoff

Determinar como os usurios recuperam uma ID de usurio esquecida


Assim que o CA IdentityMinder verifica com xito a identidade de um usurio, exibe a ID
de usurio na tela.
Para obter mais segurana, voc pode configurar o CA IdentityMinder para enviar a ID
de usurio por email.
Para configurar o CA IdentityMinder para enviar a ID de usurio por email:
1.

Configure o ambiente do CA IdentityMinder para oferecer suporte a notificaes


por email.

2.

Selecione Funes e tarefas, Tarefa administrativa, Modificar tarefa administrativa.

3.

Selecione a tarefa de ID de usurio esquecida.

4.

Na guia Perfil, clique em Manipuladores de tarefas de lgica de negcios.


A tela Manipuladores de tarefas de lgica de negcios exibida.

5.

Clique no cone Excluir ao lado do manipulador BLTHDisplayUserID para exclu-lo.


Excluir o manipulador BLTHDisplayUserID impede que o CA IdentityMinder exiba a
ID de usurio no console de usurio. Se desejar que o CA IdentityMinder exiba a ID
de usurio no console de usurio e envie a ID de usurio por email, no exclua o
manipulador BLTHDisplayUserID.

Pginas de logoff
Uma pgina de logoff uma pgina para a qual o usurio direcionado aps executar
uma ao em determinadas telas de tarefa do CA IdentityMinder, por exemplo, clicar
em um link de logoff no Console de usurio.
Para as tarefas de autoatendimento, como autorregistro ou senha esquecida, os
usurios so redirecionados para a pgina de logoff quando eles clicam em Cancelar
para sair da tarefa ou quando clicam em OK em uma mensagem de confirmao ou
erro.

124 Guia de Design do Console de Usurio

Pginas de logoff

Voc pode configurar uma pgina de logoff personalizada para as seguintes telas do CA
IdentityMinder:

Console de usurio

Tarefas de autorregistro

Tarefas de senha esquecida

Importante: Se o CA IdentityMinder integrar-se ao CA SiteMinder, configure o Agente


web do CA SiteMinder para encerrar a sesso de usurio depois que o usurio efetua
logoff no CA IdentityMinder. Se voc no configurar o Agente web, o CA SiteMinder
poder reabrir a sesso de usurio.

Configurando pginas de logoff


Siga estas etapas:
1.

Crie uma ou mais pginas de logoff personalizadas.


Para garantir que uma pgina de logoff HTML seja carregada do servidor web e no
do cache do navegador, configure a pgina de logoff de forma que ela no possa ser
armazenada em cache no navegador. Por exemplo, para pginas HTML, voc pode
adicionar as seguintes tags meta pgina:
<META HTTP-EQUIV="Pragma" CONTENT="no-cache">
<META HTTP-EQUIV="Expires" CONTENT="-1">

Importante: tags meta nem sempre funcionam com um navegador Internet


Explorer. Se no funcionarem, use um cabealho HTTP de controle por cache.
2.

Na tela de ambientes do CA IdentityMinder, clique no nome do ambiente


adequado.
A tela Environment Properties exibida.

3.

Clique em Configuraes avanadas e em Diversos.


A tela Miscellaneous Properties exibida.

4.

No campo Propriedade, digite uma das seguintes propriedades:

MainConsolelogoutUrl - substitui o URL de logoff padro no console principal.


Esse URL tambm ser exibido para tarefas de autorregistro e senha esquecida
se voc no especificar pginas de logoff personalizadas usando a propriedade
tasktagLogoutUrl.

Captulo 6: Tarefas de autoatendimento 125

Pginas de logoff

tasktagLogoutUrl - especifica uma pgina de logoff para uma tarefa pblica.


Nessa propriedade, tasktag identifica a tarefa para a qual voc est
configurando uma pgina de logoff personalizada.
Por exemplo, para configurar uma pgina de logoff para a tarefa padro de
autorregistro, insira o seguinte no campo Propriedade:
SelfRegistrationLogoutUrl
Voc pode definir vrias propriedades tasktagLogoutUrl para configurar
diferentes pginas de logoff para diferentes tarefas. Por exemplo, quando voc
tiver diferentes pginas de autorregistro para clientes e fornecedores, ser
possvel definir uma pgina de logoff diferente para cada tarefa.

Observao: especifique a tag de tarefa ao configurar uma tarefa no Console de


usurio. Para obter mais informaes, consulte o Guia de Administrao.
5.

No campo Valor, digite o URL para o qual os usurios sero redirecionados ao


efetuar logoff.

6.

Clique em Salvar.

126 Guia de Design do Console de Usurio

Captulo 7: Aplicando marca visual ao


Console de usurio

Esta seo contm os seguintes tpicos:


Capas (na pgina 127)
Componentes de uma capa (na pgina 128)
Capas do CA IdentityMinder (na pgina 129)
Associaes de capa (na pgina 132)
Como criar uma capa (na pgina 132)
Recompilar os arquivos .jsp e reiniciar o servidor de aplicativos (na pgina 136)
Como usar vrias capas (na pgina 136)
Como editar pginas do console (na pgina 139)

Capas
Os usurios do CA IdentityMinder executam a maioria das tarefas administrativas em
um console de usurio. O CA IdentityMinder inclui os seguintes consoles de usurio:

ca12 o console de usurio padro

ui7 o console de usurio em conformidade com o novo padro de interface de


usurio da CA Technologies.

imcss um console de usurio alternativo que voc pode personalizar para suas
necessidades de negcios

O nome do console adicionado ao URL para cada pgina do console. Por exemplo, os
URLs a seguir so para a tarefa Criar usurio nos consoles ca12 e imcss,
respectivamente:

http://myserver.ca.com:8080/iam/im/neteauto/ca12/index.jsp?task.tag=CreateUse
r

http://myserver.ca.com:8080/iam/im/neteauto/imcss/index.jsp?task.tag=CreateUs
er

Observao: o CA IdentityMinder gera esses URLs automaticamente, assim que um


administrador efetua logon no console de usurio.

Captulo 7: Aplicando marca visual ao Console de usurio 127

Componentes de uma capa

possvel alterar a aparncia de um console com capas. Uma capa um conjunto de


componentes que podem ser usados para personalizar a aparncia da interface de
usurio para um determinado pblico-alvo.
Voc pode alterar os seguintes aspectos:

Imagens

Cores e fontes

Cabealhos e rodaps de pgina

No ambiente do CA IdentityMinder, voc pode ter mais de uma capa, assim como pode
criar capas diferentes para diferentes pblicos-alvo. Por exemplo, os funcionrios
podem ver uma capa e os parceiros podem ver outra.

Componentes de uma capa


Os componentes de uma capa so os seguintes:
Folha de estilos em cascata
Define os arquivos CSS que contm as definies de cor e fonte.
Local:
iam_im.ear/user_console_war/app/imcss/nome_da_capa/nome_do_arquivo.css *

Imagens
Define um arquivo de imagens grficas que pode ser exibido em uma pgina da
web, como um arquivo .gif, .jpeg ou .png.
Local:
iam_im.ear/user_console_war/app/imcss/nome_da_capa/image/*

arquivo .properties
Define o arquivo de texto que define os componentes para a capa.
Local:
iam_im.ear/user_console_war/app/imcss/nome_da_capa/

Iam_im.ear
Define um dos seguintes locais de instalao do diretrio Iam_im.ear:

WebLogic:
base_do_WebLogic\user_projects\domains\Nome-de-domnio-do-IdentityManager\applications\iam_im.ear\

128 Guia de Design do Console de Usurio

Capas do CA IdentityMinder

JBoss:
base_do_JBoss\verso_do_jboss\server\default\deploy\iam_im.ear\

WebSphere:
dir_ferramentas_was_im\WebSphere-ear\iam_im.ear\

dir_ferramentas_was_im
Define o local de instalao das ferramentas do CA IdentityMinder para o
WebSphere.
Observao: depois de fazer alteraes no diretrio WebSphere-ear\iam_im.ear,
voc dever empacotar o diretrio em um arquivo EAR (Enterprise Archive) e
instalar o arquivo EAR no Servidor de aplicativos do WebSphere. Para obter mais
informaes, consulte o Guia de Instalao.

Capas do CA IdentityMinder
O CA IdentityMinder inclui as seguintes capas:

idm define os componentes do Console de usurio idm padro. Os componentes


de capa que no so definidos pelas capas personalizadas so padronizados para os
componentes do idm. Por exemplo, se uma capa no incluir um arquivo CSS
personalizado, o CA IdentityMinder usar o arquivo CSS padro da capa idm.

Captulo 7: Aplicando marca visual ao Console de usurio 129

Capas do CA IdentityMinder

Essa capa instalada na seguinte pasta:


iam_im.ear/user_console_war/app/imcss/idm
A ilustrao a seguir mostra o Console de usurio idm:

horizontal define os componentes do Console de usurio horizontal, como


mostrado na ilustrao a seguir:

130 Guia de Design do Console de Usurio

Capas do CA IdentityMinder

Essa interface semelhante capa idm, mas exibe as opes de menu em um


formato horizontal.
Essa capa instalada na seguinte pasta:
iam_im.ear/user_console_war/app/imcss/horizontal

horizontal2 define os componentes do Console de usurio horizontal2, como


mostrado na ilustrao a seguir:

Essa interface semelhante capa horizontal, mas exibida nas cores verde e roxo
cores no mesmo formato horizontal.
Essa capa instalada na seguinte pasta:
iam_im.ear/user_console_war/app/imcss/horizontal2

neteauto define os componentes do Console de usurio neteauto, como


mostrado na ilustrao a seguir:

Captulo 7: Aplicando marca visual ao Console de usurio 131

Associaes de capa

Essa interface tem o mesmo layout da capa idm, mas exibida nas cores vermelho
e marrom-claro com a imagem da NeteAuto.
Essa capa instalada na seguinte pasta:
iam_im.ear/user_console_war/app/imcss/neteauto
Este captulo usa a capa neteauto para fins de demonstrao.
Observao: as capas nas vrias ilustraes se aplicam ao console imcss.

Associaes de capa
A capa pode herdar propriedades de uma capa pai. Portanto, voc pode definir um
componente uma vez e reutiliz-lo em vrias capas. Por exemplo, o logotipo de uma
empresa, definido em uma capa pai, pode se propagar em todas as capas da empresa.
Quando o CA IdentityMinder renderiza um console de usurio, ele verifica a capa
apropriada para o usurio. Quando uma capa pai especificada, seus componentes so
adicionados.
Por exemplo, suponha que a capa corporativa inclua apenas o logotipo da empresa.
Uma capa de vendas inclui um rodap personalizado JSP e aponta para a capa pai,
corporativa. Quando representantes de vendas acessam o CA IdentityMinder, eles
visualizam o rodap definido na capa de vendas, e o logotipo, as cores e as fontes
definidos na capa corporativa.

Como criar uma capa


A criao de uma capa envolve as seguintes etapas:
1.

Copiar uma capa existente

2.

Atualizar as imagens da capa

3.

Atualizar as cores e fontes da capa

4.

Modificar o arquivo .properties

5.

Modificar o arquivo index.jsp

132 Guia de Design do Console de Usurio

Como criar uma capa

Copiar uma capa existente


Execute o procedimento a seguir para copiar um capa existente.
Siga estas etapas:
1.

Examine as ilustraes em Capas do CA IdentityMinder e decida quais das seguintes


capas semelhante a que voc deseja criar para a sua empresa:

capa idm

capa horizontal

capa horizontal2

capa neteauto

Para fins ilustrativos, esta seo pressupe que voc escolheu a aparncia da capa
neteauto e a chamar de yourskin. O nome yourskin o nome da capa da sua
empresa.
2.

Copie o seguinte arquivo:


iam_im.ear/user_console_war/app/imcss/neteauto
iam_im.ear/
D a ele o seguinte nome:
iam_im.ear/user_console_war/app/imcss/yourskin

3.

No diretrio yourskin, renomeie os arquivos na tabela a seguir:

Nome atual

Novo nome

neteauto.css

yourskin.css

neteauto_task.css

yourskin_task.css

neteauto.properties

yourskin.properties
Para simplificar a administrao, o nome do arquivo .properties e dos arquivos .css
deve corresponder ao nome da capa.
Observao: os nomes de capa diferenciam maisculas de minsculas.

Atualizar as imagens da capa


Atualize todas as imagens (.gif, .jpg ou .png) nos seguintes diretrios com as imagens
que correspondem aparncia da capa da sua empresa:

iam_im.ear/user_console_war/app/imcss/yourskin/image

iam_im.ear/user_console_war/app/imcss/yourskin/image/category

Captulo 7: Aplicando marca visual ao Console de usurio 133

Como criar uma capa

iam_im.ear/user_console_war/app/imcss/yourskin/image/tab

iam_im.ear/user_console_war/app/imcss/yourskin/image/tasks

Por exemplo, para colocar o logotipo da empresa na capa yourskin, substitua logo.jpg no
diretrio image pelo logotipo da empresa.
Aconselhamos usar os mesmos nomes de arquivos de imagem, pois muitas dessas
imagens j esto mapeadas com os caminhos apropriados no arquivo
yourskin.properties.

Atualizar as cores e fontes da capa


Atualize as folhas de estilos em cascata da capa yourskin com as fontes, o menu, o plano
de fundo, a margem e outras cores de sua preferncia.
Os caminhos para as folhas de estilos so os seguintes:

iam_im.ear/user_console_war/app/imcss/yourskin/yourskin.css

iam_im.ear/user_console_war/app/imcss/yourskin/yourskin_task.css

Modificar o arquivo .properties


Execute o procedimento a seguir para modificar o arquivo .properties.
Siga estas etapas:
1.

No arquivo yourskin.properties, substitua cada referncia neteauto por yourskin.

2.

Faa as seguintes modificaes adicionais no arquivo yourskin.properties:


a.

Se ainda no estiver especificado, defina o seguinte na seo pai:


parent=/app/imcss/idm/im.properties

A seo pai especifica o local para o arquivo de propriedades da capa pai.


Nesse exemplo, a capa pai idm.
b.

Defina as folhas de estilos em cascata como se segue:


stylesheet/skin.css=yourskin/yourskin.css
stylesheet/skin_task.css=yourskin/yourskin_task.css

134 Guia de Design do Console de Usurio

Como criar uma capa

c.

Proceda da seguinte maneira:


Se voc substituiu a imagens da capa sem renome-las, pule para a Etapa d. Se
voc renomeou as imagens, faa o seguinte:

Na seo de imagens de cabealho, defina o caminho para as imagens de


cabealho em Atualizar as imagens da capa (na pgina 133).
Voc pode adicionar vrias entradas de imagem ao arquivo .properties
incluindo uma entrada como esta:
image/logo.gif=yourskin/image/logo.jpg

d.

Na seo de guias padro, defina o caminho para as imagens de guia em


Atualizar as imagens da capa (na pgina 133).

Na seo de botes do corpo da tarefa, defina o caminho para as imagens


do boto do corpo da tarefa em Atualizar as imagens da capa (na
pgina 133).

Salve o arquivo.

Modificar o arquivo index.jsp


Execute o procedimento a seguir para modificar o arquivo index.jsp.
Siga estas etapas:
1.

Abra o arquivo index.jsp em um editor de texto. Esse arquivo est localizado na


seguinte pasta:
<iam_im.ear>/user_console_war/app/imcss

2.

Na seo <skin:update>, adicione o seguinte como a primeira entrada:


<skin:skin name="yourskin" filename="/app/imcss/yourskin/yourskin.properties"
/>

3.

Salve o arquivo.

O CA IdentityMinder seleciona a capa padro do Console de usurio do CA


IdentityMinder com base na tag de capa listada primeiro na seo <skin:update> do
arquivo index.jsp.

Captulo 7: Aplicando marca visual ao Console de usurio 135

Recompilar os arquivos .jsp e reiniciar o servidor de aplicativos

Conforme observado na seo <skin:update> a seguir do arquivo index.jsp, o CA


IdentityMinder exibir o console de usurio para a capa yourskin:
<skin:update>
<skin:skin name="yourskin" filename="/app/imcss/yourskin/yourskin.properties"
/>
<skin:skin name="idm" filename="/app/imcss/idm/im.properties" />
<skin:skin name="neteauto" filename="/app/imcss/neteauto/neteauto.properties"
/>
<skin:skin name="horizontal"
filename="/app/imcss/horizontal/horizontal.properties" />
<skin:skin name="horizontal2"
filename="/app/imcss/horizontal2/horizontal2.properties" />
</skin:update>

Quando voc desejar usar outra capa, ser preciso alterar a ordem das tags de capa
listadas.

Recompilar os arquivos .jsp e reiniciar o servidor de aplicativos


Se voc estiver executando o CA IdentityMinder em um servidor de aplicativos do JBoss,
ser necessrio recompilar os arquivos JSP e reiniciar o servidor de aplicativos depois
que voc tiver criado uma capa, como se segue:
1.

Configure o servidor de aplicativos para recompilar todos os arquivos console.jsp


(na pgina 197).

2.

Reinicie o servidor de aplicativos para que as alteraes da capa yourskin entrem


em vigor.

Observao: se voc estiver usando um servidor de aplicativos diferente, no ser


necessrio concluir essa etapa.

Como usar vrias capas


Talvez voc queira que diferentes conjuntos de usurios vejam capas diferentes. Por
exemplo, a capa para os funcionrios pode incluir o logotipo da empresa e cores. A capa
para fornecedores pode incluir um logotipo e um esquema de cores diferentes, bem
como exibir um rodap especfico da empresa.
Observao: essa funcionalidade exige a integrao com o CA SiteMinder, um
componente opcional.

136 Guia de Design do Console de Usurio

Como usar vrias capas

Se o CA IdentityMinder integrar-se ao CA SiteMinder, ser possvel usar uma resposta


do CA SiteMinder para associar a capa yourskin a um conjunto de usurios. A resposta
emparelhada com uma regra em uma poltica, que est associada a um conjunto de
usurios. Quando a regra acionada, ela dispara a resposta para passar informaes
sobre a capa ao CA IdentityMinder para criao do console de usurio.
As etapas a seguir so envolvidas:
1.

Um usurio tenta acessar um ambiente do CA IdentityMinder. (Um ambiente do CA


IdentityMinder protegido pelo CA SiteMinder.)

2.

O CA SiteMinder autentica e autoriza o usurio. A regra na poltica acionada,


disparando uma resposta que contm informaes sobre a capa.

3.

A resposta transmitida como uma varivel de cabealho HTTP ao CA


IdentityMinder por meio do Agente web.

4.

O CA IdentityMinder cria o Console de usurio com base na capa.

Priorizar capas
Vrias polticas (e, consequentemente, vrias capas) podem ser aplicadas a um nico
usurio. Para se certificar de que o usurio ver a capa correta, atribua nmeros de
prioridade a capas.
Quando voc cria uma resposta de capa, adiciona o nmero de prioridade ao nome da
varivel de cabealho. O nmero de prioridade pode variar de 1 a 999, sendo que 1
indica a prioridade mais alta.
Por exemplo, o nome da varivel de cabealho na resposta para a capa de vendas
skin3. Para a capa de gerenciamento, o nome da varivel de cabealho skin2. Quando
um usurio efetua logon no CA IdentityMinder como um gerente de vendas, a capa de
gerenciamento exibida, pois ela tem uma prioridade mais alta.

Captulo 7: Aplicando marca visual ao Console de usurio 137

Como usar vrias capas

Criar uma resposta de capa


Execute o procedimento a seguir para criar uma resposta de capa.
Siga estas etapas:
1.

Efetue logon em uma das interfaces a seguir como um administrador com


privilgios de domnio:

No CA SiteMinder Web Access Manager r12 ou superior, efetue logon na


Interface de usurio administrativa.

No CA eTrust SiteMinder 6.0 SP5, efetue logon na Interface de usurio do


servidor de polticas.

Observao: para obter informaes sobre como usar essas interfaces, consulte a
documentao da verso do CA SiteMinder que voc est usando.
2.

Localize a poltica de domnio que protege o ambiente do CA IdentityMinder. O


nome do domnio tem o seguinte formato:
nome_do_ambienteDomain

nome_do_ambiente
Define o nome do Ambiente do CA IdentityMinder.
Por exemplo, quando o nome do ambiente do CA IdentityMinder for funcionrios, o
nome do domnio ser funcionriosDomain.
Observao: a poltica de domnio deve estar associada ao diretrio de usurios
que contm os usurios do CA IdentityMinder que usaro a capa.
3.

Exiba os realms para o domnio.


Voc ver os seguintes realms dependendo dos recursos configurados para o
ambiente:

nome_do_ambiente_ims_realm protege o Ambiente do CA IdentityMinder.

nome_do_ambiente_pub_realm ativa o suporte para tarefas pblicas, como


tarefas de autorregistro e senha esquecida.
Esse realm ser exibido apenas quando voc tiver configurado um alias pblico.

4.

Crie uma regra em cada um dos realms. Especifique o seguinte:

Recurso: /*

Aes: GET, POST

Para simplificar a administrao, inclua a capa no nome da regra. Por exemplo,


quando o nome da capa for yourskin, crie uma regra chamada capa yourskin.

138 Guia de Design do Console de Usurio

Como editar pginas do console

5.

Crie uma resposta para o domnio com os seguintes atributos de resposta:

Atributo: WebAgent-HTTP-Header-Variable
Isso adiciona um novo cabealho HTTP resposta.

Tipo de atributo: Esttico

Nome da varivel: insira um dos seguintes nomes de varivel:

6.

skin use essa varivel quando todos os usurios do CA IdentityMinder


visualizam a mesma capa.

skinx use essa varivel se voc tiver vrias capas. O x representa um


valor de prioridade onde 1 a prioridade mais alta e 999 a prioridade
mais baixa.

Valor da varivel: especifique o nome da capa.

Crie uma poltica no domnio de poltica com os seguintes valores:

Usurios: especifique os usurios que devero ver a capa. Por exemplo, se os


integrantes da organizao de vendas devem ver a capa, certifique-se de incluir
ou=sales na poltica.

Regras: adicione a regra criada na Etapa 4. Associe cada regra resposta que
voc criou na etapa 5.

Como editar pginas do console


Para alterar o layout do Console de usurio ou para adicionar links aos cabealhos ou
rodaps de uma pgina, voc poder editar as pginas de console a seguir:

index.jsp (na pgina 141) oculta ou exibe cabealhos e rodaps no console


principal. Tambm define as capas do CA IdentityMinder disponveis.
O arquivo index.jsp est localizado em <iam_im.ear>
/user_console_war/app/imcss/

head.jsp (na pgina 140) contm o cdigo do cabealho na pgina principal do


Console de usurio.

home.jsp contm a mensagem de confirmao para uma tarefa especfica.


Os arquivos head.jsp e home.jsp esto localizados em <iam_im.ear>
/user_console_war/app/imcss/component

Observao: se o CA IdentityMinder for executado em um servidor de aplicativos do


JBoss, voc dever recompilar os JSPs (na pgina 197)manualmente que voc modifica
antes que as alteraes entrem em vigor.

Captulo 7: Aplicando marca visual ao Console de usurio 139

Como editar pginas do console

Como modificar o cabealho no Console de usurio do CA IdentityMinder


Voc usa o arquivo head.jsp (localizado em
<iam_im.ear>/user_console_war\app\imcss\component) para modificar o cabealho no
Console de usurio. O cabealho pode conter imagens, links, ttulo, cores e fontes. A
ilustrao a seguir mostra os marcadores <div id> no arquivo head.jsp, que geram o
cabealho da capa idm:

Para atualizar o cabealho, modifique o cdigo das seguintes entradas no arquivo


head.jsp:

<div id="title">

<div id="logo">

<div id="statusbar">

<div id="username">

<div id="help-logout">

Por exemplo, para alterar o link para o qual os usurios so direcionados quando clicam
na imagem de logotipo que aparece no cabealho do Console de usurio, substitua o
URL no cdigo a seguir pelo URL da pgina inicial da sua empresa.
<div id="logo">
<a href="http://www.yourcompany.com/"><skin:img altKey="console.logo"
titleKey="console.logo" src="logo.gif" width="93" height="33" border="0" /></a>
</div>

Observao: depois de modificar o arquivo head.jsp, certifique-se de recompilar os


arquivos .jsp (na pgina 136).

140 Guia de Design do Console de Usurio

Como editar pginas do console

Como modificar e mostrar o rodap


Para modificar e mostrar o rodap, voc pode fazer o seguinte:

Insira o cdigo HTML do rodap no arquivo index.jsp (localizado em


iam_im.ear/user_console_war/app/imcss).

Modifique o arquivo da folha de estilos em cascata de uma das capas idm,


horizontal, horizontal2 e neteauto para que o CA IdentityMinder exiba o rodap.

Inserir o HTML do rodap no arquivo index.jsp


Execute o procedimento a seguir para inserir o HTML do rodap no arquivo index.jsp.
Siga estas etapas:
1.

Abra o arquivo index.jsp em um editor de texto.

2.

Na seo <div id="foot"> no fim do arquivo, adicione o HTML do rodap da capa


yourskin entre o marcadores <div> e </div>.

3.

Salve o arquivo.

Modificar a folha de estilos em cascata para exibir um rodap


Use o arquivo da folha de estilos em cascata de cada capa idm, horizontal,
horizontal2 e neteauto para configurar o CA IdentityMinder para exibir o rodap ou
no. Esses arquivos de folha de estilos em cascata so armazenados na seguinte pasta:
iam_im.ear/user_console_war/app/imcss/

Por padro, o rodap mostrado nas capas horizontal e horizontal2, mas no nas capas
idm ou neteauto.
Atualmente, a capa yourskin no exibe o rodap porque uma cpia de neteauto, que
usa o arquivo idm.css para exibir rodaps. Os arquivos neteauto.css e yourskin.css
contm somente substituies de cor e importam o arquivo idm.css para manipular
outras funes de exibio, como mostrar rodaps. Na capa idm, que mostrada como
se segue, a seo #foot no arquivo idm.css mostra o rodap como desativado:
#foot {
display: none;

Na capa horizontal, que mostrada como se segue, a seo #foot no arquivo


horizontal.css mostra o rodap como ativado:
#foot {
border: 1px solid black;
background-color: #AEB6D8;
padding: 4px;
display: block; /* to override parent */

Captulo 7: Aplicando marca visual ao Console de usurio 141

Como editar pginas do console

A referncia display: block significa que o CA IdentityMinder exibe o rodap.


Para que a capa yourskin exiba o rodap:

Em yourskin.css, adicione o seguinte cdigo:


/*CONSOLE FOOTER*/
#foot {
display: block;
}

Nessa seo, tambm possvel modificar a borda no rodap, a cor do plano de fundo e
o preenchimento.

142 Guia de Design do Console de Usurio

Captulo 8: Ajuda personalizada


O CA IdentityMinder permite criar sua prpria ajuda personalizada para tarefas e guias
que voc personalizou no Console de usurio. Para implementar a ajuda personalizada,
voc pode criar um sistema de ajuda contextual com arquivos de ajuda HTML
personalizados ou pginas Wiki e redirecionar links de ajuda no Console de usurio para
acessar sua ajuda personalizada.
Esse recurso tambm permite traduzir qualquer ajuda padro (escrita em ingls) em
outro idioma.
Esta seo contm os seguintes tpicos:
Como a ajuda personalizada funciona (na pgina 143)
Como a ajuda determina quais links usar (na pgina 145)
Como personalizar a ajuda (na pgina 146)
Exemplos de como usar a ajuda personalizada (na pgina 146)

Como a ajuda personalizada funciona


O CA IdentityMinder usa pacotes de recursos para substituir arquivos de ajuda padro e
para fornecer a capacidade de vnculo ajuda contextual personalizada.
Usando o formato definido, voc pode criar um pacote de recursos e coloc-lo no
iam_im.ear. Quando um usurio clicar em um link de ajuda, o CA IdentityMinder
pesquisar os pacotes de recursos aplicveis para encontrar correspondncias com a
ajuda personalizada. Se no houver nenhuma correspondncia com a ajuda
personalizada, o CA IdentityMinder fornecer a ajuda padro ao usurio.
Se um usurio estrangeiro clicar em um link de ajuda e um pacote de recursos especfico
ao idioma tiver sido criado, o CA IdentityMinder verificar as configuraes de
localidade do navegador do usurio e abrir o link de ajuda especfico ao idioma. Se no
houver nenhuma correspondncia no pacote de recursos especfico ao idioma, o
usurio ser direcionado ajuda padro em ingls.
Observao: o contedo nas pginas personalizadas no exibido quando voc
pesquisa a ajuda padro ou exibe o ndice da ajuda.

Captulo 8: Ajuda personalizada 143

Como a ajuda personalizada funciona

Formato da ajuda personalizada


O pacote de recursos do link de ajuda usa um par de chave/valor para determinar qual
pgina de ajuda direcionar o usurio. Para a ajuda personalizada, as tags so usadas
para IDs de chave e o URL da pgina da web personalizada o valor. A sintaxe para o
pacote de recursos do link da ajuda pode ser uma das seguintes:
TaskTag.PageTag=Help URL
TaskTag.@PageDefinitionTag=Help URL

A tag o identificador exclusivo de uma tarefa, tela ou guia. Os parmetros do par de


chave/valor so definidos como mostrados a seguir:
Tag da tarefa
A tag da tarefa ativa.
Tag da pgina
A tag de pesquisa ou guia ativa.
Tag de definio de pgina
A tag de definio de pesquisa ou definio de guia ativa.
URL da ajuda
O URL da ajuda um URL absoluto (http://www.neteauto.com) ou um URL relativo
que aponta para o contedo no servidor do CA IdentityMinder
(/iam/im/help/customhelp.html)
Exemplo:
ModifyUser.Profile=/iam/im/userprofile.html

Expresses da ajuda personalizada


As expresses a seguir tm significado especfico quando usadas em pacotes de
recursos de ajuda personalizada:

Expresso

Significado

Usada para correspondncia de qualquer tag de tarefa, tag de pgina ou tag de definio de
pgina.

${task}

Usada no URL da ajuda. Substituda pela tag de tarefa da pgina ativa.

${page}

Usada no URL da ajuda. Substituda pela tag de pgina da pgina ativa.

${pagedef}

Usada no URL da ajuda. Substituda pela tag de definio de pgina da pgina ativa.

144 Guia de Design do Console de Usurio

Como a ajuda determina quais links usar

Exemplo:
*.*=http://www.help.com/Wiki.jsp?page=${task}_${page}

As expresses $task e $page so substitudas pela tag de tarefa e tag de pgina da


pgina da web atual na qual o usurio clicou no link de ajuda. Por exemplo, se um
usurio clicar no link de ajuda na guia Perfil da tarefa Criar grupo, o URL de ajuda dever
abrir a seguinte pgina de ajuda:
http://www.help.com/Wiki.jsp?page=CreateGroup_Profile

Como a ajuda determina quais links usar


Quando um usurio clica em um link de ajuda, o CA IdentityMinder executa verificaes
para determinar qual URL de ajuda ser usado. Essas verificaes so realizadas para o
mais caso especfico e depois se tornam mais gerais. O pacote com a melhor
correspondncia ao local do usurio ser usado.
A ordem das verificaes de um link de ajuda a seguinte:
1.

[TaskTag].[PageTag]

2.

[TaskTag].@[PageDefinitionTag]

3.

*.[PageTag]

4.

*.@[PageDefinitionTag]

5.

[TaskTag].*

6.

*.*

Exemplo:
*.*=http://www.help.com/Wiki.jsp?page=${task}_${page}

Corresponde a tudo sem uma correspondncia mais especfica e inclui tags de tarefa e
pgina ativas no link de ajuda gerado.
Exemplo:
ModifyUser.Profile=/iam/im/userprofile.html

Corresponde guia Perfil na tarefa Modificar usurio e direciona o usurio para o URL
relativo /iam/im/userprofile.html
Exemplo:
*.@Profile=/iam/im/profile.html

Corresponde a todas as guias que so derivadas da definio da guia Perfil sem uma
correspondncia mais especfica e direciona os usurios para o URL relativo
/iam/im/profile.html.

Captulo 8: Ajuda personalizada 145

Como personalizar a ajuda

Como personalizar a ajuda


A ajuda personalizada permite fornecer pginas de ajuda especficas a seus usurios ao
acessar ambientes localizados ou altamente personalizados do CA IdentityMinder.
Siga estas etapas:
1.

Crie pginas de ajuda personalizada e hospede-as em um site.

2.

Crie um pacote de recursos com IDs de chave mapeadas para as pginas de ajuda
personalizada. Denomine o pacote de recursos como se segue:
help_NomeDoAmbiente_identificadordeidioma.properties

Observao: o identificador de idioma uma abreviao de dois caracteres


opcional para um idioma especfico.
3.

Coloque o arquivo .properties no diretrio


iam_im.ear/config/com/netegrity/config.
Observao: caso voc esteja localizando a ajuda para mais de um idioma, crie um
pacote de recursos para cada idioma.

4.

Reinicie o servidor do CA IdentityMinder.


Sua ajuda personalizada substituir a ajuda padro quando os usurios clicarem nos
links de ajuda no Console de usurio do CA IdentityMinder.

Para ajuda internacionalizada, os usurios que definiram as preferncias de localidade


do navegador para outro idioma sero direcionados para a ajuda personalizada
apropriada.

Exemplos de como usar a ajuda personalizada


Esta seo fornece alguns exemplos de como a ajuda personalizada pode atender s
suas necessidades de negcios e aos requisitos de localizao.

Exemplo: personalizar a ajuda


Um cliente implantou um ambiente do CA IdentityMinder com telas totalmente
personalizadas para Usurios, Grupos e Organizaes. Infelizmente, o contedo da
ajuda esttico e se refere apenas ao ambiente padro. Ele deseja escrever seu prprio
contedo de ajuda para refletir a personalizao em seu ambiente.
Siga estas etapas:
1.

Escreva pginas de ajuda personalizada para cada tarefa e guia personalizada.

2.

Hospede as pginas em um site.

146 Guia de Design do Console de Usurio

Exemplos de como usar a ajuda personalizada

3.

Crie um pacote de recursos e coloque o arquivo .properties no diretrio


iam_im.ear/config/com/netegrity/config.

4.

Reinicie o servidor do CA IdentityMinder.

Por exemplo, se o nome do ambiente for neteauto, crie o seguinte pacote de recursos
chamado help_neteauto.properties:
*.UserProfile=http://www.neteauto.com/imhelp/user.html
*.GroupProfile=http://www.neteauto.com/imhelp/group.html
*.OrgProfile=http://www.neteauto.com/imhelp/org.html
Os links de ajuda para o ambiente neteauto acessam a ajuda padro, exceto para as
guias Perfil nas tarefas Modificar usurio, Modificar organizao e Modificar grupo.

Exemplo: criar ajuda wiki


Um cliente tem um ambiente do CA IdentityMinder altamente personalizado e deseja
fornecer aos usurios acesso a um avanado sistema de ajuda contextual. Ele deseja
criar um wiki para seu ambiente que esteja disponvel aos usurios por meio de links de
ajuda.
Siga estas etapas:
1.

Escreva o contedo wiki para seu ambiente personalizado.

2.

Crie um pacote de recursos e coloque o arquivo .properties no diretrio


iam_im.ear/config/com/netegrity/config. O pacote de recursos deve ter uma
entrada nica:
*.*=http://www.neteauto.com/wiki.jsp?page=${task}-${page}

Os links de ajuda iniciam o wiki com uma pgina especfica para a tarefa e guia.
3.

(Opcional) Se a pgina ainda no tiver sido criada, o usurio poder inserir os


detalhes da tarefa e da guia.

4.

Reinicie o Servidor do CA IdentityMinder.

Captulo 8: Ajuda personalizada 147

Exemplos de como usar a ajuda personalizada

Exemplo: localizar a ajuda


Um cliente no Japo adquiriu uma verso localizada do CA IdentityMinder. Infelizmente,
toda a ajuda est em ingls. Ele deseja escrever sua prpria ajuda em japons e
implement-la no seu Console de usurio.
Siga estas etapas:
1.

Escreva pginas de ajuda personalizada para cada tarefa e guia.

2.

Hospede as pginas de ajuda personalizada em um site.

3.

Crie um pacote de recursos e coloque o arquivo .properties no diretrio


iam_im.ear/config/com/netegrity/config.
Por exemplo, se o nome do ambiente for neteauto, crie o seguinte pacote de
recursos chamado help_neteauto.properties:
ModifyUser.*=http://www.neteauto.jp/modifyuser.html
ModifyGroup.*=http://www.neteauto.jp/modifygroup.html

4.

Reinicie o Servidor do CA IdentityMinder.


Os links de ajuda no Console de usurio redirecionaro para as pginas de ajuda
personalizada, especficas do idioma que esto hospedadas no site
www.neteauto.jp.

Exemplo: internacionalizar a ajuda


Uma empresa internacional comprou o CA IdentityMinder e deve oferecer suporte aos
usurios em ingls, espanhol e francs. Ela pode internacionalizar seus ambientes do CA
IdentityMinder, mas a ajuda est escrita em ingls. Ela deseja escrever uma verso da
ajuda em cada idioma e disponibilizar a ajuda correta de acordo com o idioma exigido
pelo usurio.
Siga estas etapas:
1.

Escreva pginas de ajuda personalizada para cada tarefa e guia, e em cada idioma.

2.

Hospede as pginas de ajuda personalizada em um site.

148 Guia de Design do Console de Usurio

Exemplos de como usar a ajuda personalizada

3.

Crie dois pacotes de recursos especficos de local e coloque os arquivos .properties


no diretrio iam_im.ear/config/com/netegrity/config.
Por exemplo, se o ambiente denominado neteauto, crie dois pacotes de recursos
como help_neteauto_es.properties (para espanhol) e help_neteauto_fr.properties
(para francs).

4.

Reinicie o Servidor do CA IdentityMinder.


Os usurios com suas preferncias de localidade do navegador definidas para
Espanhol e Francs so direcionados para a ajuda personalizada adequada em seu
idioma. Todos os outros usurios sero direcionados para a ajuda de usurio padro
em ingls.

Captulo 8: Ajuda personalizada 149

Captulo 9: Localizao do CA
IdentityMinder
Esta seo contm os seguintes tpicos:
Introduction (na pgina 151)
Pacotes de recursos (na pgina 151)
Exemplo de ambientes localizadas do CA IdentityMinder (na pgina 154)
Restries sobre o uso dos conjuntos de caracteres internacionais (na pgina 155)
Como configurar o suporte para localizao (na pgina 156)
Como exibir o CA IdentityMinder em outro idioma (na pgina 165)
Definir o cabealho HTTP imlanguage em uma resposta do CA SiteMinder (na pgina
166)

Introduction
possvel localizar os seguintes elementos no Console de usurio para um idioma
especfico:

Prompts, botes, texto, guias e ttulos que aparecem no Console de usurio

Mensagens de validao, status e erro, bem como instrues que so exibidas aos
usurios do CA IdentityMinder

Notificaes por email

Grficos

Recursos personalizados criados com as APIs do CA IdentityMinder

Observao: os relatrios do CA IdentityMinder no so localizados.

Pacotes de recursos
Um pacote de recursos uma arquivo do CA IdentityMinder que associa elementos da
interface de usurio a sequncias de caracteres de texto especficas de local. Nesse
arquivo, um elemento da interface de usurio recebe uma ID de chave, que
combinada com uma sequncia de caracteres de texto especfica de local.
Quando o CA IdentityMinder encontra um elemento com uma ID de chave em uma tela,
como uma tela de perfil de tarefa administrativa, ele exibe o valor combinado do pacote
de recursos.

Captulo 9: Localizao do CA IdentityMinder 151

Pacotes de recursos

Por exemplo, a entrada de um boto Enviar em um pacote de recursos do CA


IdentityMinder a seguinte:
global.button.submit=Submit

A ID de chave global.button.submit e o valor Submit. Quando o CA IdentityMinder


encontra a ID de chave global.button.submit em uma definio de tela da interface do
usurio, ele exibe a palavra Submit.
Observe o seguinte sobre as IDs de chave:

Elementos no Console de usurio podem ter apenas uma ID de chave, que deve ser
exclusiva para um determinado pacote de recursos.

152 Guia de Design do Console de Usurio

Pacotes de recursos

As IDs de chave diferenciam maisculas e minsculas, devem conter apenas


caracteres US-ASCII e no podem conter espaos. No entanto, as IDs de chave
podem conter vrias sequncias de caracteres separadas por pontos (.). Por
exemplo, a ID de chave para o nome de campo Departamento pode se parecer com
esta:
attribute.displayname.department

O CA IdentityMinder oferece suporte a dois formatos para especificar as IDs de


chave nas telas de tarefa administrativa:

Usar uma sintaxe que inclua o nome do pacote de recursos


Esse mtodo permite que voc especifique o nome de um pacote de recursos
personalizado. Voc pode usar um pacote de recursos personalizado para
separar mapeamentos personalizados do pacote de recursos padro.
O formato para essa sintaxe o seguinte:
${bundle=PacoteRecursos:key=IDchave}
Nesse exemplo de sintaxe:
bundle=PacoteRecursos
Identifica o pacote de recursos que inclui o mapeamento da sequncia de
caracteres de texto para a ID de chave, se voc estiver usando um pacote
de recursos personalizado.
Observao: crie os pacotes de recursos personalizados em
iam_im.ear/custom/resourceBundles e, em seguida, faa referncia a eles
como resourceBundles.MyResourceBundle.
Os nomes de pacote usam sintaxe de localizao padro Java. O nome do
pacote no precisa incluir a extenso .properties, mas deve ser totalmente
qualificado, relacionado a iam_im.ear/custom.
Esse par de nome/valor opcional. Voc no precisa especificar um pacote
de recursos se a ID de chave for definida no pacote de recursos base,
IMSResources.properties. Nesse caso, a ID de chave na tela de tarefa
administrativa seria:
${key=IDchave}
key=IDchave
Identifica a ID de chave que mapeada para a sequncia de caracteres de
texto a ser exibida. O mapeamento deve existir em um pacote de recursos.
Uma entrada de ID de chave completa se parece com a amostra a seguir:
${bundle=resourceBundles.MyResourceBundle:key=attribute.displayname.dep
artment}

Usar o prefixo imstask.label da seguinte maneira:


imstask.label.nome_do_elemento
Por exemplo:

Captulo 9: Localizao do CA IdentityMinder 153

Exemplo de ambientes localizadas do CA IdentityMinder

imstask.label.attribute.displayname.department
Ao usar esse mtodo, attribute.displayname.department deve aparecer no
pacote de recursos.
Observao: se estiver criando arquivos de localizao personalizados (na pgina 163),
use uma ferramenta de traduo para alterar o valor mapeado para uma ID de chave de
um idioma diferente. Por exemplo, para exibir o boto Enviar em francs, a ferramenta
de traduo altera o valor combinado com a ID de chave global.button.submit no pacote
de recursos em francs, como se segue:
global.button.submit=Enter

Exemplo de ambientes localizadas do CA IdentityMinder


O CA IdentityMinder inclui os arquivos para criar verses traduzidas do Console de
usurio. possvel usar esses exemplos conforme definidos ou usar os exemplos como
modelos para criar um console de usurio convertido personalizado. Os idiomas a seguir
so suportados:

Francs

Alemo

Italiano

Japons

Coreano

Polons

Portugus

Nrdico

Chins simplificado

Espanhol

154 Guia de Design do Console de Usurio

Restries sobre o uso dos conjuntos de caracteres internacionais

Os arquivos que oferecem suporte a essas verses de idioma so instalados no seguinte


local:
ferramentas_administrativas\samples\Localization\idioma
ferramentas_administrativas
Especifica o local de instalao das Ferramentas administrativas do CA
IdentityMinder.
As Ferramentas administrativas so colocadas nos seguintes locais padro:
Windows: <caminho_de_instalao>\tools
UNIX: <caminho_de_instalao2>/tools
idioma
Especifica o idioma que deseja usar.

Restries sobre o uso dos conjuntos de caracteres


internacionais
A entrada a seguir deve conter apenas caracteres ASCII:

Nomes e aliases de ambiente

Nomes de diretrio

Tags de tarefa

Nomes de classe usados nas seguintes APIs:

API do ouvinte de eventos

API da regra de notificao

API do atributo lgico

API do resolvedor da organizao do fluxo de trabalho

Nomes de atributo lgico e nomes de atributo fsico usados pelo atributo lgico

O URL do contrato de licena do usurio final que exibido quando os usurios se


autorregistram
Observao: o contrato de licena do usurio final pode conter conjuntos de
caracteres internacionalizados.

Captulo 9: Localizao do CA IdentityMinder 155

Como configurar o suporte para localizao

Como configurar o suporte para localizao


Para configurar o sistema para usar uma verso traduzida do CA IdentityMinder,
execute as seguintes etapas:
1.

Verifique se o sistema que est hospedando o CA IdentityMinder atende aos


pr-requisitos definidos em Pr-requisitos de localizao (na pgina 157).

2.

Se o CA IdentityMinder integrar-se ao CA SiteMinder, configure o Agente web do CA


SiteMinder para localizao.

3.

Se o CA IdentityMinder for executado em um servidor do aplicativos do JBoss,


modifique o arquivo server.xml do Tomcat (na pgina 160).

4.

Configure a varivel PATH.

5.

Execute uma das seguintes etapas:

Se voc estiver usando um dos exemplos de Ambientes localizados, v para


Como usar o exemplo de ambientes localizados (na pgina 161).
O CA IdentityMinder instala verses traduzidas da ajuda online e do Console de
usurio nos seguintes idiomas:

Francs

Alemo

Italiano

Coreano

Japons

Polons

Chins simplificado

Espanhol

Voc pode usar esses arquivos como foram instalados ou us-los como um
modelo para criar um Ambiente personalizado em um desses idiomas.

6.

Se voc desejar traduzir o CA IdentityMinder em um idioma para o qual um


exemplo no est disponvel ou se desejar traduzir um ambiente altamente
personalizado, v para Como criar arquivos de localizao personalizados (na
pgina 163).

Traduza os componentes adicionais a seguir, conforme a necessidade:

Modelos de email (na pgina 164)

Capas de identificao visual (na pgina 164)

Cdigo personalizado (na pgina 164)

156 Guia de Design do Console de Usurio

Como configurar o suporte para localizao

Pr-requisitos de localizao
Antes de configurar o CA IdentityMinder para localizao, observe o seguinte:

O CA IdentityMinder deve estar instalado e configurado e, pelo menos, um


ambiente deve existir.
Observao: se voc estiver usando o CA SiteMinder e o Ambiente gerenciar
usurios com IDs de usurio multibytes, esses usurios devero fazer a
autenticao com um esquema de autenticao do CA SiteMinder que oferea
suporte a caracteres multibytes. Por exemplo, autenticao com base em
formulrios HTML. O esquema de autenticao bsica no oferece suporte
autenticao multibyte. Para obter informaes sobre como configurar um
esquema de autenticao do CA IdentityMinder, consulte o captulo sobre como
configurar os Recursos do CA SiteMinder para o CA IdentityMinder no Guia de
Configurao.

Se voc estiver usando o CA SiteMinder, certifique-se de que uma verso suportada


do Servidor de polticas do CA SiteMinder est instalado e configurado.

Certifique-se de que o diretrio de usurios esteja configurado para oferecer


suporte localizao. Para obter mais informaes, consulte a documentao do
repositrio de usurios que est sendo usado.

Captulo 9: Localizao do CA IdentityMinder 157

Como configurar o suporte para localizao

Se voc estiver usando um diretrio LDAP como um repositrio de usurios,


verifique se o diretrio LDAP no est aplicando uma verificao de 7 bits para a ID
de usurio, senha e atributo de email. Para obter mais informaes, consulte a
documentao do diretrio LDAP que est sendo usado.

Se voc estiver usando um repositrio de objetos do banco de dados Oracle,


verifique se o conjunto de caracteres do componente no parmetro NLS_LANG e a
codificao de caracteres do banco de dados esto definidos para AL32UTF8, um
conjunto de caracteres multibyte.
O CA IdentityMinder usa codificao de caracteres multibyte (UTF-8). Se voc
especificar um conjunto de caracteres de um nico byte, os caracteres podero
parecer corrompidos devido insuficincia de espao de caracteres.
Observao: para obter instrues sobre como definir um parmetro NLS_LANG e a
codificao de caracteres do banco de dados, consulte a documentao da Oracle.

O CA IdentityMinder inclui ferramentas que voc usa para localizar um novo


ambiente do CA IdentityMinder. Para usar essas ferramentas, necessrio possuir
os seguintes softwares:
Ferramenta Java SDK native2ascii
Traduz bilateralmente sequncias de escape Unicode. Como a localizao envolve
principalmente a traduo dos arquivos de propriedades, as ferramentas
processam todos os arquivos em ASCII com sequncias de escape Unicode.
Para configurar as ferramentas de localizao, instale a ferramenta native2ascii
instalando um JDK no sistema em que as Ferramentas administrativas do CA
IdentityMinder esto instaladas.
Para obter informaes sobre a ferramenta native2ascii, v para o local a seguir no
site do Java:
http://java.sun.com/j2se/1.5.0/docs/guide/intl/index.html
ant 1.7 ou superior

158 Guia de Design do Console de Usurio

Como configurar o suporte para localizao

Configurar o Agente web do CA SiteMinder


Configure a codificao dos valores de cabealho HTTP que o Agente web do CA
SiteMinder transmite ao CA IdentityMinder definindo o parmetro
HTTPheaderEncodingSpec da seguinte maneira:
HTTPHeaderEncodingSpec=espec_codificao, espec_quebra_automtica

onde espec_codificao uma sequncia de caracteres de texto que representa um dos


seguintes tipos de codificao: UTF-8 ou Shift-JIS, e espec_quebra_automtica a
especificao da quebra automtica, que deve ser RFC-2047.
Por exemplo:
HTTPHeaderEncodingSpec="Shift-JIS,RFC-2047"

Observao: se nenhum valor for especificado no parmetro HTTPHeaderEncodingSpec,


a codificao ser UTF-8 sem quebra automtica.
possvel configurar o parmetro HTTPHeaderEncodingSpec de forma centralizada no
Objeto de configurao do agente ou localmente para cada Agente web, no arquivo
WebAgent.conf.
Observao: para obter mais informaes, consulte o Guia de Configurao do Agente
Web do CA SiteMinder Web Access Manager.

Captulo 9: Localizao do CA IdentityMinder 159

Como configurar o suporte para localizao

Alterar o server.xml do JBoss


Se o CA IdentityMinder estiver hospedado em um servidor de aplicativos do JBoss,
localizar o CA IdentityMinder em um conjunto de caracteres multibyte requer uma
alterao de configurao. O arquivo server.xml do JBoss deve especificar a codificao
UTF-8 para o URI.
Altere a codificao no elemento Connector para o conector HTTP/1.1 em um dos
seguintes arquivos:

Para JBoss 5.0.x


base_do_jboss/server/default/deploy/jboss-web.deployer/server.xml

Para JBoss 5.1.x


base_do_jboss/server/default/deploy/jbossweb.sar/server.xml

Especifique a codificao UTF-8 para o URI da seguinte maneira:


<Server ...>
<Service ...>
<Connector port="8080" ... URIEncoding="UTF-8"/>
...
</Connector>
</Service>
</Server>

Configurar a varivel PATH


O CA IdentityMinder inclui verses traduzidas do Console de usurio e da ajuda online
padro que voc pode usar em ambientes localizados. No entanto, se voc tiver um
ambiente personalizado que queira traduzir, o CA IdentityMinder fornece ferramentas
de localizao que voc pode usar para realizar a traduo. Para us-las, preciso ter o
ant 1.7 ou posterior e Java JDK 1.5 ou posterior instalado. Tanto ant quanto Java JDK
deve estar no seu caminho. possvel adicion-los com os seguintes comandos:
Windows:
PATH %ANT_HOME%\bin;%PATH%
PATH %JAVA_HOME%\bin;%PATH%

UNIX:
PATH=%ANT_HOME%\bin:$PATH
export PATH

160 Guia de Design do Console de Usurio

Como configurar o suporte para localizao

Como usar o exemplo de ambientes localizados


O CA IdentityMinder implanta os arquivos que oferecem suporte amostra de
Ambientes localizados durante a instalao.
Para exibir telas e tarefas localizadas no Console de usurio, execute as seguintes
etapas:
1.

Importe o arquivo RoleDefinitions.XML (na pgina 161).

2.

Instale a ajuda online. (na pgina 162)

Importar o arquivo RoleDefinitions.XML


O arquivo RoleDefinitions.xml cria as tarefas que aparecem inicialmente no Console de
usurio.
Voc deve importar o arquivo de amostra RoleDefinitions.xml necessrio para o
ambiente do CA IdentityMinder.
Para importar o arquivo RoleDefinitions.XML
1.

No Management Console, clique em ambientes do CA IdentityMinder.


Uma lista de ambientes do CA IdentityMinder exibida.

2.

Clique no nome de um ambiente do CA IdentityMinder.


A janela Properties desse ambiente exibida.

3.

Clique em Role and Task Settings.

4.

Clique em Importar.
O Management Console lista os arquivos RoleDefinition.xml que esto disponveis
para adicionar ao Ambiente.

Captulo 9: Localizao do CA IdentityMinder 161

Como configurar o suporte para localizao

5.

Procure e selecione o arquivo RoleDefinitions.xml apropriado para o idioma


necessrio.
Os arquivos RoleDefinitions.xml traduzidos esto localizados nas Ferramentas
administrativas:
ferramentas_administrativas\samples\Localization\idioma
ferramentas_administrativas
Especifica o local de instalao das Ferramentas administrativas do CA
IdentityMinder.
As Ferramentas administrativas so colocadas nos seguintes locais padro:
Windows: <caminho_de_instalao>\tools
UNIX: <caminho_de_instalao2>/tools
idioma
Especifica o idioma que deseja usar.
Observao: para obter uma descrio do arquivo RoleDefinitions disponvel,
consulte o arquivo readme.txt em
ferramentas_administrativas\samples\Localization.

6.

Clique em Finalizar.
O status exibido na janela Role Configuration Output.

7.

Clique em Continuar para sair.

8.

Repita as etapas de 1 a 6 para cada arquivo RoleDefinitions.xml de cada Ambiente.

Instalar a ajuda online


O CA IdentityMinder inclui a ajuda online traduzida para cada verso traduzida do
Console de usurio.
Siga estas etapas:
1.

Faa download da ajuda online traduzida no site de Suporte da CA, como se segue:
a.

Abra o site de Suporte da CA em uma janela do navegador.

b.

Clique em Documentao.

c.

Insira CA IdentityMinder no campo Select a Product da seo Find Other


Product Documentation.

d.

Selecione a release e o idioma aplicveis e clique em Go.


O site de suporte exibe os documentos e a ajuda online traduzidos de cada
service pack na release que voc selecionou.

e.

Clique no arquivo ZIP da ajuda online para fazer download dele.

162 Guia de Design do Console de Usurio

Como configurar o suporte para localizao

2.

Copie o arquivo ZIP da ajuda online da seguinte maneira:


copy nome_do_arquivo.zip iam_im.ear\user_console.war\
nome do arquivo
O nome do arquivo ZIP que voc baixou na etapa 1.
iam_im.ear
O local de implantao do aplicativo do CA IdentityMinder no servidor de
aplicativos.
Observao: considere a criao de uma cpia de backup da ajuda online padro
antes substitu-la por uma verso traduzida. A ajuda online padro substituda
pela verso traduzida.

3.

Descompacte o im_help.zip no diretrio user_console.war.


A verso traduzida da ajuda online est disponvel para uso.

Como criar arquivos de localizao personalizados


Localizar pacotes de recursos envolve as seguintes operaes:
1.

Exporte as funes em um arquivo RoleDefinitions.xml e faa o seguinte:

Se voc localizar o CA IdentityMinder para um nico idioma, passe para a


prxima etapa.

Se voc localizar o CA IdentityMinder para vrios idiomas, crie tokens no


RoleDefinitions.xml.
Quando voc executa o comando para criar um arquivo RoleDefinitions.xml
com token, o CA IdentityMinder cria RoleDefinitions_Tokenized.xml e
RoleDefinitions_Tokenized.properties.

2.

Traduza o arquivo RoleDefinitions.XML.

3.

Traduza os pacotes de recursos.

4.

Instale os arquivos localizados.

5.

Importe um arquivo RoleDefinitions.xml com token em um Ambiente novo ou


existente.

Observao: para seguir as instrues, consulte o arquivo Leiame localizado em


ferramentas_administrativas\samples\Localization. As Ferramentas administrativas so
colocadas nos seguintes locais padro:

Windows: <caminho_de_instalao>\tools

UNIX: <caminho_de_instalao2>/tools

Captulo 9: Localizao do CA IdentityMinder 163

Como configurar o suporte para localizao

Traduzir modelos de email


O CA IdentityMinder pode enviar notificaes por email aos usurios interessados
quando determinados eventos ocorrem, por exemplo, quando um administrador aprova
uma solicitao ou quando uma tarefa concluda.
possvel criar e gerenciar as notificaes por email usando as polticas de notificao
por email no Console de usurio.
Observao: se o email contiver caracteres internacionalizados, os usurios devero
definir a codificao de seu cliente de email para Unicode (UTF-8), de modo a exibir a
mensagem corretamente. Para obter informaes sobre como alterar as codificaes de
email, consulte a documentao includa no cliente de email.
Para traduzir modelos de email
1.

Configure o suporte para notificaes de email conforme descrito no Guia de


Administrao.

2.

Execute os procedimentos para usar a notificao por email no Guia de


Administrao.
Quando voc personaliza as notificaes por email, traduz o contedo para o
idioma apropriado.

Como localizar capas de identificao visual


As capas de identificao visual determinam os elementos grficos, as cores e as fontes
para um ambiente do CA IdentityMinder. O CA IdentityMinder inclui uma capa padro e
vrias amostras de capa que voc pode personalizar para um idioma especfico.

Modificar a tarefa Alterar minha conta


Em ambientes localizados, o processo de consulta padro tem nomes de funo em
ingls na configurao, o que causa falha na tarefa Alterar minha conta. Para corrigir
essa falha, execute as seguintes tarefas:
1.

No Console de usurio, modifique a tarefa Alterar minha conta.

2.

Clique na guia Eventos.

3.

Selecione as funes Gerenciador de usurios e Aprovador de usurios especficas


do idioma na lista de funes.

4.

Salve as alteraes.

164 Guia de Design do Console de Usurio

Como exibir o CA IdentityMinder em outro idioma

Localizando cdigo personalizado


Ao criar cdigo personalizado usando as APIs do CA IdentityMinder, voc pode executar
as seguintes tarefas:

Localize mensagens de exceo que so exibidas em Manipuladores de atributo


lgico, Manipuladores de tarefas de lgica de negcios e regras de validao.

Localize os nomes de exibio dos atributos lgicos.

Especifique o idioma que o CA IdentityMinder usa para todas as suas comunicaes


com um cliente terceirizado ao usar o recurso de execuo de tarefa remota
(TEWS).

Use a classe auxiliar Localizer para recuperar a verso localizada de uma sequncia
de caracteres de uma determinada localidade. Por exemplo, possvel recuperar a
verso localizada de um rtulo em uma tela de tarefas ou um nome de tarefa.

Para obter mais informaes sobre como localizar cdigo personalizado, consulte os
seguintes documentos:

A rea Localizer e IMSException das informaes dos objetos de suporte no Guia de


Programao do Java.

As descries de classe para os objetos Localizer e IMSException no Javadoc.

Como exibir o CA IdentityMinder em outro idioma


Quando um ambiente oferece suporte a diversos idiomas, os usurios podem selecionar
o idioma que desejam exibir no campo Escolher o idioma na tela de logon e no Console
de usurio. Quando um usurio seleciona um idioma diferente, o CA IdentityMinder
exibe a tela de logon e as telas do Console de usurio no novo idioma. O usurio no
precisa efetuar logoff no ambiente para que as alteraes tenham efeito.
A lista de idiomas no campo Escolher o idioma depende da disponibilidade dos arquivos
localizados para o ambiente. A preferncia de idioma definida no navegador do usurio
determina o idioma padro.
Observao: para exibir o campo Escolher o idioma, conclua as seguintes etapas de
configurao no CA IdentityMinder:

Configure o campo Enable Language Switching no Management Console

Adicione suporte para o idioma no Ambiente importando arquivos RoleDefinitions


traduzidos e instalando os arquivos da ajuda online
Observao: se estiver criando arquivos localizados personalizados em vez de usar
os arquivos de amostra, sero necessrias etapas adicionais de configurao.

Captulo 9: Localizao do CA IdentityMinder 165

Definir o cabealho HTTP imlanguage em uma resposta do CA SiteMinder

Enable Language Switching


Ative o suporte alternncia de idiomas na tela de logon do CA IdentityMinder e no
Console de usurio no Management Console.
Para ativar a alternncia de idiomas
1.

Abra o Management Console usando o seguinte URL:


http://nome_do_host:porta/iam/immanage
Observao: se voc estiver usando um Agente web para fornecer autenticao
avanada do CA IdentityMinder, observe o seguinte:

No necessrio especificar o nmero da porta.

O campo Choose Language no ser exibido na tela de logon.

2.

V para Environments, YourEnvironment, Advanced Settings, User Console.

3.

Na seo General Behavior, selecione Enable Language Switching.

4.

Clique em Salvar.

5.

Reinicie o Ambiente para que as alteraes entrem em vigor.

Definir o cabealho HTTP imlanguage em uma resposta do CA


SiteMinder
Quando o CA IdentityMinder integra-se ao CA SiteMinder, voc pode definir a
preferncia de localidade de um usurio usando o cabealho HTTP imlanguage. No CA
SiteMinder, voc pode definir esse cabealho dentro de uma resposta do CA SiteMinder
e especificar um atributo de usurio como o valor do cabealho. Esse cabealho
imlanguage atua como a preferncia de localidade de prioridade mais alta para um
usurio.

166 Guia de Design do Console de Usurio

Definir o cabealho HTTP imlanguage em uma resposta do CA SiteMinder

Para definir o cabealho HTTP imlanguage em uma resposta do CA SiteMinder


1.

Efetue logon em uma das interfaces a seguir como um administrador com


privilgios de domnio:

No CA SiteMinder Web Access Manager r12 ou superior, efetue logon na


Interface de usurio administrativa.

No CA eTrust SiteMinder 6.0 SP5, efetue logon na Interface de usurio do


servidor de polticas.

Observao: para obter informaes sobre como usar essas interfaces, consulte a
documentao da verso do CA SiteMinder que voc est usando.
2.

Localize a resposta do CA SiteMinder para o ambiente do CA IdentityMinder


protegido:
ambiente-do-Identity Managerresponse_ims

3.

Crie um Editor de atributo de resposta do CA SiteMinder com os seguintes valores:

Atributo: WebAgent-HTTP-Header-Variable
Isso adiciona um novo cabealho HTTP resposta.

Tipo de atributo: Atributo de usurio

Nome da varivel: imlanguage

Nome do atributo: insira o nome do atributo fsico do diretrio de usurios que


contm o local de preferncia, por exemplo, employeetype.
O contedo do atributo de usurio no diretrio de usurios deve incluir uma
preferncia de idioma que consista em uma abreviao de idioma de duas
letras seguida por um cdigo de pas de duas letras opcional, separados por um
hfen ou sublinhado. A configurao de preferncia de idioma no atributo de
usurio no diferencia maisculas de minsculas, conforme mostrado nos
exemplos a seguir:

4.

ja

en-US

en_uk

Salve a resposta.
O cabealho HTTP imlanguage definido em uma resposta do CA SiteMinder.

Captulo 9: Localizao do CA IdentityMinder 167

Captulo 10: Regras de validao


Esta seo contm os seguintes tpicos:
Introduo s regras de validao (na pgina 169)
Sobre regras de validao (na pgina 169)
Usando regras de validao padro (na pgina 173)
Como implementar regras de validao personalizadas (na pgina 176)
Como configurar regras de validao (na pgina 184)
Como iniciar a validao (na pgina 190)
Implementaes de amostra (na pgina 191)

Introduo s regras de validao


Os valores so atribudos aos atributos do repositrio de dados por meio dos campos da
tela de tarefas ou de forma programtica. As regras de validao de atributo ajudam a
garantir que os valores que os usurios digitam nos campos de tela de tarefas ou que
so fornecidos de modo programtico atendam a determinados requisitos, como
mostrado nos exemplos a seguir:

Requisitos de diretrio de usurios, como aplicar um tipo de dados ou verificar se


uma entrada, como uma data, formatada de uma maneira especfica.

Integridade de dados. Faz sentido uma entrada no contexto de outras informaes


sobre a tela de tarefas ou de acordo com as regras de negcios especficas de site?

Uma regra de validao pode ser diretamente associada a um campo da tela de tarefas
ou ser indiretamente associada ao campo, sendo associada a um atributo de objeto
gerenciado que configurado para o campo.
Todas as regras de validao associadas direta ou indiretamente a campos de uma tela
de tarefas devem ser atendidas para que o CA IdentityMinder possa comear a
processar a tarefa. Quando um valor fornecido invlido, uma mensagem associada
regra violada exibida, assim o usurio pode corrigir a entrada e reenviar a tarefa.

Sobre regras de validao


As regras de validao aplicam requisitos, como nos exemplos a seguir:

Um campo Quantidade deve conter apenas caracteres numricos.

Um campo Nmero de telefone deve ser formatado como nnn-nnn-nnnn.

Um campo ID de funcionrio deve conter um nmero que no ultrapasse 9999.

Captulo 10: Regras de validao 169

Sobre regras de validao

O valor digitado em um campo de CEP deve ser apropriado para os valores


digitados no campo Estado e Cidade.

O valor digitado em um campo Cargo qualifica o usurio para o espao vago de


segurana em nvel de segurana?

Alm de verificar a entrada de um usurio, uma regra de validao pode mudar uma
entrada para que ela esteja de acordo com os requisitos da regra sem a interveno do
usurio, conforme mostrado nos exemplos a seguir:

Uma regra de validao para um campo de Nmero de telefone exige que os


nmeros de telefone sejam formatados como nnn-nnn-nnnn. Se um usurio digitar
o valor 9785551234, a regra de validao ir alterar automaticamente a entrada
para o formato correto, 978-555-1234.

Uma regra de validao para um campo de Nmero de departamento exige que o


nmero seja prefixado com um cdigo de trs caracteres que representa o nome
digitado no campo Regio. Quando o prefixo estiver ausente ou incorreto, a regra
de validao fornecer o prefixo correto.

A alterao de uma entrada por meio de uma regra de validao chamada de


transformao.

Tipos de regras de validao


Os dois tipos de regras de validao so os seguintes:

Validao em nvel de tarefa valida um valor de atributo em relao a outros


atributos da tarefa. Por exemplo, possvel verificar se o cdigo de rea em um
nmero de telefone fornecido pelo usurio apropriado para a cidade e o estado
do usurio.
Durante a configurao da tela de tarefas, as regras de validao em nvel de tarefa
so diretamente associadas aos campos da tela de tarefas.
possvel usar esse tipo de validao para aplicar a integridade de dados.

Validao em nvel de diretrio valida o valor do atributo em si, e no no


contexto dos outros atributos da tarefa. Por exemplo, voc pode verificar se um
nmero de telefone fornecido pelo usurio corresponde ao formato nnn-nnn-nnnn
usado no diretrio.
No directory.xml, as regras de validao em nvel de diretrio so mapeadas para
um atributo de objeto gerenciado por meio de um conjunto de regras. As regras do
conjunto de regras so aplicadas a qualquer campo da tela de tarefas configurado
com o atributo.
possvel usar esse tipo de validao para aplicar requisitos de diretrio de
usurios.

O CA IdentityMinder executa as regras de validao em nvel de tarefa antes das regra


de validao em nvel de diretrio.

170 Guia de Design do Console de Usurio

Sobre regras de validao

Exemplo: comparando a validao em nvel de diretrio e a validao em nvel de tarefa


Nesse exemplo, um atributo de telefone mapeado em directory.xml para uma regra
de validao em nvel de diretrio que exige que nmeros de telefone sejam
formatados como nnn-nnn-nnnn. Todos os campos configurados com o atributo de
telefone so validados em relao ao formato nnn-nnn-nnnn se o campo for exibido em
uma tela de tarefas Criar usurio, Criar fornecedor ou qualquer outra tela de tarefas.
Se um campo de Nmero de telefone aparecer em uma tela de tarefas Criar tarefa,
como os campos de nmero de telefone em outra telas de tarefas, esse campo ser
configurado com o atributo de telefone que exige o formato de nmero de telefone. No
entanto, uma vez que alguns clientes da empresa esto localizados em outros estados, o
campo de Nmero de telefone na tela de tarefas Criar cliente tambm associado
seguinte lgica de validao em nvel de tarefa:

Verifique o valor no campo Estado.

Quando o cliente estiver localizado fora do estado, certifique-se de que o cdigo de


rea do nmero de telefone do cliente apropriado para o estado do cliente.

Conjuntos de regras de validao


Com a validao em nvel de diretrio, uma ou mais regras de validao so atribudas a
um conjunto de regras, que associado a um atributo de objeto gerenciado.
Os conjuntos de regras permitem definir e aplicar regras de uma maneira granular,
como nos seguintes exemplos:

Uma regra pode ser usada em diferentes conjuntos de regras

As regras podem ser executadas em diferentes combinaes

Quando uma regra em um conjunto de regras falha (por exemplo, uma regra Java ou
JavaScript retorna False), todas as mensagens de exceo associadas regra so
apresentadas ao usurio. Todas as regras de validao associadas ao atributo devem ser
atendidas antes de o atributo ser considerado validado.

Captulo 10: Regras de validao 171

Sobre regras de validao

Pedido de execuo
As regras so executadas na ordem em que esto listadas no conjunto de regras. O CA
IdentityMinder executa cada regra em um conjunto de regras separadamente, e de
forma transparente continua a cada regra subsequente no conjunto, a menos que uma
regra falhe.
Como as regras de validao so executadas em uma ordem previsvel, voc pode
implementar regras cujas aes dependem dos resultados das regras anteriores,
conforme mostrado nos exemplos a seguir:

A sada de uma regra pode se tornar entrada na prxima regra.

Quando o valor do campo alterado durante a validao, o novo valor pode ser
avaliado nas regras subsequentes.

Conceitos bsicos da definio da regra de validao


Execute as seguintes operaes bsicas ao definir regras de validao personalizadas:

Implemente uma regra de validao. Implemente uma regra de validao de uma


das seguintes maneiras:

Expresso regular

JavaScript

Classe Java

Integre uma regra de validao com o CA IdentityMinder usando uma tela de


tarefas ou o directory.xml. Realize esse procedimento em linha (diretamente na
tela de tarefas ou no arquivo directory.xml) ou por referncia (fazendo referncia a
um arquivo de origem JavaScript ou a um arquivo de classe Java compilado),
conforme mostrado na tabela a seguir:

Em linha

Por referncia

Expresso regular

directory.xml ou tela de
tarefas

JavaScript

directory.xml ou tela de
tarefas

Arquivo de origem referenciado no directory.xml

Java

Arquivo de classe referenciado no directory.xml


ou na tela de tarefas

172 Guia de Design do Console de Usurio

Usando regras de validao padro

Associe uma ou mais regras de validao a um campo da tela de tarefas. Realize


esse procedimento seguindo uma das instrues, ou ambas, a seguir:

Com a validao em nvel de tarefa, atribua uma regra de validao


diretamente a um campo em uma tela de tarefas especfica.
A validao em nvel de tarefa apresenta escopo especfico de tarefa, isto ,
pode ser usada somente no contexto da tela de tarefas especfica onde ela
atribuda.

Com a validao em nvel diretrio, mapeie um conjunto de regras para um


atributo de objeto gerenciado no directory.xml. Qualquer campo da tela de
tarefas que configurado com o atributo validado em relao s regras no
conjunto de regras.
A validao em nvel de diretrio apresenta escopo global. Isso significa que a
validao em nvel de diretrio pode ser usada em qualquer campo
configurado com o atributo de objeto gerenciado, independentemente da tela
de tarefas que contm o campo e do ambiente do CA IdentityMinder que inclui
a tela de tarefas.

Usando regras de validao padro


O CA IdentityMinder fornecido com os seguintes tipos de regras de validao padro:

Validao de dados dos campos da tela de tarefas

Regras de validao predefinidas definidas no arquivo directory.xml

Validaes de dados padro


Por padro, o CA IdentityMinder verifica determinados dados quando um administrador
envia uma tarefa para processamento. Quando os dados so invlidos, o CA
IdentityMinder interrompe o processamento da tarefa e exibe uma mensagem de erro.
As validaes de dados que o CA IdentityMinder executa tm como base o tipo de
tarefa, conforme mostrado na tabela a seguir:
Tarefas

Validao

Todas as tarefas

Os campos obrigatrios devem ter um valor.

Captulo 10: Regras de validao 173

Usando regras de validao padro

Tarefas

Validao

Criar usurio

Um administrador no pode criar um objeto com o mesmo nome de um


objeto existente do mesmo tipo. Por exemplo, um administrador no pode
criar duas funes administrativas com o mesmo nome.

Criar grupo
Criar organizao
Criar funo de acesso
Criar tarefa de acesso

Observao: para usurios e grupos, o CA IdentityMinder verifica apenas a


organizao atual.

Criar funo administrativa


Criar tarefa administrativa
Criar usurio
Criar grupo

Um administrador no pode criar um usurio, um grupo ou uma organizao


com um nome que contenha algum dos seguintes caracteres:

Criar organizao

vrgula (,)

aspas simples (')

aspas duplas (")

asterisco (*)

e comercial (&)

barra (/)

barra invertida (\)

sinal de menor que (<)

sinal de maior que (>)

sinal de igual a (=)

sinal de adio (+)

ponto e vrgula (;)

sinal de cerquilha (#)

espaos direita ou esquerda

Observao: os nomes de organizao podem conter vrgulas (,) ou um "e"


comercial (&).
Todas as tarefas Criar e modificar

Atributos com permisso de leitura/gravao (excluindo senhas) no podem


conter os seguintes caracteres:

vrgula (,)

sinal de porcentagem (%)

sinal de menor que (<)

sinal de maior que (>)

ponto e vrgula (;)

Esses caracteres so vulnervel a ataques de script entre sites.

174 Guia de Design do Console de Usurio

Usando regras de validao padro

Tarefas

Validao

Criar usurio

Se voc estiver usando o recurso Servios de senha do CA SiteMinder para


aplicar regras de senha (como tamanho mnimo), as senhas de usurios
sero validadas com base nessas regras.

Autorregistro
Alterar minha senha
Redefinir senha de usurio

Se a senha no atender poltica de senha, ela no ser aceita.

Observao: para obter mais informaes, consulte o Guia de Configurao


Qualquer tarefa personalizada que
do Servidor de Polticas do CA SiteMinder Web Access Manager.
colete e armazene senhas de
usurios
Modificar usurio

Os administradores no podem conceder a eles mesmos uma funo ou a


capacidade de atribuir uma funo.

Senha esquecida

Se um perfil de usurio no possuir uma dica de senha e resposta, esse


usurio no poder usar o recurso de senha esquecida.

Excluir usurio

Os administradores no pode excluir seu prprio perfil ou alterar o status de


sua conta.

Ativar/desativar usurio
Excluir organizao

Os administradores no podem excluir a organizao onde eles esto


atribudos funo que contm a tarefa Excluir organizao.
Considere um administrador que foi atribudo funo Gerenciador da
organizao na organizao Revendedores. A funo Gerenciador da
organizao permite que o usurio exclua as organizaes. Esse
administrador pode excluir suborganizaes de Revendedores, mas no
pode excluir Revendedores.

Modificar organizao

Os administradores no podem modificar a organizao onde eles esto


atribudos funo que contm a tarefa Modificar organizao.

Regras de validao predefinidas


O CA IdentityMinder inclui as seguintes regras de validao predefinidas no arquivo
directory.xml. Essas regras de validao predefinidas so usadas apenas para validao
em nvel de diretrio, conforme mostrado na tabela a seguir:

Nome da regra predefinida

Descrio

Padro de telefone

Aplica o formato a seguir para os nmeros de telefone:


+nn nnn-nnn-nnnn

Definir internacional

Adiciona o prefixo +1 a um nmero de telefone internacional.

Captulo 10: Regras de validao 175

Como implementar regras de validao personalizadas

Nome da regra predefinida

Descrio

Usurio vlido

Verifica se o objeto de Usurio especificado existe no diretrio.

Grupo vlido

Verifica se o objeto de Grupo especificado existe no diretrio.

Organizao vlida

Verifica se o objeto de Organizao especificado existe no diretrio.

As regras de validao predefinidas e as regras de validao personalizadas podem


aparecer no mesmo conjunto de regras.

Como implementar regras de validao personalizadas


possvel implementar uma regra de validao para um destes itens:

Expresso regular

JavaScript

Classe Java

Implementao de expresso regular


Uma regra de validao podem ter como base uma correspondncia de padro de
expresso regular. Por exemplo, voc pode fazer o seguinte:

Especificar uma lista de caracteres invlidos ou valores para um atributo

Impedir o usurio de digitar construes invlidas, como um DN ou nmero de


telefone incorretamente formado

O seguinte exemplo de JavaScript aplica o formato de nmero de telefone como


+nn nnn-nnn-nnnn:
phone=/\+\d{1,3} \d{3}-\d{3}-\d{4}/;

176 Guia de Design do Console de Usurio

Como implementar regras de validao personalizadas

Quebre expresses regulares definidas em XML em CDATA, como no exemplo a seguir:


<ValidationRule name="Phone pattern" description="+nn nnn-nnn-nnnn"
messageid="4001">
<RegularExpression>
<![CDATA[ ((\+|\d)*+(\s*|\x2D))?\d\d\d-\d\d\d-\d\d\d\d]]>
</RegularExpression>
</ValidationRule>

As regras de validao com base em expresses regulares devem estar em


conformidade com os requisitos definidos no pacote java.util.regex.

Implementao de JavaScript
Uma regra de validao que se baseia em JavaScript deve implementar a interface
relevante, levando em considerao se a regra usada para validao em nvel de tarefa
ou validao em nvel de diretrio.
No momento da validao, o CA IdentityMinder chama validate() e transmite o valor a
ser validado.

Interface JavaScript para validao em nvel de tarefa


A definio da interface JavaScript para validao em nvel de tarefa a seguinte:
Sintaxe
public boolean validate(
BLTHContext context,
String attributeValue,
StringRef changedValue,
StringRef errorMessage
);

Parmetros
context
Parmetro de entrada
Especifica um objeto que contm mtodos para recuperar as informaes da
sesso de tarefas atual.
attributeValue
Parmetro de entrada
Especifica o valor do atributo que est sendo validado.

Captulo 10: Regras de validao 177

Como implementar regras de validao personalizadas

changedValue
Parmetro de sada
Fornece um valor de transformao opcional que substitui o valor fornecido
pelo usurio que est sendo validado. Se nenhuma transformao for
necessria, null ser retornado.
errorMessage
Parmetro de sada
Se a validao falhar, uma mensagem ser exibida ao usurio.
A mensagem exibida por meio de AttributeValidationException. Se o mtodo
retornar false, o CA IdentityMinder ir gerar essa exceo.
Comentrios
Os parmetros de sada changedValue e errorMessage so do tipo de dados
StringRef. StringRef um tipo de dados predefinido que contm a referncia de
campo para o qual voc deseja atribuir um valor, como mostrado nos exemplos a
seguir:

Adicione um prefixo 1 para um nmero de telefone formatado corretamente:


changedValue.reference="+1 " + phoneNumber;

Fornea uma mensagem de erro para um nmero formatado incorretamente:


errorMessage.reference="Phone number " + phoneNumber +
" does not match the format nnn-nnn-nnnn.";

Retornos

True. A implementao leva em conta o valor em attributeValue a ser validado


ou transmite de volta um valor transformado em changedValue.

False. A implementao considera attributeValue como invlido. O CA


IdentityMinder gera um AttributeValidationException que inclui errorMessage.

Interface JavaScript para validao em nvel de diretrio


A definio da interface JavaScript para validao em nvel de diretrio a seguinte:
Sintaxe
public boolean validate(
String attributeValue,
StringRef changedValue,
StringRef errorMessage
);

Parmetros
attributeValue
Parmetro de entrada
Especifica o valor do atributo que est sendo validado.

178 Guia de Design do Console de Usurio

Como implementar regras de validao personalizadas

changedValue
Parmetro de sada
Fornece um valor de transformao opcional que substitui o valor fornecido
pelo usurio que est sendo validado. Se nenhuma transformao for
necessria, null ser retornado.
errorMessage
Parmetro de sada
Se a validao falhar, uma mensagem ser exibida ao usurio.
A mensagem exibida por meio de AttributeValidationException. Se o mtodo
retornar false, o CA IdentityMinder ir gerar essa exceo.
Comentrios
Os parmetros de sada changedValue e errorMessage so do tipo de dados
StringRef. StringRef um tipo de dados predefinido que contm a referncia de
campo para o qual voc deseja atribuir um valor, como mostrado nos exemplos a
seguir:

Adicione um prefixo 1 para um nmero de telefone formatado corretamente:


changedValue.reference="+1 " + phoneNumber;

Fornea uma mensagem de erro para um nmero formatado incorretamente:


errorMessage.reference="Phone number " + phoneNumber +
" does not match the format nnn-nnn-nnnn.";

Retornos

True - a implementao leva em conta o valor em attributeValue a ser validado


ou transmite de volta um valor transformado em changedValue.

False - a implementao considera attributeValue como invlido. O CA


IdentityMinder gera um AttributeValidationException que inclui errorMessage.

Implementao de Java
Uma regra de validao que se baseia em Java deve implementar a interface relevante,
levando em considerao se a regra usada para validao em nvel de tarefa ou
validao em nvel de diretrio.
No momento da validao, o CA IdentityMinder chama validate() e transmite o valor a
ser validado.

Captulo 10: Regras de validao 179

Como implementar regras de validao personalizadas

Interface Java para validao em nvel de tarefa


A definio da interface Java para validao em nvel de tarefa a seguinte:
Sintaxe
public interface TaskValidator {
public class StringRef {
public String reference = new String();
public String toString(){return reference;}
public boolean validate(
BLTHContext ctx,
String attrValue,
StringRef updatedValue,
StringRef errorMessage
) throws AttributeValidationException;
}

Parmetros
ctx
Parmetro de entrada
Especifica um objeto que contm mtodos para recuperar as informaes da
sesso de tarefas atual.
attrValue
Parmetro de entrada
Especifica o valor do atributo que est sendo validado.
updatedValue
Parmetro de sada
Fornece um valor de transformao opcional que substitui o valor fornecido
pelo usurio que est sendo validado. Quando nenhuma transformao for
necessria, retorne null.
errorMessage
Parmetro de sada
Se a validao falhar, uma mensagem ser exibida ao usurio.
Comentrios
Para obter mais informaes sobre regras de validao Java e sobre objetos
gerenciados, consulte o Javadoc do CA IdentityMinder.
Retornos

True - a implementao leva em conta o valor em attributeValue a ser validado


ou transmite de volta um valor transformado em changedValue.

False - a implementao considera attributeValue como invlido.

180 Guia de Design do Console de Usurio

Como implementar regras de validao personalizadas

Geraes
AttributeValidationException

Interface Java para validao em nvel de diretrio


A definio da interface Java para validao em nvel de diretrio a seguinte:
Sintaxe
public interface IAttributeValidator {
public class StringRef {
public String reference = new String();
public String toString(){return reference;}
public boolean validate(
Object attributeValue,
StringRef changedValue,
StringRef errorMessage
) throws AttributeValidationException;
}

Parmetros
attributeValue
Parmetro de entrada
Especifica o valor do atributo que est sendo validado.
changedValue
Parmetro de sada
Fornece um valor de transformao opcional que substitui o valor fornecido
pelo usurio que est sendo validado. Quando nenhuma transformao for
necessria, retorne null.
errorMessage
Parmetro de sada
Se a validao falhar, uma mensagem ser exibida ao usurio.
Comentrios
Se a operao de validao exigir objetos gerenciados do diretrio,
use AttributeValidator. Essa classe abstrata implementa a interface
IAttributeValidator e inclui um mtodo para recuperar os provedores de objeto
gerenciado.

Captulo 10: Regras de validao 181

Como implementar regras de validao personalizadas

Retornos

True - a implementao leva em conta o valor em attributeValue a ser validado


ou transmite de volta um valor transformado em changedValue.

False - a implementao considera attributeValue como invlido.

Geraes
AttributeValidationException.

Excees
AttributeValidationException gerada quando uma regra de validao no pode validar
um valor de atributo fornecido em um campo da tela de tarefas ou de forma
programtica. A exceo contm uma ou mais mensagens que so apresentadas ao
usurio, permitindo que o usurio corrija a entrada e reenvie a tarefa.
Como essa exceo gerada e como as mensagens de erro so apresentadas para a
exceo depende se a regra implementada como JavaScript, uma classe Java ou uma
expresso regular.

Excees com validao em nvel de tarefa


Com erros de validao em nvel de tarefa, AttributeValidationException gerada como
mostrado na tabela a seguir:

Tipo de regra

Como lanada

Origem da mensagem de erro

Expresso regular

Pelo CA IdentityMinder se a validao


da expresso regular validation falhar.

O CA IdentityMinder usa uma mensagem de


exceo generalizada.

JavaScript

Pelo CA IdentityMinder se o mtodo


validate() retornar False.

O parmetro errorMessage do mtodo validate().

Java

Pela regra de validao personalizada


ou pelo CA IdentityMinder.

Uma das seguintes origens:

O CA IdentityMinder gera a exceo


quando a regra personalizada no gera
e o mtodo validate() da regra
personalizada retorna False.

182 Guia de Design do Console de Usurio

Se a regra de validao personalizada gerar a


exceo, o construtor da exceo. O
construtor permite especificar a ID de uma
mensagem em um pacote de recursos e o
texto de uma mensagem adicional.

Se o CA IdentityMinder gerar a exceo, o


parmetro errorMessage do mtodo
validate().

Como implementar regras de validao personalizadas

Se a implementao da regra de validao no fornecer uma mensagem de erro, o CA


IdentityMinder usar uma mensagem de erro generalizada.

Excees com validao em nvel de diretrio


As mensagens de exceo para erros de validao em nvel de diretrio tm duas
origens:

Um pacote de recursos. No directory.xml, as definies de todos os tipos de regras


de validao (Java, JavaScript e expresso regular) incluem o atributo messageid.
Essa ID mapeada para uma mensagem de exceo personalizada no pacote de
recursos IMSExceptions.properties. Quando AttributeValidationException gerada,
o CA IdentityMinder inclui a mensagem mapeada com outras informaes de erro
que podem ser definidas para a regra de validao.

Cdigo da regra de validao personalizada. As implementaes Java e JavaScript


podem definir mensagens de exceo adicionais para a regra. Se ocorrer um erro de
validao na regra Java ou JavaScript, a mensagem ser apresentada ao usurio
com a mensagem que mapeada para a regra no pacote de recursos.
As origens dessas mensagens de exceo Java e JavaScript so definidas na tabela
anterior.
Esse recurso no se aplica a regras de validao em nvel de diretrio
implementadas como expresses regulares.

Observao: para obter mais informaes sobre as mensagens de exceo em pacotes


de recursos, consulte AttributeValidationException no Javadoc do CA IdentityMinder.

Construtor AttributeValidationException
Ao criar um objeto AttributeValidationException para um mtodo Java validate(), use o
construtor a seguir:
Sintaxe
public AttributeValidationException(String attrName,
String attrValue,
String messageid,
String message);

Parmetros
attrName
Especifica o nome do atributo de objeto gerenciado que est sendo validado.
attrValue
Especifica o valor a ser validado.

Captulo 10: Regras de validao 183

Como configurar regras de validao

messageid
Se o valor no puder ser validado, ele fornecer a ID associada mensagem a
ser exibida. A ID corresponde a uma mensagem no pacote de recursos
IMSExceptions.properties.
message
Fornece uma mensagem adicional que pode ser exibida para o usurio. Esse
parmetro fornece uma oportunidade de exibir uma mensagem mais especfica
do que a do pacote de recursos ou uma mensagem de um pacote de recursos
personalizado.
Observao: para obter mais informaes sobre AttributeValidationException, consulte
o Javadoc do CA IdentityMinder.

Como configurar regras de validao


Configure uma regra de validao integrando-a ao CA IdentityMinder e, associando-a
direta ou indiretamente a um campo da tela de tarefas.
O modo como voc configura uma regra de validao determina se voc deseja que a
regra seja aplicada a um campo em uma tela de tarefas especfica (validao em nvel de
tarefa) ou a um campo em qualquer tela de tarefas (validao em nvel de diretrio),
como se segue:

Com a validao em nvel de tarefa, faa uma associao direta entre a regra e um
campo em uma tela de tarefas especfica. A validao executada no campo,
apenas no contexto dessa tela de tarefas.

Com a validao em nvel de diretrio, a associao entre a regra e o campo da tela


de tarefas indireta, como se segue:

No directory.xml, especifique a regra de validao, adicione a regra a um


conjunto de regras e associe o conjunto de regras a um atributo de objeto
gerenciado.

No Console de usurio, um campo que est configurado com o atributo de


objeto gerenciado validado no conjunto de regras mapeado para o atributo.

A validao executada em qualquer campo configurado com o atributo,


independentemente da tela de tarefas que contm o campo e do ambiente do CA
IdentityMinder que contm a tela de tarefas.

184 Guia de Design do Console de Usurio

Como configurar regras de validao

Como configurar a validao em nvel de tarefa


Configure a validao em nvel de tarefa no Console de usurio ao definir propriedades
do campo em uma tela de tarefas de perfil. As etapas de pesquisa so as seguintes:
1.

Navegue at a seo Propriedades do campo da tela de configurao de perfil que


contm o campo a ser validado.
Observao: para obter mais informaes sobre propriedades do campo, consulte o
Guia de Administrao e a ajuda online do Console de usurio.

2.

Especifique um valor em um dos campos a seguir, dependendo de como a regra de


validao deve ser implementada:

Expresso de validao. Contm uma expresso regular que executa a


validao.

Classe de validao do Java. Contm o nome totalmente qualificado de uma


classe Java que executa a validao, por exemplo:
com.mycompany.MyJavaValidator

O CA IdentityMinder espera que o arquivo da classe esteja localizado no


diretrio raiz designado para arquivos da classe Java personalizados.

JavaScript de validao. Contm o cdigo JavaScript completo que executa a


validao.
Voc deve fornecer o cdigo JavaScript nesse campo. Com a validao em nvel
de tarefa, voc no pode fazer referncia a um arquivo que contm o cdigo
JavaScript.

Observao: para obter informaes sobre como definir propriedades de campo em


uma tela de configurao de perfil, clique no boto Ajuda na tela.

Como configurar a validao em nvel de diretrio


Voc configura a validao em nvel de diretrio no arquivo directory.xml e em uma tela
de tarefas. As etapas de pesquisa so as seguintes:

No arquivo directory.xml, faa o seguinte:

Especifique uma regra de validao no elemento ValidationRule.

Especifique um conjunto de regras no elemento ValidationRuleSet. Um


conjunto de regras contm uma ou mais regras predefinidas, regras de
validao personalizadas ou regras de ambos os tipos.

Associe um conjunto de regras com um atributo de objeto gerenciado no


elemento ImsManagedObjectAttr.

Em uma tela de tarefas, o campo a ser validado deve ser configurado com o
atributo mapeado para o conjunto de regras.

Captulo 10: Regras de validao 185

Como configurar regras de validao

Integrao da validao em nvel de diretrio ao CA IdentityMinder


Defina regras e conjuntos de regras de validao para o CA IdentityMinder por meio do
elemento ImsManagedObjectAttrValidation do arquivo directory.xml.
O esquema para o elemento ImsManagedObjectAttrValidation o seguinte:
<xs:element name="ImsManagedObjectAttrValidation" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="ValidationRule" minOccurs="0"
maxOccurs="unbounded">
<xs:complexType>
<xs:choice>
<xs:element name="Java">
<xs:complexType>
<xs:attribute name="class" type="xs:string"
use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="JavaScript">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string"/>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="JavaScriptFile">
<xs:complexType>
<xs:attribute name="file" type="xs:string"
use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="RegularExpression">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string"/>
</xs:simpleContent>
</xs:complexType>
</xs:element>
</xs:choice>
<xs:attribute name="name" type="xs:string"
use="required"/>
<xs:attribute name="description" type="xs:string"
use="optional"/>
<xs:attribute name="messageid" type="xs:string"
use="required"/>
</xs:complexType>
</xs:element>

186 Guia de Design do Console de Usurio

Como configurar regras de validao

<xs:element name="ValidationRuleSet" minOccurs="0"


maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="ValidationRule"
maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="name" type="xs:string"
use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="name" type="xs:string"
use="required"/>
<xs:attribute name="description" type="xs:string"
use="optional"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>

Os seguintes elementos so definidos:


ValidationRuleSet
Consiste em uma ou mais regras de validao predefinidas ou personalizadas. Uma
regra de validao especificada no elemento ValidationRule.
As regras predefinidas e as regras personalizadas podem aparecer no mesmo
conjunto de regras. Alm disso, um conjunto de regras pode conter qualquer
combinao de implementaes Java, JavaScript e expresso regular.
As regras de validao so executadas na ordem em que elas aparecem em
ValidationRuleSet. Isso permite uma validao em cascata, onde a sada de uma
regra usado como entrada da prxima.
ValidationRuleSet associado a um atributo de objeto gerenciado no elemento
ImsManagedObjectAttr do arquivo directory.xml.

Captulo 10: Regras de validao 187

Como configurar regras de validao

ValidationRule
Especifica uma regra de validao para uso em um ValidationRuleSet.
ValidationRule deve conter apenas um dos seguintes subelementos:

Java. Faz referncia ao arquivo de classe Java que implementa a regra.

JavaScript. Contm o cdigo JavaScript embutido que implementa a regra.

JavaScriptFile. Faz referncia ao arquivo de origem Java que implementa a


regra.

RegularExpression. Contm a expresso regular embutida que implementa a


regra. A expresso regular deve ser quebrada em CDATA, como mostrado na
referncia cruzada de "pgina" no suportada.

Atributos da chave
A maioria dos atributos dos elementos descritos anteriormente autoexplicativa.
No entanto, os seguintes atributos necessitam de explicao:

Atributo class do elemento <Java>


Com regras de validao Java, a classe Java deve ser implantada no seguinte
local raiz em seu servidor de aplicativos:
iam_im.ear\custom

Os arquivos nesse local raiz devem ser totalmente qualificados, mas no


precisam de nenhuma outra informao de caminho, por exemplo,
com.mycompany.MyJavaImpl.

Atributo file do elemento <JavaScriptFile>


Com uma regra de validao implementada em um arquivo de origem
JavaScript, o arquivo deve ser implantado no seguinte local raiz em seu servidor
de aplicativos:
iam_im.ear\custom\validationscripts

Os arquivos de origem JavaScript nesse local raiz so referenciados somente


pelo nome, por exemplo, MyJavaScriptImpl.js.

Atributo messageid do elemento <ValidationRule>


A id da mensagem especificada nesse atributo mapeada para uma mensagem
de erro no pacote de recursos IMSExceptions.properties.
Todos os tipos de regras de validao (Java, JavaScript e JavaScriptFile e
RegularExpression) contm um atributo messageid.

188 Guia de Design do Console de Usurio

Como configurar regras de validao

Exemplo: expresso regular embutida


O exemplo a seguir mostra a regra de validao padro Telefone predefinida, que
includa no formato Telefone do conjunto de regras. A regra implementada em linha
como uma expresso regular:
<ValidationRule name="Phone pattern" description="+nn nnn-nnn-nnnn"
messageid="4001">
<RegularExpression>
<![CDATA[ ((\+|\d)*+(\s*|\x2D))?\d\d\d-\d\d\d-\d\d\d\d]]>
</RegularExpression>
</ValidationRule>
<ValidationRuleSet name="Phone format" description=
"Verify format +nn nnn-nnn-nnnn">
<ValidationRule name="Phone pattern" />
</ValidationRuleSet>

No exemplo anterior, messageid="4001" mapeado para a linha a seguir em


IMSExceptions.properties:
4001=Attribute Validation: {0} value must match regular expression
nnn-nnn-nnnn.

Exemplo: referncia ao arquivo JavaScript


O exemplo abaixo especifica a regra EndWithZ_js. Essa regra implementada no
JavaScript e o script est localizado no arquivo EndWithZ.js. O conjunto de regras que
inclui a regra no exibido no exemplo:
<ValidationRule name="EndWithZ_js" messageid="custom-5001">
<JavaScriptFile file="EndWithZ.js" />
</ValidationRule>

No exemplo anterior, pressuposto que o arquivo JavaScript esteja no seguinte local


padro:
iam_im.ear\custom\validationscripts

Captulo 10: Regras de validao 189

Como iniciar a validao

Associao de um conjunto de regras de validao a um atributo de objeto gerenciado


Associar um conjunto de regras de validao a um atributo de objeto gerenciado por
meio do elemento ImsManagedObjectAttr do arquivo directory.xml.
No exemplo a seguir, o formato Telefone do conjunto de regras de validao
associado ao atributo de objeto gerenciado telephonenumber:
<ImsManagedObjectAttr physicalname="telephonenumber" displayname="Business Phone"
description="Business Phone" valuetype="String" required="false"
multivalued="false" maxlength="0" validationruleset="Phone format" />

Observao: quando um atributo de objeto gerenciado associado a um conjunto de


regras de validao, o nome do conjunto de regras exibido na tela Attribute Properties
do Management Console.

Associao de um conjunto de regras de validao a um campo da tela de tarefas


Com a validao em nvel de diretrio, voc pode associar um conjunto de regras a um
campo da tela de tarefas indiretamente, como se segue:
1.

Associe o conjunto de regras a um atributo de objeto gerenciado, conforme


descrito na seo anterior.

2.

Certifique-se de que o campo da tela de tarefas a ser validado esteja configurado


com o atributo de objeto gerenciado associado ao conjunto de regras. Em tempo de
execuo, um valor de campo fornecido por um usurio final validado com base
nas regras do conjunto de regras.

Normalmente, os campos da tela de tarefas j so configurados com atributos. No


entanto, voc pode adicionar um campo a uma tela de tarefas ou alterar o atributo
atribudo a um campo. Nesses casos, se voc desejar que o valor fornecido ao campo
esteja sujeito validao em nvel de diretrio, configure o campo com um atributo que
esteja mapeado no directory.xml para o conjunto de regras apropriado.

Como iniciar a validao


Em tempo de execuo, a validao iniciada de uma das seguintes maneiras:
O usurio envia uma tarefa
Valida os campos na tela de tarefas enviadas que esto associados s regras de
validao.
O usurio navega para uma guia diferente da tela de tarefas
Valida os campos na guia vaga que esto associados s regras de validao.

190 Guia de Design do Console de Usurio

Implementaes de amostra

O usurio clica um boto Validar em uma guia


Valida os campos na guia atual que esto associados s regras de validao.
O boto Validar tambm executa Manipuladores de atributos lgicos que incluem o
mtodo de validao.
O usurio altera um valor em um campo cuja propriedade Validar mediante alterao
yes
Valida os campos na guia atual que esto associados s regras de validao.
Por exemplo, se Validar mediante alterao estiver ativada para um campo Tipo de
funcionrio e o valor do campo for alterado de Non-exempt para Exempt, todos os
campos na guia que esto associados s regras de validao sero validados. Uma
regra pode exigir que um campo Salary contenha um valor e outra regra pode
alterar automaticamente um campo Hourly Rate para 0.
O cdigo personalizado usa um mtodo setAttribute... em AttributeCollection ou um
manipulador de guias para definir um valor de atributo de objeto gerenciado
O campo configurado com o atributo de objeto gerenciado que est sendo
definido.

Implementaes de amostra
As implementaes de amostra das regras de validao do JavaScript esto localizadas
no diretrio de exemplos a seguir da sua instalao do CA IdentityMinder:
Identity Manager\samples\validationscripts

Captulo 10: Regras de validao 191

Apndice A: Lista de guias padro


O CA IdentityMinder inclui as seguintes guias padro para tarefas administrativas.
Access Role Administrators
Permite adicionar, exibir ou remover administradores da funo de acesso atual.
Associao da funo de acesso
Permite adicionar, exibir ou remover integrantes da funo de acesso atual.
Access Role Profile
Define o perfil para funes e acesso.
Access Role Tasks
Permite exibir tarefas de acesso de uma funo, ou adicionar ou remover tarefas de
acesso. Voc pode selecionar tarefas de acesso de diferentes aplicativos.
Funes de acesso
Permite exibir, adicionar ou remover as funes do usurio selecionado e exibir os
privilgios desse usurio.
Access Task Profile
Define o perfil para tarefas de acesso.
Contas
Lista as contas em terminais gerenciados para usurios que receberam funes de
provisionamento. Em geral, essa guia adicionada s tarefas que permitem exibir
ou modificar um usurio.
Modelos de conta
Permite adicionar, remover ou exibir modelos de conta associados a uma funo de
provisionamento.
Admin Role Administrators
Permite adicionar, exibir ou remover administradores da funo administrativa
atual.
Associao da funo administrativa
Permite adicionar, exibir ou remover integrantes da funo administrativa atual.
Admin Role Profile
Define o perfil para tarefas administrativas.

Apndice A: Lista de guias padro 193

Implementaes de amostra

Admin Role Tasks


Permite exibir tarefas administrativas de uma funo, adicionar ou remover tarefas
administrativas e selecionar tarefas administrativas de categorias diferentes.
Funes administrativas
Permite exibir, adicionar ou remover funes administrativas de um usurio
selecionado e exibir privilgios de administrador e integrante desse usurio.
Admin Task Profile
Define a guia Perfil para tarefas administrativas.
Administradores
Permite adicionar, editar ou remover polticas administrativas.
Aprovadores
Lista todos os participantes que podem aprovar ou rejeitar o item de trabalho.
Tambm permite a reatribuio do item de trabalho.
Aprovar tarefa
Exibe informaes sobre tarefas de aprovao individuais em uma lista de tarefas.
Aprovar evento
Exibe informaes sobre tarefas de aprovao individuais em uma lista de tarefas.
Certificar usurio
Permite certificar ou revogar funes de um usurio.
Polticas correspondentes atuais/Polticas j aplicadas
Exibe o status da sincronizao para usurios.
Eventos
Permite que voc selecione e configure um processo de fluxo de trabalho para cada
evento que a tarefa iniciada.
Executar Explorar e correlacionar
Permite selecionar uma definio explorar e correlacionar a ser executada.
Execute Explore and Correlate Profile
Exibe os recipientes em um terminal que voc pode explorar ou correlacionar.
Guia externa (ExternalTab)
Exibe o contedo de um URL dentro da guia em uma tarefa.
Campos
Permite exibir os campos contidos na tarefa. Os campos so os atributos definidos
na tela de perfil associado.

194 Guia de Design do Console de Usurio

Implementaes de amostra

Administradores de grupo
Adiciona ou remove os administradores do grupo atual.
Associao ao grupo
Adiciona ou remove os usurios como integrantes de grupo, ou adiciona ou remove
grupos aninhados nesse grupo.
Perfil do grupo
Permite definir ou exibir o perfil do grupo.
Grupos
Permite exibir, adicionar ou remover os grupos de um usurio selecionado e exibir
os privilgios desse usurio.
Identity Policy Set Owners
Permite adicionar regras de proprietrio, que so regras sobre quem pode
modificar o conjunto de polticas de identidade.
Identity Policy Set Profile
Define o perfil do conjunto de polticas de identidade.
JSP
Exibe informaes personalizadas. Consulte o administrador do sistema para obter
detalhes.
Manage System or Orphan Accounts
Atribui um usurio global a um sistema ou conta rf.
Integrantes
Permite adicionar, editar ou remover polticas de integrante.
Organization Profile
Permite criar, modificar ou exibir o perfil de uma organizao.
Proprietrios
Permite adicionar, editar ou remover polticas de proprietrio.
Polticas
Cria ou modifica uma poltica de identidade.
Perfil (AdminTaskProfile)
Permite que voc defina o perfil da tarefa administrativa.
Perfil (Generic) (ObjectProfile)
Permite que voc defina o perfil para qualquer objeto gerenciado.

Apndice A: Lista de guias padro 195

Implementaes de amostra

Provisioning Role Administrators


Permite adicionar, exibir ou remover administradores da funo de
provisionamento atual.
Associao da funo de provisionamento
Permite adicionar, exibir ou remover integrantes da funo de provisionamento
atual.
Provisioning Role Profile
Define o perfil da funo de provisionamento.
Guia Recorrncia
Controla a programao para quando a ao explorar e correlacionar deve ocorrer.
Escopo (TaskScope)
Permite limitar o escopo da tarefa. Se a tarefa no tiver nenhum objeto principal ou
se a ao for automodificar, autoexibir e aprovar, a guia Pesquisar no ser exibida.
Programao
Permite que voc automatize a execuo de uma tarefa em uma data posterior.
Resumo da sincronizao
Exibe o status da sincronizao para usurios.
Guias

Guias (TaskTab)
Permite selecionar um controlador de guias, que determina como as guias em uma
tarefa so exibidas, bem como exibir, adicionar ou remover as guias includas na
tarefa.
Histrico do usurio
Exibe um histrico de todas as tarefas que foram iniciadas, aprovadas e executadas
por qualquer usurio.
Lista de tarefas
Exibe uma lista de itens de tarefa (ou tarefas de aprovao) que ser exibida no
Console de usurio do CA IdentityMinder do participante autorizado a aprovar a
tarefa.
Perfil de usurio
Define ou exibe o perfil de um usurio.
Essa guia inclui funcionalidade adicional, como gerar eventos separados para
alteraes de senha, que especfica aos objetos de usurio.

196 Guia de Design do Console de Usurio

Apndice B: Compilar os JSPs do CA


IdentityMinder
Aps fazer alteraes nos JSPs do CA IdentityMinder usados para gerar o Console de
usurio e o Management Console em um servidor de aplicativos do JBoss, recompile os
JSPs para que as alteraes tenham efeito.
O JSP deve ser compilado usando o script compile_jsp.bat ou .sh.
O script compile_jsp cria uma cpia de backup dos JSPs e os recompila. As cpias de
backup esto localizadas nos seguintes diretrios:

Para o Console de usurio, o script compile_jsp cria o diretrio iam/im_jsp_backup


no seguinte local:
iam_im.ear\user_console.war

Para o Management Console, o script compile_jsp cria o diretrio


iam/im_jsp_backup no seguinte local:
iam_im.ear\management_console.war

Para recompilar os JSPs em um ambiente do JBoss


1.

Interrompa o servidor de aplicativos do JBoss, se ele estiver em execuo.

2.

Em um prompt de comando, navegue at jboss_home\bin, onde jboss_home o


local de instalao do servidor de aplicativo do JBoss.

3.

Execute um dos seguintes scripts:

4.

Windows: compile_jsp.bat

UNIX: compile_jsp.sh

Inicie o servidor de aplicativos do JBoss.

Apndice B: Compilar os JSPs do CA IdentityMinder 197