Ganchos de Campos

Um gancho de campo é útil para um evento que afeta um determinado campo no registro. Um gancho de campo pode configurar um valor inicial, responder eventos quando um valor de campo for alterado, forçar permissões de acesso que permitem apenas grupos de usuários especificados a alterarem valores de campos e validar os valores que os usuários fornecem.

O escopo de um gancho de campo é o campo atual no registro atual. Os seguintes tipos de ganchos de campos são suportados:

Gancho de Campo
Descrição
Lista de Opções
Retorna um conjunto de valores válidos. Utilize esse gancho com campos que são exibidos utilizando um controle de tipo de lista, como uma lista de opções ou caixa de combinação. Também é possível fornecer valores sem script utilizando uma constante ou lista dinâmica. Consulte Criando uma Lista de Opções para um Campo.
Valor Padrão
Configura o valor inicial do campo. Esse gancho é chamado no início de uma ação Submit. Você pode gravar um gancho de valor padrão com uma sub-rotina de script. Também é possível designar um valor constante como o valor padrão.
Permissão
Retorna uma das constantes BehaviorType que indica o acesso do usuário ao campo. Utilize esse gancho para aplicar fluxo de trabalho e/ou segurança. (Consulte IBM Rational ClearQuest API Reference para obter as constantes enumeradas). Se você incluir um gancho Permissão em um campo, você deve modificar a grade Comportamentos para que, pelo menos, um comportamento de campo seja configurado como USE_HOOK. A falha ao realizar isto provoca um erro de validação.
Validação
Valida o conteúdo do campo. Este gancho é chamado quando o valor é alterado, para fornecer ao usuário um feedback imediato sobre a validade do conteúdo do campo antes de consolidar o registro no banco de dados.
Valor Alterado
Responde a alterações no valor de um campo. Utilize este gancho para atualizar outros campos (por exemplo, listas dependentes). Após a execução deste gancho, qualquer campo que o script modificou será validado chamando o gancho Validação (se houver) para o campo.

Os ganchos são executados de acordo com as regras especificadas em Ordem de Execução de Ganchos de Campos e Ações.

Consulte Também


Feedback