8.2 Web Client

No Web Client, você pode personalizar as propriedades do objeto, os formulários de automação do workflow e a marca da interface do usuário. Quando implementadas corretamente, as personalizações de propriedade e workflow ajudarão a automatizar as tarefas do administrador assistente durante o gerenciamento de objetos e os envios automatizados de workflow.

8.2.1 Personalizando Páginas de Propriedades

Você pode personalizar os formulários de propriedade do objeto que os seus administradores assistentes usam em suas funções de gerenciamento do Active Directory por tipo de objeto. Isso inclui criar e personalizar novas páginas de objetos baseadas em tipos de objetos que são incorporados ao DRA. Você também pode modificar propriedades para os tipos de objetos integrados.

Objetos são claramente definidos na lista Páginas de Propriedade no Console da Web para que você possa identificar facilmente quais páginas de objeto estão incorporadas, quais páginas internas são personalizadas e quais páginas não são internas e foram criadas por um administrador.

Personalizando uma página de propriedades do objeto

Você pode personalizar formulários de propriedade do objeto adicionando ou removendo páginas, modificando páginas e campos existentes e criando manipuladores personalizados para atributos de propriedade. Quando você cria manipuladores personalizados, eles são executados automaticamente quando um campo de propriedade muda ou quando um administrador responde a um prompt para executar uma consulta, dependendo de como o manipulador personalizado está configurado.

A lista de objetos em Property Pages fornece dois tipos de operação para cada tipo de objeto, Criar Objeto e Editar Propriedades. Essas são as principais operações que os seus administradores assistentes executam no Cliente Web e suas personalizações podem melhorar a eficiência e a experiência do administrador ao gerenciar objetos do Active Directory no DRA.

Para personalizar uma página de propriedades do objeto no console da Web:

  1. Efetue login no console da Web como administrador do DRA.

  2. Acesse Personalização > Páginas de Propriedade.

  3. Selecione um objeto e tipo de operação (criar ou editar) na lista Páginas de Propriedades.

  4. Clique no botão Editar.

  5. Personalize o formulário de propriedade do objeto seguindo um ou mais destes procedimentos e então aplicando suas mudanças:

    • Adicionar uma nova página de propriedades: Adicionar Página

    • Selecionar uma página de propriedades e personalize a página:

      • Reordenar campos de configuração na página:

      • Editar campos ou subcampos:

      • Adicionar um ou mais campos: ou Adicionar Campo

      • Remover um ou mais campos:

    • Criar manipuladores personalizados para propriedades usando scripts, caixas de mensagens ou consultas (LDAP, DRA ou REST)

      Para obter mais informações sobre o uso de manipuladores personalizados, consulte Adicionando manipuladores personalizados.

Criando uma nova página de propriedades do objeto

Para criar uma nova página de propriedades do objeto:

  1. Efetue login no console da Web como administrador do DRA.

  2. Acesse Personalização > Páginas de Propriedade.

  3. Em Tarefas, clique em Criar Nova Ação.

  4. Crie o formulário inicial de propriedades do objeto definindo seu nome, ícone, tipo de objeto e configuração de operação.

  5. Personalize o novo formulário conforme necessário. Consulte Personalizando uma página de propriedades do objeto.

8.2.2 Personalização de formulários de workflow

Os formulários de workflow, quando criados ou modificados, são gravados no servidor Web e acessados no console da Web na página Personalização > Workflow. Estes formulários são usados para enviar fluxos de trabalho automatizados criados no servidor da Automação de Workflow. Você pode personalizar os formulários para automatizar ainda mais e melhorar a usabilidade de formulários para administradores assistentes quando eles usam os formulários para executar tarefas de gerenciamento de objetos.

Você pode adicionar e modificar propriedades de formulário e manipuladores personalizados. O comportamento da interface para adicionar e personalizar propriedades é o mesmo em um formulário de Automação do Workflow, como ocorre ao personalizar propriedades do objeto. Faça referência aos tópicos abaixo para obter mais informações sobre como adicionar e modificar propriedades, adicionar manipuladores personalizados e entender a Automação do Workflow.

Adicionando manipuladores personalizados

Os manipuladores personalizados são usados no DRA para que os atributos de propriedade interajam entre si para realizar uma tarefa de workflow e para Carregar e Enviar personalizações em um workflow, propriedade ou formulário de criação.

Alguns exemplos de manipuladores personalizados de propriedade incluem a consulta do valor de outros campos, a atualização de valores, a alternação do estado apenas leitura de um campo e a exibição ou ocultação de campos com base em variáveis configuradas.

Os manipuladores de carga de formulário permitem que os usuários personalizem formulários, executando normalmente algumas inicializações de controles. Os Manipuladores de Envio de Formulários permitem que os usuários façam alguma validação e cancelem a submissão se algo não estiver certo.

O DRA também simplifica a criação de manipuladores personalizados com várias macros JavaScript (JS) selecionáveis que você pode escolher no processo de criação e validação do manipulador personalizado.

