O software Rational ClearQuest Web suporta um subconjunto da funcionalidade completa de gancho, o qual um desenvolvedor de esquemas pode configurar.
Os ganchos de Lista de Opções configuram as opções associadas a um campo. Quando uma lista de opções para o campo é determinada por um outro campo, esse outro campo deve listar o campo de destino como seu campo dependente da Web. Os tipos de controles que podem ser exibidos para os campos de gancho de Lista de Opções são caixa de combinação, caixa de combinação drop-down e lista de opções drop-down.
Execute quando um formulário de envio é exibido (e não quando um registro é enviado clicando Salvar).
Executa somente quando o formulário é exibido pela primeira vez no modo de edição.
Executa somente quando o formulário é salvo (não quando o usuário altera um valor de campo).
Os ganchos Menu de Contexto não são suportados em nenhum controle de formulário.
Ao utilizar ganchos Value Changed, você deve garantir que o gancho Value Changed seja executado no momento apropriado e que os resultados estejam visíveis aos usuários do Rational ClearQuest Web Client.
Os ganchos do campo Value Changed são executados quando o navegador se comunica com o Rational ClearQuest Server. Algumas vezes, esta comunicação ocorre imediatamente após um usuário alterar o valor em um campo do formulário (por exemplo, selecionando um item em uma lista drop-down). Em outras situações, a comunicação ocorre somente após o usuário salvar o novo valor.
Um gancho Value Changed é executado mais tarde, quando um usuário altera o valor de outros tipos de controles, tais como um controle ListView ou um controle Anexos, mas não até o usuário clicar no botão Salvar no formulário. Ele também é executado quando uma caixa de listagem drop-down, caixa de combinação drop-down ou caixa de combinação não possui nenhum campo dependente da Web. Mover entre guias em um formulário no navegador não faz com que o navegador se comunique com o Rational ClearQuest Server.
Após assegurar que um gancho Value Changed seja executado no momento apropriado, você deve garantir que quando um gancho Value Changed for executado, as alterações realizadas na lista de valores ou opções de outros campos (de destino) no registro estejam visíveis ao usuário após a execução do gancho ser concluída. Quando tais alterações forem realizadas, elas estarão visíveis somente para o usuário no navegador se o campo de destino for declarado como um campo dependente da Web nas Propriedades do controle de formulário para o campo com o gancho Value Changed
Se um controle de formulário for uma caixa de listagem drop-down, caixa de combinação drop-down ou caixa de combinação cujo campo inclui um gancho Value Changed que é executado no Rational ClearQuest Web imediatamente e for escrito para uma das finalidades a seguir, considerações especiais serão aplicadas:
Quando um gancho Value Changed altera o valor ou invalida a lista de opções de um ou mais campos de destino, o navegador atualiza a exibição para os novos valores dos campos de destino se esses campos estiverem configurados como campos dependentes da Web do controle de formulário. Tais campos são atualizados quando um usuário altera o valor do controle do formulário.
Embora você possa configurar um controle ListView como um campo dependente da Web, esta configuração não funciona em controles ListView com o Rational ClearQuest Web.
Quando um gancho de origem é alterado apenas se um ou mais campos de destino forem obrigatórios, você não precisa configurar todos os campos de destino como campos dependentes da Web do controle de formulário. O navegador atualiza a exibição dos detalhes de todos os campos obrigatórios no formulário, não apenas os campos que são dependentes da Web.
O controle de formulário deve ter, pelo menos, um campo dependente da Web para garantir que o gancho Value Changed seja imediatamente executado. Embora você possa selecionar qualquer campo como o campo dependente da Web, para um melhor desempenho, selecione um campo que não possua uma lista longa de opções.