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:
- Criar um novo registro e incluí-lo no banco de dados.
- Modificar informações no registro. (Os comportamentos associados
a cada campo também podem limitar o acesso a campos específicos do registro).
- Mover um registro de um estado para outro.
- Marcar um registro como uma duplicata de outro.
- Executar um gancho. Os ganchos de ações podem manipular o controle de acesso,
a inicialização, a validação e a notificação. Consulte o Customizando Ações Incluindo Ganchos.
- Excluir um registro do banco de dados.
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.
- Ocultar
- A ação Ocultar possibilita ao Schema Designer ocultar ações que o usuário não tem permissão para executar devido a um gancho de controle de acesso de ação.
- 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.