O software Rational ClearQuest Web
suporta um subconjunto da funcionalidade completa de gancho, o qual um desenvolvedor de esquemas pode
configurar.
Os ganchos criados no esquema do
Rational ClearQuest são
executados nos computadores que executam o servidor do
Rational ClearQuest.
Lembre-se dos seguintes pontos ao usar ganchos com o Rational ClearQuest Web:
- Não é possível usar caixas de mensagem do Visual Basic ou Perl como é possível no
cliente do desktop. Entretanto, é possível exibir caixas de mensagens de informações,
aviso e erro, definindo uma mensagem customizada ou abrindo um formulário de registro
previamente preenchido. Consulte Criando uma Mensagem Customizada e Abrindo um Formulário Previamente Preenchido.
- Os ganchos do menu de Contexto não recebem suporte do aplicativo Rational ClearQuest Web.
- É possível usar ganchos para detectar uma sessão da web.
Os tipos de ganchos a seguir são suportados:
- Ganchos de Campos
- Lista de Opções
- Configura as opções associadas a um campo. Quando uma lista de opções para um campo é
determinada por um outro campo, o outro campo deve listar o campo de destino como seu
campo dependente da web. Os tipos de controle que podem ser exibidos para os campos de
gancho de Lista de Opções são caixa de combinação, caixa de combinação suspensa e lista
suspensa.
- Valor Padrão
- É executado quando um formulário de envio é exibido. Não é executado quando um
registro é enviado clicando em Salvar.
- Permissão
- É executado somente quando o formulário é exibido primeiro no modo de edição.
- Validação
- É executado somente quando o formulário é salvo. Não é executado quando o usuário
altera um valor de campo. Os ganchos de validação podem ser executados em momentos
diferentes, dependendo do tipo de controle de formulário e se a propriedade do campo foi
especificada como dependente da web. Para obter informações adicionais, consulte
Considerações Especiais para Ganchos de Campos.
- Valor Alterado
- É executado quando o valor do campo fornecido é alterado nestes tipos de controle de
formulário: lista suspensa, caixa de combinação suspensa e caixa de combinação. Os
ganchos de Valor Alterado podem ser executados em momentos diferentes, dependendo do tipo
de controle de formulário e se a propriedade do campo foi especificada como dependente da
web. Para obter informações adicionais, consulte
Considerações Especiais para Ganchos de Campos.
- Ganchos de Ações
- Controle
de Acesso
- Inicialização
- Validação
- Confirmar
- Notificação
- Scripts de Registro
- As ações do alias de script de registro são exibidas em uma lista suspensa no
botão Utilitários em um registro, em um estado específico.
- A ação de gancho é configurada na guia Ganchos de Botão das
propriedades de controle de botão, na área Ativar para web.
- Os ganchos
Menu de Contexto não são suportados em nenhum controle de formulário.
- Scripts Globais
Considerações Especiais para Ganchos de Campos
O
comportamento dos ganchos dos campos Valor Alterado e Validação depende da configurações
de tipo de controle de formulário e propriedade para os campos de destino. Revise as
considerações especiais a seguir para entender quando os ganchos são executados e como as
mudanças se tornam visíveis para os usuários de diferentes tipos de controle de
formulário.
- Valor Alterado
Um gancho de campo Valor Alterado é executado imediatamente após um usuário
alterar o valor nos seguintes campos de formulário:
Tipo de Campo |
Controle de Formulário |
REFERENCE |
- Caixa de combinação
- Caixa de combinação suspensa
- Lista suspensa
|
REFERENCE_LIST |
Lista |
SHORT_STRING |
- Caixa de combinação suspensa
- Lista suspensa
Nota: Esses controles de formulário requerem uma
associação de campo dependente da web a fim de que o gancho de Valor Alterado seja
executado imediatamente.
|
Um
gancho de Valor Alterado é executado na próxima vez que o navegador se comunicar com o
servidor ClearQuest quando o gancho for configurado em um tipo de campo SHORT_STRING com
um dos seguintes tipos de controles de formulário:
- Caixa de combinação
- Caixa de combinação suspensa
- Lista suspensa
A movimentação entre as guias de um formulário no
navegador não faz com que o navegador se comunique com o Rational ClearQuest Server.
- Ganchos de Campos de Validação
Um gancho de Validação é executado imediatamente no
ClearQuest Web client, mas o formulário deve
ser atualizado para ver os resultados.
Para
criar um botão Atualizar:
- Crie um gancho de script de registro sem código dentro dele. Nomeie o gancho como Atualizar.
- Crie um botão no formulário. Forneça ao botão o rótulo Atualizar.
- Clique com o botão direito do mouse no botão e, em seguida, clique em
Propriedades.
- Na guia Ganchos de Botão, na área
Ganchos, selecione o script de atualização de registro na lista
Gancho de Clique.
- Na área Ativar para web, selecione Gancho de
Clique.
O usuário do
ClearQuest Web client deve clicar no botão
Atualizar para ver os resultados do gancho de Validação.