Ganchos de Ações

Os ganchos de ações podem controlar quem possui permissão para alterar valores de registros e validar entradas de usuários antes que elas sejam consolidadas no banco de dados. Os ganchos de ações também podem validar o registro inteiro e enviar notificação de e-mail quando a ação é concluída.

O escopo de um gancho de ação é o registro atual. Os tipos suportados de ganchos de ações são listados na tabela a seguir na ordem na qual são executados.

Gancho de Ação Utilização

Controle de Acesso

Executa quando a ação estiver prestes a ser iniciada.

Retorna um valor Booleano que indica se o usuário especificado pode iniciar a ação especificada em um registro. Esse gancho é chamado antes do usuário desempenhar a ação. Para ações aninhadas, um gancho de controle de acesso não é executado. Você pode gravar um gancho de controle de acesso como uma sub-rotina em VBScript ou Perl. Para executar uma ação primária (modificar, enviar, excluir, importar), o usuário atual deve estar na lista de controle de acesso para a ação primária e para todas as ações base. Consulte Restringindo o Acesso do Usuário a Ações.

Inicialização

Executa quando a ação for iniciada.

Configure valores de campos iniciais (ou qualquer tarefa especificada). Permite a inicialização complexa de um registro. Você pode utilizar este gancho para configurar os valores de campos antes do início da ação. Esse gancho é chamado após a inicialização da ação, mas antes do conteúdo do registro ser exibido em um formulário. Você deve gravar um gancho de inicialização como uma sub-rotina de script.

Validação

Executa quando o usuário consolida a ação.

Valida os valores de campos especificados. Se o usuário digitar dados inválidos, o usuário será solicitado por dados válidos. Esse gancho pode ser utilizado para verificar condições que são difíceis de serem examinadas nos ganchos de validação de campos individuais. Por exemplo, você pode utilizar este gancho para verificar informações em um grupo de campos. Este gancho é executado antes que quaisquer alterações sejam consolidadas no banco de dados. Os ganchos de validação devem utilizar um script. Consulte Editando uma Lista Dinâmica.

Confirmar

Executa imediatamente antes da transação ser consolidada no banco de dados.

Vincula uma ação em vários registros a uma única transação (por exemplo, resolver todas as duplicatas de um controle de mudanças durante a resolução do original). Atualiza um conjunto de origens de dados externas para mantê-las consistentes com o conteúdo do banco de dados. Esse gancho é chamado após a inclusão de alterações no banco de dados, mas antes da confirmação dessas alterações. Você pode gravar um gancho de confirmação como uma sub-rotina em VBScript ou Perl.
Nota: Se você usar o método SetFieldValue em um gancho Consolidação, o valor do novo campo aparecerá no registro após a execução do script, mas o valor não será salvo no banco de dados. Você deve utilizar o gancho de ação Validação para designar valores de campos.

Notificação

Executa após a transação ser consolidada.

Inicia uma ação que notifica os usuários quando uma ação é desempenhada. Consulte o E-mail do Rational ClearQuest. Os ganchos de notificação devem utilizar um script.

Para obter informações adicionais, consulte:


Feedback