Etapas básicas para criar um manipulador personalizado:

As etapas abaixo começam em uma página de manipulador personalizado pré-selecionada. Para chegar a esse ponto, você acessa os manipuladores personalizados da propriedade do objeto por meio do botão de edição em um campo de propriedade. Você acessa os manipuladores Carga de Formulário e Envio de Formulário nas Propriedades do Formulário em um formulário de workflow ou em uma página de objeto de criação.

  1. Clique na guia de manipuladores personalizados aplicáveis e habilite a página .

    • Manipuladores personalizados

    • Manipuladores de carga de formulários

    • Manipuladores de envio de formulários

  2. Escolha um manipulador personalizado no menu suspenso e selecione um tempo de execução. Normalmente, você usaria a segunda ou terceira opções para o Tempo de Execução.

    NOTA:Normalmente, você pode exigir apenas um manipulador personalizado, mas é possível usar mais de um manipulador configurando controles de fluxo no script para vincular manipuladores juntos.

  3. Você precisará configurar cada manipulador personalizado que você adiciona à página. As opções de configuração variam de acordo com o tipo de manipulador, mas todos os manipuladores são executados de JavaScript.

    Você pode criar suas próprias entradas do Vanilla JavaScript ou usar as macros incorporadas.

    • Manipuladores LDAP ou REST Query:

      1. Se você quiser que sua consulta seja baseada em valores estáticos, defina Informações de Conexão e Parâmetros de Consulta.

        Se você quiser que sua consulta seja dinâmica, digite o texto do marcador nos campos obrigatórios. Isso é necessário para que o script seja executado. O script anulará os valores falsos.

        NOTA:Você também pode configurar cabeçalhos e cookies para a Consulta REST.

      2. Em Ação de Pré-Consulta, selecione um tipo de macro: Global, Consulta ou Campo de Formulário.

      3. Escolha uma macro na lista suspensa e insira a macro (</> Insert Macro).

      4. Insira outras macros conforme necessário e forneça os valores desejados para concluir o script.

        Por exemplo, na ação de pré-consulta, usaremos um script para validar que um nome de grupo inserido por um usuário ainda não existe no Active Directory quando o formulário é enviado.

        Precisamos criar uma consulta LDAP usando o nome inserido pelo usuário. Nós usamos a macroField() para acessar o valor do campo Nome e criar a string de consulta que, em seguida, definimos como o filtro de consulta usando a macro Filter().

        Filter() = '(&(objectCategory=group)(objectClass=group)(name=' + Field(name) + '))';

      5. Seguindo com o exemplo acima, na Ação Pós-Consulta, verificaremos os resultados retornados pela consulta. Os resultados são retornados como uma matriz de objetos que correspondem à consulta, portanto, precisamos apenas verificar se o tamanho da matriz é maior que 0.

        Quando um grupo correspondente é encontrado, usamos a macro Cancel() para cancelar a submissão de formulários, passando à macro uma mensagem opcional para exibir ao usuário.

        if (QueryResults().length > 0) { Cancel('Já existe um grupo com esse nome, digite um nome exclusivo.');}

    • Script: Insira um código JavaScript personalizado ou use as macros para criar o script.

    • Consulta do DRA: Para os parâmetros de consulta, defina uma payload no formato JSON. Em seguida, use macros de maneira semelhante à descrita acima para consultas LDAP e REST.

    • Manipuladores de caixa de mensagem: Após definir as propriedades da própria caixa de mensagem, use macros de maneira semelhante à descrita acima para consultas LDAP e REST, mas, em vez de ações de Pré-Consulta e Pós-Consulta, você compõe os scripts de macro para ações Antes de Mostrar e Após Fechar.

  4. Clique em Manipuladores de Teste para validar seu script antes de gravar o formulário.

    Isso gerará um Resumo do Resultado do Teste, no qual você poderá ver os resultados da execução.

NOTA:Se o manipulador depender do estado atual do formulário (por exemplo, o campo tem um valor), ele não será executado com êxito, uma vez que nenhum dado será carregado durante a edição de um formulário. Nesses casos, o manipulador precisará ser testado fora do editor de formulários gravando a personalização, navegando para o formulário apropriado e preenchendo os dados necessários.

8.2.3 Personalização da marca da interface do usuário

Você pode personalizar a barra de título do Console da Web do DRA com seu próprio título e imagem do logotipo. A veiculação está imediatamente à direita do nome do produto DRA. Como esse local também é usado para navegação de nível superior, ele é oculto pelos links de navegação do DRA de nível superior após efetuar login. No entanto, a guia do browser continua exibindo o título personalizado.

Para personalizar a marca do título no DRA:

  1. Efetue login no console da Web como administrador do DRA.

  2. Acesse Personalização > Marca.

  3. Se você estiver adicionando um logotipo da empresa, grave a imagem do logo em components\lib\img no Servidor Web.

  4. Adicione as informações necessárias, conforme aplicável, para os três campos da página de personalização da marca e grave suas mudanças.