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. Este gancho é chamado após as atualizações do o registro atual terem sido registradas no banco de dados, mas antes da transação de atualização ser consolidada. O gancho de Consolidação permite que a transação a ser estendida inclua atualizações em registros adicionais (por exemplo, resolução de todas as duplicatas de um pedido de alteração quando o original for resolvido). Nota: Como todas as atualizações no registro atual são registradas antes deste gancho executar, uma chamada para o método SetFieldValue no registro atual não terá efeito neste gancho. Você deve utilizar o gancho de ação Validação para modificar o registro atual na transação. Porém, é possível utilizar o gancho Consolidar para atualizar os registros que estão relacionados ao registro atual como parte de uma única transação.
|
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. |