Ações e Tipos de Ações

As ações são o mecanismo para envio de novos registros ao banco de dados, movimentação de registros de um estado para outro e a modificação ou exclusão de registros.

Quando os usuários clicam no botão Ações em um formulário ou abre o menu Ações na barra de ferramentas, uma lista de ações válidas é exibida e a ação padrão é destacada em texto negrito. Você define a ação padrão utilizando a guia Ação Padrão na janela Propriedades do Estado. Consulte o Ações Padrão. Também é possível chamar uma ação padrão a partir de um gancho.

Apenas as ações disponíveis neste momento, com base nas permissões do usuário e no estado do registro, serão exibidas. Para evitar potenciais problemas de desempenho, os ganchos de controle de acesso não são executados durante o cálculo de ações válidas.

Você pode definir uma ação para desempenhar estas tarefas:

Você pode controlar quais usuários possuem acesso a quais ações e quando as ações podem ser desempenhadas.

Uma variedade de tipos de ações predefinidas para ações mais utilizadas são suportadas, por exemplo, a ação Enviar e a ação Alterar Estado. Consulte o Tipos de Ações Suportadas.

No Designer, cada tipo de registro possui uma grade Ações que define as ações disponíveis para registros desse tipo. Você pode utilizar a grade Ações para incluir, modificar e excluir ações e para criar transições de estados.

Tipos de Ações Suportadas

O software Rational ClearQuest suporta os seguintes tipos de ações:

Tipo de Ação
Descrição
Base
A ação Base é uma ação secundária executada como um resultado de outra ação. Você pode escrever um gancho de ação para um ação Base, mas utilizar esse gancho com várias ações. Sempre que uma ação é executada, a ação Base verifica se o critério do gancho é atendido; se for, a ação base conclui seu processo. Por exemplo, você pode incluir um gancho de ação Notificação em uma ação Base para que a ação Base envie a notificação de e-mail quando ocorrer uma ação Fechar (um tipo de ação Change_state que move o registro para o estado Fechado). As ações Base não aparecem na lista de ações do cliente Rational ClearQuest.

A configuração do controle de acesso em ações Base afeta todas as ações no esquema. Você pode modificar o controle de acesso para ações, incluindo ações que podem ser incluídas em seu esquema aplicando pacotes. Entretanto, quaisquer restrições de controle de acesso colocadas em ações Base aplicam-se a todas as outras ações.

Alterar_estado
As ações Change_state estão disponíveis apenas para tipos de registro com estado. Uma ação Change_state move um registro de um estado de origem para um estado de destino. Uma ação Change_state pode referenciar vários estados de origem, mas apenas um estado de destino. As ações Change_state aparecerão na lista de ações no cliente Rational ClearQuest apenas se o registro atual for um dos estados de origem.
Excluir
A ação Excluir permite que usuários excluam um registro do banco de dados. As ações Delete aparecem na lista de ações no cliente Rational ClearQuest.
Duplicar
A ação Duplicar está disponível somente para os tipos de registro com base em estado. Esta ação vincula o registro a um outro registro que contém informações semelhantes. As ações Duplicate aparecerão na lista de ações no cliente Rational ClearQuest apenas se o registro atual for um dos estados de origem.
Importar
A ação Importar importa registros de uma outra origem. O conteúdo dos registros importados são validados como parte desta ação, mas a validação no nível do campo não é realizada. Além disso, quando um conjunto de registros com base em estado é importado, estes registros são designados a um estado especificado nos arquivos de dados sem qualquer verificação no sentido de assegurar que eles poderiam sofrer transição para esse estado. As ações Import não aparecem na lista de ações do cliente Rational ClearQuest.
Modificar
A ação Modificar permite que os usuários modifiquem os valores de campos em um registro sem mover o registro entre estados. As ações Modify aparecem na lista de ações no cliente Rational ClearQuest.
Record_script_alias
Record_script_alias associa um nome de ação a um script de registro. Isso permite que as ações record_script_alias apareçam na lista de ações do cliente Rational ClearQuest. No entanto, ações record_script_alias não são ações de entidade porque não fazem parte dos estados de tipo de registro e não funcionam automaticamente com uma entidade - seu comportamento é determinado pela maneira com o alias do script de registro é codificado. Como resultado, ações Record_script_alias não fazem parte dos parâmetros válidos para as funções de entidade como GetActionName e GetActionType ou qualquer outra função que trabalhe com ações de entidade.
Enviar
A ação Enviar insere um novo registro no banco de dados do usuário do Rational ClearQuest. Para registros com base em estado, esta ação designa um estado de destino, mas não requer uma origem. Cada tipo de registro pode ter apenas uma ação cujo tipo é Submit.
Remover Duplicação
A ação Remover Duplicação está disponível para os tipos de registro com base em estado. Esta ação remove o link entre registros duplicados.

Criando uma Transição de Estado

O desenvolvedor de esquemas do Rational ClearQuest define as regras de como os usuários moverão registros entre estados. As transições de estados são implementadas por ações. Para criar uma transição de estado, você define uma ação do tipo CHANGE_STATE e, em seguida, seleciona os estados de origem e um estado de destino para essa ação.

Customizando Ações Incluindo Ganchos

Você pode incluir ganchos de ações que implementam tarefas em pontos-chave no ciclo de vida de um registro ativo. Por exemplo, por padrão, todos os usuários possuem acesso a todas as ações. Você pode limitar o acesso a uma ação utilizando um gancho de controle de acesso.

Diversos ganchos de ações são suportados: Controle de Acesso, Inicialização, Validação, Consolidação e Notificação.

Para obter uma descrição dos ganchos de ações e informações sobre como eles funcionam com ganchos de campos, consulte Utilizando Ganchos para Customizar o Fluxo de Trabalho. Para aprender como criar um gancho de ação Access control, consulte Exemplo de gancho de ação Access control. Consulte também Linguagens de Script e Controle de Acesso de Ação.

Ações Padrão

Você pode definir ações padrão para estados. Uma ação padrão para um estado aparece em negrito no menu Ações no cliente no Rational ClearQuest.

As ações padrão são úteis para orientação de usuários por meio do modelo de estado. Elas são necessárias para determinados esquemas e pacotes, tais como o esquema e o pacote UCM. Se você utilizar o esquema ou pacote UCM, as ações padrão de seus estados deverão fornecer um caminho válido no modelo de tipo de estado. Para obter mais informações, consulte Incluindo uma Integração UCM do IBM® Rational. Além disso, as ações padrão podem ser chamadas a partir do código do gancho.

Antes de definir a ação padrão para um estado, é necessário primeiramente criar uma transição de estado.

Excluindo uma Ação

A exclusão de uma ação pode requerer outras mudanças em um esquema. Por exemplo, se você excluir uma ação CHANGE_STATE, você pode precisar modificar a Matriz de Transição de Estado para compensar a ação perdida. Se você fez referência a uma ação excluída em um script, você deve modificar seu script para exclusão de quaisquer referências à ação.


Feedback