24.3 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.

Sub-rotinas personalizadas de propriedades

Alguns exemplos de sub-rotinas personalizadas de propriedades incluem:

consultar o valor de outros campos
atualizar valores do campo
alternar o estado apenas leitura de um campo
mostrar ou ocultar campos com base em variáveis configuradas

Sub-rotinas de carregamento de formulário

Sub-rotinas de carregamento de formulário normalmente executam controles de inicialização. Elas são executadas apenas uma vez quando o formulário é carregado inicialmente. No caso de páginas de propriedades, elas são executadas antes que o servidor seja consultado quanto às propriedades do objeto selecionado.

Sub-rotinas de envio de formulário

As sub-rotinas de envio de formulário permitirão que os usuários façam algum tipo de validação e cancelem a submissão de formulários caso algo não esteja certo.

Para obter exemplos mais detalhados do uso de sub-rotinas personalizadas e personalizações no Console da Web, consulte as seções Web Console Customization (Personalização do Console da Web) e Workflow Customization (Personalização do workflow) na referência Product Customization (Personalização do produto) na Página de documentação do DRA.

Habilitando JavaScript Personalizado

Por motivos de segurança, o JavaScript personalizado está desabilitado por padrão. Habilitar o JavaScript personalizado permite que os administradores escrevam snippets de código JavaScript que serão executados pelo console da Web no estado em que se encontram. Você só deverá habilitar essa exceção se entender e aceitar os riscos.

Para habilitar personalizações para incluir código JavaScript personalizado:

Navegue até o local C:\ProgramData\NetIQ\DRARESTProxy .
Abra o arquivo restProxy.config.
Adicione allowCustomJavaScript="true" ao elemento <consoleConfiguration>.

24.3.1 Etapas básicas para criar uma sub-rotina personalizada:

As etapas abaixo começam em uma página da sub-rotina personalizada pré-selecionada. Para chegar a esse ponto, você acessa as sub-rotinas personalizadas de propriedade do objeto por meio do ícone de propriedades em um campo de propriedade. Você acessa as sub-rotinas Carregamento de Formulários e Envio de Formulários por meio do botão Propriedades de Formulários em um formulário de Workflow selecionado em uma página Criar Objeto ou em uma página Editar Propriedades.

Selecione a guia da sub-rotina aplicável com base na propriedade ou na página que você está personalizando:
- Manipuladores personalizados
- Manipuladores de carga de formulários
- Manipuladores de envio de formulários
Habilite a página da sub-rotina e siga um destes procedimentos:
- Sub-rotina personalizada do campo de propriedade:
  1. Selecione um tempo de execução. Normalmente, você usaria a segunda ou a terceira opção para o Tempo de Execução.
  2. Clique em + Adicionar e escolha a sub-rotina personalizada do menu Adicionar Sub-rotina Personalizada.
- Sub-rotina de formulário: Clique em + Adicionar e escolha uma sub-rotina personalizada no menu Adicionar Sub-rotina Personalizada.
NOTA:Normalmente, você precisa de apenas uma sub-rotina personalizada, mas pode usar mais de uma. Várias sub-rotinas são executadas sequencialmente na ordem listada. Se você deseja mudar a ordem das sub-rotinas ou ignorar uma sub-rotina desnecessária, adicione macros de controle de fluxo ao script.
Você precisará configurar cada sub-rotina personalizada que adicionar à página. As opções de configuração variam de acordo com o tipo de sub-rotina.

Você pode criar seus próprios tipos de sub-rotinas.
- Sub-rotinas de consulta LDAP ou REST:
  1. Se desejar que sua consulta seja baseada em valores estáticos, defina as Informações de Conexão e os Parâmetros de Consulta.
    
    Se desejar que sua consulta seja dinâmica, digite os valores do marcador de espaço nos campos obrigatórios. Isso é necessário para que a sub-rotina seja executada. O script anulará os valores do marcador de espaço.
    
    NOTA:Você também pode configurar Cabeçalhos e Cookies para a Consulta REST.
  2. Em Ação de Pré-consulta, use o editor de scripts para escrever o código JavaScript personalizado que será executado antes da submissão da consulta. Este script tem acesso a todas as informações de conexão e parâmetros de consulta e pode modificar qualquer um deles para personalizar a consulta. Por exemplo, definindo parâmetros de consulta com base nos valores que o usuário inseriu no formulário.
  3. Na Ação Pós-consulta, inclua script para processar os resultados da consulta. As tarefas comuns incluem verificação de erros, atualização dos valores do formulário com base nos resultados retornados e validação da exclusividade do objeto com base no número de objetos retornados pela consulta.
- Script: Insira o código JavaScript personalizado para criar o script.
- Consulta do DRA: Especifique o payload JSON na guia Parâmetros de Consulta. O formato do payload deve corresponder à chave VarSet ou aos pares de valores que serão enviados ao servidor do DRA. De modo semelhante às consultas REST e LDAP, você pode especificar uma Ação de Pré-consulta que pode ser usada para modificar o payload antes de ser submetida ao servidor e uma Ação Pós-consulta para processar os resultados.
- Sub-rotinas da Caixa de Mensagem: Depois de definir as propriedades da própria caixa de mensagem, você também pode gravar os segmentos de JavaScript para Ação Antes de Mostrar e Ação Após o Fechamento.
  
  Essas ações são opcionais. A ação Antes de Mostrar é usada para personalizar qualquer uma das propriedades da caixa de mensagem antes de ser mostrada ao usuário e a ação Após o Fechamento é usada para processar a seleção de botões do usuário e executar qualquer lógica adicional baseada nela.
Clique em OK para gravar a sub-rotina.