Este tópico explica o conceito de um gancho de campo do ClearQuest.
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.