Não Conformidades
Cadastros – Não Conformidades (Portal Easypac)
A tela de Não Conformidade, no módulo de Cadastros, mantém o catálogo dos tipos de não conformidade que a operação de qualidade usa para classificar ocorrências.
Visão Geral
A tela de Não Conformidade, no módulo de Cadastros, mantém o catálogo dos tipos de não conformidade que a operação de qualidade usa para classificar ocorrências. Cada não conformidade cadastrada aqui define, para quem for registrar uma ocorrência desse tipo, se um plano de ação é obrigatório e se — e como — a seleção de uma ação corretiva, preventiva ou imediata é exigida. Esta tela apenas parametriza essas regras; o registro em campo das ocorrências de não conformidade é feito no APP, fora deste acervo. As não conformidades cadastradas aqui alimentam a listagem e a associação usadas pelas telas de Registros e de Planilhas do Portal.
Pré-requisitos
- Se as configurações globais do cliente “exigir plano de ação padrão” e “exigir seleção de ação por padrão em nova não conformidade e planilhas” estiverem habilitadas os campos correspondentes ficam bloqueados; se as configurações globais estiverem desabilitadas, os campos de parâmetro são exibidos, inicialmente, desabilitados ou com valor “Não” (nenhuma exigência).
- Para vincular ações padrão a uma não conformidade, as ações correspondentes (Imediata, Corretiva ou Preventiva) precisam estar previamente cadastradas — sem ações cadastradas, o lookup “Ações Padrão” não retorna resultados para seleção.
- Uma não conformidade só pode ter a descrição alterada enquanto não estiver associada a nenhum item de planilha; uma vez utilizada em uma planilha, a descrição fica congelada (ver Regras de Negócio).
Permissões e Perfis de Acesso
A listagem de não conformidades só é exibida para usuários com permissão de visualizar não conformidades; sem essa permissão, tanto a tela de listagem quanto a grid retornada pelo servidor ficam indisponíveis. A abertura do formulário de cadastro de uma nova não conformidade exige permissão própria de inclusão; a edição de uma não conformidade existente — tanto a abertura da tela quanto a gravação — exige permissão própria de edição; a exclusão exige permissão própria de exclusão. Essas três permissões são independentes entre si: um usuário pode, por exemplo, visualizar e editar sem poder excluir.
Perfil fiscal: não tem acesso à tela, ou seja, não pode realizar nenhuma das ações citadas anteriormente.
A tela é liberada a todos os clientes conforme as permissões de papel acima, sem depender de um módulo opcional do contrato.
A listagem principal de não conformidades não é filtrada por empresa: o filtro aplicado é apenas pelo texto pesquisado (Id ou Descrição). O lookup do cadastro de itens das Planilhas, exibe todas as não conformidades cadastradas para a base como um todo, independentemente da empresa. Já o lookup de não conformidades usado no filtro da tela de Registros é restrito às não conformidades associadas a registros dentro das Planilhas para os quais o usuário logado tem permissão de consulta.
Fluxo Operacional
A partir do menu Cadastros, o usuário acessa Não Conformidade e chega à listagem paginada. Para incluir, clica em “Novo” e é levado ao formulário de cadastro; para editar, seleciona uma linha e clica em “Editar” (ou dá duplo clique na linha) e é levado ao formulário já preenchido com os dados atuais. Após preencher os campos obrigatórios e salvar, o usuário é redirecionado de volta à listagem, que é recarregada. Para excluir, seleciona uma linha e clica em “Excluir”, confirma a remoção em um diálogo e, em caso de sucesso, a listagem é recarregada automaticamente. A não conformidade também pode ser cadastrada rapidamente, sem sair da tela de origem, por um popup acionado a partir de um campo de lookup em outra tela (Planilhas).
Interface e Comportamentos da Tela
Listagem de não conformidades com paginação no servidor
A grid de não conformidades exibe as colunas Id e Descrição, com paginação e ordenação processadas no servidor. O tamanho de página padrão é de 20 registros, e a ordenação inicial é pela coluna Id em ordem decrescente. Apenas as colunas Id e Descrição são reconhecidas para ordenação; qualquer outro identificador de coluna enviado não altera a ordenação aplicada.
Formulário de cadastro e edição de não conformidade
O campo Descrição é de preenchimento obrigatório, tanto no formulário completo quanto no popup de cadastro rápido. O botão “Cancelar” retorna à listagem sem gravar nada. O envio do formulário só ocorre se a validação nativa do navegador for aprovada; os dados são então enviados ao servidor como JSON.
Campo “Exige Plano Ação” bloqueado por configuração global
Quando a configuração global “exigir plano de ação padrão” está ativa no menu Configurações, o campo “Exige Plano Ação” da não conformidade aparece marcado e fica desabilitado nesta tela — não pode ser desmarcado — com um aviso explicando que o parâmetro está ativo nas configurações globais.
Campo “Exige a seleção de ação” (enumeração e bloqueio por configuração global)
O campo “Exige a seleção de ação” tem três opções, com um texto de ajuda disponível em popup ao lado do campo: “Não” (nenhuma validação de seleção de ação é feita no app), “Pelo menos uma ação” (exige ao menos uma ação selecionada, quando existirem ações cadastradas para a não conformidade) e “Uma ação de cada tipo” (exige uma ação de cada tipo disponível — Imediata, Corretiva e Preventiva —, considerando apenas os tipos configurados para o item). Quando a configuração global equivalente (padrão para novas não conformidades de planilhas) está definida com um valor diferente de “Não”, este campo vem fixado nesse valor e fica desabilitado, com o mesmo aviso de bloqueio por configuração global usado no campo “Exige Plano Ação”.
Lookup “Ações Padrão” na não conformidade
O campo “Ações Padrão” é um lookup de múltipla seleção: a pesquisa busca ações corretivas por texto, e os valores já associados à não conformidade em edição são carregados automaticamente a partir do Id da não conformidade aberta. O campo aceita no máximo 20 ações selecionadas simultaneamente.
Popup de cadastro rápido de não conformidade
Aberto a partir de um campo de lookup em outra tela, o popup exige apenas o preenchimento da Descrição. Ao ser aberto, ele pré-preenche (de forma oculta, sem exibir o campo) o valor de “Exige a seleção de ação” com a configuração global; se a não conformidade for salva com sucesso, ela é atribuída automaticamente ao campo de lookup que originou o popup, e o popup se fecha.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Confirmação antes de excluir uma não conformidade selecionada | Diálogo de confirmação | “Você está prestes a remover a não conformidade: {id} – {descricao}” |
| Exclusão concluída com sucesso | Notificação | “Operação efetuada com sucesso.” |
| Falha ao excluir uma não conformidade | Notificação de erro | Texto literal devolvido pelo servidor (campo de detalhe da resposta, ou o texto bruto da resposta quando esse campo não vier preenchido) |
| Cadastro ou edição salvos com sucesso (formulário completo) | Notificação, com redirecionamento à listagem | “Operação efetuada com sucesso.” |
| Falha ao salvar cadastro ou edição (formulário completo) | Notificação de erro | Texto literal devolvido pelo servidor |
| Cadastro salvo com sucesso no popup rápido | Notificação, popup se fecha | “Operação efetuada com sucesso.” |
| Falha ao salvar no popup de cadastro rápido | Notificação de erro | Texto literal devolvido pelo servidor |
| Campo “Exige Plano Ação” bloqueado por configuração global | Aviso ao lado do campo | “Não é possível alterar este parâmetro pois ele se encontra ativo nas configurações globais.” |
| Campo “Exige a seleção de ação” bloqueado por configuração global | Aviso ao lado do campo | “Não é possível alterar este parâmetro pois ele se encontra ativo nas configurações globais.” |
| Tentativa de selecionar mais de 20 ações padrão | Alerta no navegador, sem chamar o servidor | “Não foi possível concluir a operação. O campo \”Ações Padrão\” permite a seleção de até 20 ações. Quantidade selecionada: {n}. Remova uma ou mais ações e tente novamente.” |
Processamento pelo Backend
Ao gravar uma não conformidade, o servidor recebe o Id enviado pelo Portal e decide entre inserir e editar por esse valor: Id igual a 0 significa inserção; qualquer outro valor significa edição de um registro existente. Tanto o cadastro quanto a edição, no Portal, chamam o mesmo método de serviço e enviam os dados ao mesmo ponto do servidor, que decide internamente qual caminho seguir.
Na inserção, o servidor valida a duplicidade de descrição contra as não conformidades já existentes. Após inserir, o servidor reconsulta o banco filtrando pela mesma descrição para obter o Id gerado, em vez de usar diretamente o Id retornado pela camada de acesso a dados.
Na edição, o servidor busca a não conformidade pelo Id recebido, verifica se ela está associada a algum item de planilha e, em caso positivo, só bloqueia a gravação se a descrição enviada for diferente da descrição atual — os demais campos (exigir plano de ação, exigir seleção de ação, ações padrão) continuam editáveis mesmo quando a não conformidade já está em uso. A edição também valida duplicidade de descrição contra as demais não conformidades cadastradas.
Na exclusão, o servidor verifica primeiro se a não conformidade existe e, em seguida, se ela está associada a algum item de planilha, antes de efetivamente remover o registro.
Na busca da listagem, o servidor decide o filtro pelo conteúdo digitado: se o texto for numérico, filtra por Id igual ao número; caso contrário, filtra por Descrição contendo o texto. No lookup usado pela pesquisa de ações padrão, a mesma lógica se aplica — texto numérico filtra por Id; texto não numérico busca por descrição resumida, descrição completa, pela palavra “produto” ou “processo” conforme o tipo da ação, ou pela sigla do tipo (começando com o texto digitado). Para montar a lista de ações já associadas a uma não conformidade, o servidor lê a lista de identificadores gravada com a não conformidade, converte cada valor válido para número inteiro e retorna apenas as ações corretivas cujo identificador conste dessa lista; valores não numéricos na lista são ignorados silenciosamente.
No lookup de não conformidades usado pelas telas de Registros e Planilhas, o servidor restringe o resultado às não conformidades associadas a registros dentro das Planilhas para os quais o usuário logado tem permissão de consulta, filtra ainda pela empresa e pelo intervalo de datas informado e, quando uma lista de códigos de planilha é informada, restringe o resultado a esses códigos; adicionalmente é possível buscar por Id ou por Descrição. Esse lookup pagina manualmente em memória, conforme início e tamanho enviados, e ordena o resultado pela Descrição.
Regras de Negócio
Ao inserir uma não conformidade, se já existir outra com a mesma descrição — comparação feita após remover espaços das pontas — a inserção é rejeitada. A mesma verificação de duplicidade se aplica à edição, comparando com as demais não conformidades cadastradas.
Uma não conformidade associada a algum item de planilha não pode mais ter a descrição alterada; os demais campos (exigir plano de ação, exigir seleção de ação, ações padrão) continuam editáveis normalmente.
Uma não conformidade não pode ser excluída se já existir algum registro (item de planilha) atribuído a ela.
O campo “Exige a seleção de ação” aceita três valores com o seguinte significado de negócio: “Não” — nenhuma validação de seleção de ação é exigida no app; “Pelo menos uma ação” — exige ao menos uma ação selecionada, desde que existam ações cadastradas para a não conformidade; “Uma ação de cada tipo” — exige uma ação de cada tipo disponível (Imediata, Corretiva e Preventiva), considerando somente os tipos configurados para o item.
Quando a configuração global “exigir plano de ação padrão” está ativa para o cliente, toda não conformidade cadastrada ou editada nesta tela tem o campo “Exige Plano Ação” fixado como verdadeiro, sem possibilidade de alteração pelo usuário. Quando a configuração global equivalente para “exigir seleção de ação” está definida com valor diferente de “Não”, toda não conformidade tem o campo “Exige a seleção de ação” fixado nesse mesmo valor, também sem possibilidade de alteração pelo usuário.
O campo “Ações Padrão” aceita no máximo 20 ações selecionadas por não conformidade; essa validação ocorre no navegador, antes de qualquer chamada ao servidor.
Antes de enviar o formulário ao servidor, o Portal converte o campo “Exige Plano Ação” de caixa de marcação para verdadeiro ou falso, converte “Exige a seleção de ação” para número inteiro (assumindo 0, equivalente a “Não”, quando vazio) e converte as ações padrão selecionadas em uma lista de identificadores separada por vírgula.
Na listagem de ações do lookup “Ações Padrão”, a sigla do tipo de ação só é exibida se o tipo de ação correspondente estiver ativo; caso contrário, a sigla vem em branco.
Troubleshooting
Não é possível salvar a não conformidade: descrição já cadastrada
Cenário: o usuário tenta cadastrar ou editar uma não conformidade com uma descrição igual à de outra já existente (após remover espaços das pontas).
Mensagem exibida: “400 >> Já existe uma não conformidade com a descrição \”{descrição}\”.”
O que fazer: usar uma descrição diferente ou localizar e reaproveitar a não conformidade já cadastrada com essa descrição.
Não é possível alterar a descrição de uma não conformidade já utilizada em planilha
Cenário: o usuário edita uma não conformidade que já está associada a algum item de planilha e tenta gravar uma descrição diferente da atual.
Mensagem exibida: “Não foi possivel alterar a não conformidade pois já se encontra atribuida”
O que fazer: manter a descrição original; os demais campos (exigir plano de ação, exigir seleção de ação, ações padrão) podem ser alterados normalmente. Para mudar a descrição, é necessário cadastrar uma nova não conformidade.
Não é possível excluir a não conformidade: já existem registros atribuídos
Mensagem exibida: “500 >> Não é possível excluir esta não conformidade, pois já existem registros atribuídos para ela.”
O que fazer: informar ao responsável que a não conformidade está em uso em planilhas e não pode ser removida; se necessário, apenas desativar o uso futuro (ex.: não selecioná-la como ação padrão) em vez de excluir.
Erro ao excluir uma não conformidade que não existe mais
Cenário: o usuário tenta excluir uma não conformidade cujo Id não é encontrado no momento da exclusão (por exemplo, já removida por outro usuário).
Mensagem exibida: “401 >> Não confomidade não encontrado.”
O que fazer: atualizar a listagem e confirmar se o registro ainda existe antes de tentar novamente.
Alerta ao selecionar mais de 20 ações padrão
Mensagem exibida: “Não foi possível concluir a operação. O campo \”Ações Padrão\” permite a seleção de até 20 ações. Quantidade selecionada: {n}. Remova uma ou mais ações e tente novamente.”
O que fazer: remover ações da seleção até restarem no máximo 20 e salvar novamente.
Campo “Exige Plano Ação” aparece marcado e não pode ser desmarcado
Cenário: o cliente tem a configuração global “exigir plano de ação padrão” ativa.
Mensagem exibida: “Não é possível alterar este parâmetro pois ele se encontra ativo nas configurações globais.”
O que fazer: explicar que o comportamento é esperado; para liberar o campo, a configuração global precisa ser desativada por quem administra as configurações do cliente.
Campo “Exige a seleção de ação” vem fixado e não pode ser alterado
Cenário: o cliente tem a configuração global de exigência de seleção de ação (padrão para novas não conformidades de planilhas) definida com um valor diferente de “Não”.
Mensagem exibida: “Não é possível alterar este parâmetro pois ele se encontra ativo nas configurações globais.”
O que fazer: mesmo tratamento do campo “Exige Plano Ação” — o valor só muda por não conformidade se a configuração global for ajustada.
Opção de Não Conformidade não aparece no menu ou não abre
Cenário: o usuário não enxerga a listagem de não conformidades, ou a tela abre em branco.
Mensagem exibida: Nenhuma — o item de menu simplesmente não é exibido, ou a listagem retorna vazia.
O que fazer: confirmar se o usuário tem a permissão de visualizar não conformidades; sem ela, tanto o menu quanto os dados da grid ficam indisponíveis.
Botão “Novo” não aparece ou o cadastro não é permitido
Mensagem exibida: Nenhuma — o botão de inclusão fica indisponível ou a tela de cadastro não abre.
O que fazer: confirmar se o usuário tem a permissão específica de inclusão de não conformidades.
Botão “Editar” não aparece ou a edição não é permitida
Mensagem exibida: Nenhuma — o botão de edição fica indisponível ou a tela de edição não abre, mesmo com uma linha selecionada.
O que fazer: confirmar se o usuário tem a permissão específica de edição de não conformidades.
Botão “Excluir” não aparece ou a exclusão não é permitida
Mensagem exibida: Nenhuma — o botão de exclusão fica indisponível.
O que fazer: confirmar se o usuário tem a permissão específica de exclusão de não conformidades.
Casos de Uso
Caso 1 — Cadastro de não conformidade com plano de ação obrigatório
Um usuário com permissão de inclusão cadastra a não conformidade “Produto fora da temperatura ideal”, vinculando duas ações padrão de tipo Corretiva. Como o cliente tem a configuração global “exigir plano de ação padrão” ativa, o campo “Exige Plano Ação” já vem marcado e desabilitado. O usuário salva e recebe “Operação efetuada com sucesso.”, sendo redirecionado à listagem, que agora mostra a não conformidade recém-criada.
Caso 2 — Tentativa de alterar a descrição de uma não conformidade já usada em planilha
Um usuário edita a não conformidade “Embalagem danificada”, já associada a registros de planilha, e tenta mudar a descrição para “Embalagem violada”. Ao salvar, o sistema rejeita a alteração com “Não foi possivel alterar a não conformidade pois já se encontra atribuida”. O usuário desfaz a mudança de descrição, ajusta apenas o campo “Exige a seleção de ação” para “Pelo menos uma ação” e salva com sucesso.
Caso 3 — Cadastro rápido de não conformidade a partir da tela de Planilhas
Durante o cadastro de itens da planilha, o usuário não encontra a não conformidade desejada no lookup e abre o popup de cadastro rápido, informando apenas a descrição “Ausência de identificação do lote”. Ao confirmar, a não conformidade é criada, atribuída automaticamente ao campo de lookup de origem, e o popup se fecha — sem que o usuário precise sair da tela de Planilhas.
Caso 4 — Exclusão bloqueada por não conformidade em uso
Um usuário com permissão de exclusão tenta remover a não conformidade, mas ela já está associada a itens de planilha. O sistema exibe “500 >> Não é possível excluir esta não conformidade, pois já existem registros atribuídos para ela.” e a exclusão não é realizada; a não conformidade permanece na listagem.