Tipos de Ações
Cadastros – Tipos de Ações (Portal Easypac)
O cadastro de Tipo de Ação define as categorias de ação que ficam disponíveis quando alguém registra o tratamento de uma não conformidade (Corretiva, Preventiva, Imediata).
Visão Geral
O cadastro de Tipo de Ação define as categorias de ação que ficam disponíveis quando alguém registra o tratamento de uma não conformidade (Corretiva, Preventiva, Imediata). Cada tipo de ação tem um nome, uma sigla curta e duas situações independentes: se está ativo no portal e se está disponível no aplicativo.
É um cadastro de apoio: ele não registra nada sobre a qualidade em si — ele alimenta as listas de escolha das telas que registram. Por isso a exclusão de um tipo de ação já utilizado é bloqueada, e por isso a lista de seleção oferecida às outras telas mostra apenas os tipos ativos.
Pré-requisitos
Para usar a tela de Tipo de Ação, o usuário precisa estar autenticado no Portal Easypac e ter a permissão correspondente à operação que pretende executar (ver `Permissões e Perfis de Acesso`). Não há cadastro anterior obrigatório: o tipo de ação é um cadastro de primeiro nível, que não depende de empresa, local ou programa de qualidade previamente cadastrados.
Para que um tipo de ação apareça como opção no aplicativo, além de existir ele precisa estar com a marcação Aplicativo ligada.
Permissões e Perfis de Acesso
O acesso à tela de Tipo de Ação é controlado por quatro permissões independentes, uma por operação:
| Operação | O que a permissão libera |
|---|---|
| Visualizar | abrir a listagem de tipos de ação |
| Incluir | abrir o formulário em branco e gravar um tipo de ação novo |
| Editar | abrir o formulário preenchido e gravar alterações |
| Excluir | remover um tipo de ação da listagem |
As permissões são verificadas tanto ao abrir a tela quanto na operação enviada ao servidor — não basta esconder o botão. Um usuário com permissão apenas de visualizar consegue abrir a listagem, mas qualquer tentativa de gravar ou excluir é recusada pelo servidor.
O cadastro de Tipo de Ação não depende de módulo contratado: ele faz parte do núcleo de cadastros do portal e está disponível para todos os clientes.
A listagem também não é filtrada por empresa ou local: os tipos de ação são compartilhados por toda a base do cliente. Um tipo de ação cadastrado vale para todas as empresas e locais.
Fluxo Operacional
- O usuário acessa Cadastros e escolhe Tipos de Ações.
- A listagem abre com os tipos de ação já cadastrados, do mais recente para o
mais antigo.
- Para criar, o usuário aciona o botão de novo registro, preenche Nome e Sigla,
define as marcações Ativo e Aplicativo e grava.
- Para alterar, o usuário seleciona uma linha e aciona o botão de editar — ou
dá um duplo clique na linha. O formulário abre preenchido.
- Para remover, o usuário seleciona a linha e aciona o botão de excluir. O
sistema pede confirmação antes de remover.
- Após gravar ou excluir, o sistema informa o resultado e retorna à listagem.
Interface e Comportamentos da Tela
Listagem de tipos de ação
A listagem de Tipos de Ação exibe cinco colunas: identificador, Nome, Sigla, Ativo e Aplicativo. Nas colunas Ativo e Aplicativo, o valor gravado como 1 é exibido como “Sim” e qualquer outro valor como “Não”.
A listagem abre ordenada pelo identificador, do maior para o menor, com 20 registros por página. A ordenação, a paginação e a busca são resolvidas no servidor — a tela nunca carrega a base inteira.
A busca da grid tem dois comportamentos: quando o texto pesquisado é um número, a busca é feita pelo identificador exato; quando é texto, o sistema retorna os tipos de ação cujo Nome ou cuja Sigla contenham o termo.
Além dos botões de novo, editar e excluir, a grid oferece recarregar. O duplo clique numa linha abre a edição daquele tipo de ação.
Formulário de cadastro e edição
O formulário de Tipo de Ação tem quatro campos. Nome é obrigatório e aceita no máximo 75 caracteres. Sigla é obrigatória e aceita no máximo 2 caracteres. Ativo e Aplicativo são duas marcações independentes, que iniciam conforme o valor gravado do tipo de ação.
O botão Salvar só envia os dados quando Nome e Sigla estão preenchidos; caso contrário a tela destaca os campos pendentes e não chama o servidor. O botão Cancelar retorna à listagem sem gravar.
O cabeçalho da tela de edição exibe “Tipo de Ação:” seguido do nome do tipo de ação em edição, o que permite confirmar qual registro está aberto.
A mesma tela atende inclusão e edição: se o identificador for informado, o sistema busca o tipo de ação no servidor e preenche o formulário; se não for, abre um formulário vazio.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Gravação concluída | Aviso de sucesso, seguido de retorno à listagem | “Operação efetuada com sucesso.” |
| Exclusão concluída | Aviso de sucesso e recarga da listagem | “Operação efetuada com sucesso.” |
| Confirmação de exclusão | Diálogo com opção de cancelar — título | “Tem certeza?” |
| Confirmação de exclusão | Diálogo com opção de cancelar — texto | “Você está prestes a remover o tipo de ação: {identificador} – {nome}” |
| Nome não preenchido | Destaque do campo na própria tela, sem chamar o servidor | Nenhum texto — o campo obrigatório é marcado e o envio é bloqueado |
| Sigla não preenchida | Destaque do campo na própria tela, sem chamar o servidor | Nenhum texto — o campo obrigatório é marcado e o envio é bloqueado |
| Nome ausente na gravação | Aviso de erro | “É necessário informar o campo descricao” |
| Sigla repetida | Aviso de erro | “Já existe um tipo de ação com a sigla {sigla}” |
| Tipo de ação já utilizado | Aviso de erro, exclusão não ocorre | “Tipo de ação aplicada aos registros. Não pode ser Apagada!” |
| Exclusão sem identificador | Aviso de erro | “É necessário informar o id para efetuar a exclusão.” |
| Tipo de ação inexistente na edição | Aviso de erro | “Ação não encontrada.” |
Processamento pelo Backend
Ao gravar, o servidor executa nesta ordem:
- Recusa a gravação se o Nome não vier preenchido.
- Verifica se a Sigla já pertence a outro tipo de ação e recusa se pertencer.
- Decide entre criar e alterar pelo identificador recebido.
- Grava o registro e produz automaticamente o histórico de auditoria.
- Devolve os dados gravados acrescidos do usuário responsável e do momento da
gravação.
Ao excluir, o servidor executa nesta ordem:
- Recusa a exclusão se o identificador não vier informado.
- Verifica se o tipo de ação já foi aplicado a algum registro de ação corretiva
e recusa se tiver sido.
- Remove o registro e produz o histórico de auditoria.
- Devolve o usuário responsável e o momento da exclusão.
Regras de Negócio
Identificação e unicidade
A Sigla é única entre os tipos de ação. Se já existir outro tipo de ação com a mesma sigla, a gravação é recusada. Na edição, o próprio registro é ignorado na verificação, de modo que manter a sigla atual não bloqueia a gravação.
Inclusão e alteração na mesma operação
Incluir e alterar usam a mesma operação de gravação. O que distingue os dois casos é o identificador enviado: vazio significa inclusão, preenchido significa alteração.
Na inclusão, Nome, Sigla, Ativo e Aplicativo são gravados exatamente como enviados.
Na alteração, o Nome é sempre substituído pelo valor enviado. Sigla, Ativo e Aplicativo só são substituídos quando vierem preenchidos: se vierem vazios, o valor anterior é preservado. Se o identificador informado não corresponder a nenhum tipo de ação, a alteração é recusada.
Situações Ativo e Aplicativo
As marcações Ativo e Aplicativo da tela são convertidas para 1 quando marcadas e 0 quando desmarcadas antes de serem enviadas ao servidor. São independentes: um tipo de ação pode estar ativo no portal e indisponível no aplicativo, e vice-versa.
A lista de seleção oferecida a outras telas traz somente tipos de ação com situação Ativo igual a 1 — inativos nunca aparecem para escolha, embora continuem visíveis na listagem do próprio cadastro.
Filtro de situação na listagem
A listagem aceita um filtro de situação com os valores 0, para inativos, e 1, para ativos. Valor fora dessa faixa é ignorado e a listagem traz todos os tipos de ação.
Exclusão condicionada ao uso
Um tipo de ação que já tenha sido usado em algum registro de ação corretiva não pode ser excluído, e nada é removido nesse caso. Se o identificador informado não corresponder a nenhum tipo de ação, a exclusão não remove nada e também não acusa erro.
Histórico automático
Toda gravação e toda exclusão de tipo de ação geram automaticamente um registro de auditoria com o usuário responsável. O histórico não depende de nenhuma ação do operador e não pode ser desligado pela tela.
Troubleshooting
A opção Tipos de Ações não aparece no menu Cadastros
Cenário: o usuário acessa Cadastros e não encontra a opção.
Mensagem exibida: Nenhuma — a opção simplesmente não é listada.
O que fazer: verificar se o perfil do usuário tem a permissão de visualizar tipo de ação. Este cadastro não depende de módulo contratado, então a causa é sempre permissão.
Não é possível gravar: sigla já utilizada
Cenário: o usuário informa uma sigla que já pertence a outro tipo de ação.
Mensagem exibida: “Já existe um tipo de ação com a sigla {sigla}”
O que fazer: escolher outra sigla. Como a sigla aceita no máximo 2 caracteres, o esgotamento de combinações é comum em bases grandes — conferir na listagem quais siglas já estão em uso, inclusive as de tipos inativos, que continuam ocupando a sigla.
Não é possível gravar: nome em branco
Cenário: a gravação chega ao servidor sem o nome preenchido.
Mensagem exibida: “É necessário informar o campo descricao”
O que fazer: preencher o campo Nome. Pela tela isso não deveria acontecer, porque o campo é obrigatório no formulário; se ocorrer, a gravação veio de fora do portal.
Não é possível excluir: tipo de ação em uso
Cenário: o usuário tenta remover um tipo de ação que já foi aplicado a registros de ação corretiva.
Mensagem exibida: “Tipo de ação aplicada aos registros. Não pode ser Apagada!”
O que fazer: desmarcar a situação Ativo em vez de excluir. O tipo de ação deixa de aparecer nas listas de seleção e o histórico dos registros existentes é preservado.
A exclusão informa sucesso mas o registro continua na lista
Cenário: o identificador enviado não corresponde a nenhum tipo de ação — por exemplo, o registro já havia sido removido por outro usuário.
Mensagem exibida: “Operação efetuada com sucesso.”
O que fazer: recarregar a listagem. O servidor não acusa erro quando o registro não existe, então a mensagem de sucesso não garante que algo foi removido nesta operação.
Erro genérico ao salvar uma edição
Cenário: o usuário edita um tipo de ação que foi removido por outro usuário enquanto o formulário estava aberto.
Mensagem exibida: uma mensagem genérica de falha na gravação, sem indicar que o registro não existe mais.
O que fazer: recarregar a listagem e confirmar se o tipo de ação ainda existe. A mensagem específica de registro inexistente não chega à tela.
O tipo de ação não aparece para escolha em outra tela
Cenário: o tipo de ação existe na listagem do cadastro, mas não é oferecido nas telas que registram ação corretiva.
Mensagem exibida: Nenhuma — a opção apenas não consta da lista.
O que fazer: verificar a marcação Ativo. As listas de seleção trazem somente tipos de ação ativos.
O tipo de ação não aparece no aplicativo
Cenário: o tipo de ação está ativo no portal, mas não é oferecido no aplicativo.
Mensagem exibida: Nenhuma.
O que fazer: verificar a marcação Aplicativo, que é independente da marcação Ativo. Um tipo de ação pode estar ativo no portal e indisponível no aplicativo.
Casos de Uso
Caso 1 — Cadastro de um tipo de ação novo
A equipe da qualidade precisa classificar as ações de “Treinamento”. O usuário abre Cadastros, Tipos de Ações, aciona o botão de novo registro, informa “Treinamento” no Nome e “TR” na Sigla, deixa Ativo e Aplicativo marcados e grava. O sistema confirma a gravação e retorna à listagem, onde o novo tipo já aparece no topo, por ser o registro mais recente.
Caso 2 — Desativação em vez de exclusão
Um tipo de ação deixou de ser usado, mas já foi aplicado a registros antigos. O usuário tenta excluí-lo e recebe a recusa por já estar aplicado aos registros. Em vez de excluir, abre a edição e desmarca Ativo. O tipo de ação continua na listagem do cadastro e no histórico dos registros antigos, mas deixa de ser oferecido nas telas que registram ação corretiva.
Caso 3 — Tipo de ação restrito ao portal
O monitor precisa lançar uma determinada ação, mas não aparece no aplicativo. O usuário cadastra o tipo de ação com Ativo marcado e Aplicativo desmarcado. A opção passa a constar nas telas do portal e permanece ausente no aplicativo. Revisar a definição dos parâmetros caso necessário.
Caso 4 — Correção de sigla de um cadastro existente
Um tipo de ação foi cadastrado com uma sigla e a equipe decide padronizá-la com outra sigla. O usuário abre a edição, altera a sigla e grava. A verificação de unicidade ignora o próprio registro, então gravar mantendo a sigla atual também funciona; a recusa só ocorre se a nova sigla definida já pertencer a outro tipo de ação.