Programa de Qualidade
Criado por Flávio Parma em 10 de setembro de 2026
Atualizado por Flávio Parma em 10 de setembro de 2026
Programa de Qualidade
Gestão de programas de qualidade e configuração de envio automático de relatórios no Portal EasyPAC
Visão Geral do Programa de Qualidade
A tela de Programa de Qualidade fica no menu Cadastros do Portal EasyPAC e serve para criar e manter os programas usados para agrupar as planilhas da gestão da qualidade. Um programa de qualidade funciona como uma espécie de “pasta” ou categoria à qual várias planilhas podem ser vinculadas.
Além do cadastro básico (código, descrição e situação), essa tela permite configurar o envio automático de um relatório sempre que uma planilha vinculada a esse programa tiver sua assinatura fechada. Essa configuração de envio é feita em uma janela própria (modal), onde o usuário escolhe para onde o relatório deve ser enviado: por e-mail, para uma pasta do Google Drive ou para um container do Azure Blob Storage.
Informação importante
Esta tela não gera nem envia o relatório. Ela apenas guarda as informações do programa e as regras de para onde o relatório deve ir. A geração e o envio do relatório em si acontecem em outro momento do sistema, quando a planilha vinculada a este programa é efetivamente fechada.
Vídeo Tutorial do Programa de Qualidade
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso do Programa de Qualidade
Dependências e Cadastros
Não é necessário ter nenhum outro cadastro pronto antes de criar um Programa de Qualidade: ele é um cadastro-base e pode ser criado de forma isolada, sem depender de nenhuma outra tela.
As planilhas que aparecem contadas na coluna de quantidade de planilhas da listagem são cadastradas em telas próprias, fora deste acervo de documentação; portanto, o vínculo entre planilha e programa de qualidade é feito a partir da tela da planilha, não a partir desta tela.
Requisitos para Envio Automático de Relatório
Para habilitar o envio automático de relatório, cada tipo de destino escolhido no modal de configuração tem uma exigência própria, verificada apenas no momento em que o usuário tenta adicionar aquele destino:
- E-mail: não exige nenhuma configuração externa prévia; basta informar ao menos um endereço de e-mail.
- Google Drive: exige que a conexão com o Google já tenha sido feita dentro desta própria tela (enviando o arquivo de credenciais no formato .json) antes de informar o ID da pasta de destino. Sem essa conexão concluída, o destino não é aceito.
- Azure Blob Storage: exige que o usuário já tenha em mãos a URL do container do Azure para informá-la no campo correspondente. Sem essa URL, o destino não é aceito.
Perfil de Acesso e Permissões
Quanto ao perfil de acesso, cada ação dentro da tela exige uma permissão específica atribuída ao usuário:
- Ver a listagem de programas de qualidade exige a permissão de visualizar programa de qualidade.
- Abrir o formulário de cadastro novo e salvar um programa novo exigem a permissão de cadastrar programa de qualidade.
- Abrir o formulário de edição, consultar os dados de um programa específico e salvar uma edição exigem a permissão de editar programa de qualidade.
- Excluir um programa exige a permissão de excluir programa de qualidade.
Já a lista de seleção de programas de qualidade usada por outras telas para vincular um programa, além de salvar ou desativar a configuração de envio automático de relatório e realizar a conexão com o Google Drive, não exigem nenhuma permissão específica além de o usuário estar autenticado no Portal. Na prática, isso significa que qualquer usuário logado pode alterar a configuração de envio de um programa, mesmo que não tenha a permissão de editar programa de qualidade.
Perfil Fiscal
O perfil fiscal não tem acesso a esta tela: nenhuma das ações acima fica disponível para esse perfil.
Módulo e Empresa
Não há dependência de nenhum módulo contratado específico para acessar esta tela: ela faz parte do cadastro padrão do módulo Cadastros.
Atenção: Sem Separação por Empresa
Diferente de outras listagens do sistema, a listagem de Programa de Qualidade não separa os registros por empresa. Ou seja, se o usuário tiver acesso a mais de uma empresa, verá todos os programas de qualidade cadastrados juntos na mesma lista, sem distinção de empresa.
Processo de Criação: Passo a Passo do Programa de Qualidade
Acessar a tela de Programa de Qualidade
O usuário acessa o menu Cadastros do Portal e seleciona a opção Programa de Qualidade. A tela abre exibindo a listagem dos programas já cadastrados.
Abrir o formulário de novo cadastro
O usuário clica no botão Novo. O sistema abre o formulário de cadastro em branco, sem nenhum Id associado. Nesse momento, o campo Status ainda não aparece com nenhuma opção pré-selecionada visualmente, mas o sistema assume o padrão Ativo caso o usuário não altere nada.
Preencher o campo Código
O usuário digita o Código do programa, um texto de até 40 caracteres, de preenchimento obrigatório.
Preencher o campo Descrição
O usuário digita a Descrição do programa, um texto de até 150 caracteres. Esse preenchimento é opcional.
Selecionar o Status
O usuário confirma ou altera a opção de Status entre Ativo e Inativo. Esse campo é obrigatório.
Salvar o cadastro
O usuário clica no botão de salvar. Antes de enviar os dados, o sistema confere no próprio navegador se os campos obrigatórios (Código e Status) foram preenchidos corretamente. Em seguida, o sistema verifica se o Código informado já está em uso por outro programa; se não estiver, grava o novo programa e exibe a mensagem “Operação efetuada com sucesso.”. A tela retorna para a listagem.
Reabrir o programa recém-criado
Como a configuração de envio de relatório só pode ser feita depois que o programa já existe, o usuário precisa reabrir o programa recém-salvo (pela listagem, usando Editar ou duplo clique). Ao reabrir, o botão Configuração de Envio de Relatório passa a aparecer no cabeçalho do formulário, o que não acontecia durante o cadastro novo.
Abrir o modal de Configuração de Envio
O usuário clica no botão Configuração de Envio de Relatório. O sistema abre uma janela própria (modal) mostrando o interruptor Habilitar Envio Automático e, se já houver uma configuração salva anteriormente, os destinos já cadastrados.
Habilitar e escolher Tipo de Destino
O usuário marca o interruptor Habilitar Envio Automático, o que faz o sistema exibir o painel de parâmetros de destino. Em seguida, o usuário escolhe o Tipo de Destino entre E-mail, Google Drive e Azure Blob Storage. Somente os campos correspondentes ao tipo escolhido ficam visíveis.
Preencher dados do destino
Se E-mail, o usuário informa ao menos um endereço de e-mail na lista de destinatários. Se Google Drive, o usuário garante que a conexão com o Google já foi feita e informa o ID da pasta de destino. Se Azure Blob Storage, o usuário informa a URL do container de destino.
Salvar a configuração
O usuário confirma a gravação da configuração. O sistema valida os destinos informados conforme o tipo escolhido e, se estiverem corretos, grava a configuração como habilitada, exibindo a mensagem “Configuração salva com sucesso.”. Se o usuário desativar o envio automático, o sistema apaga o destino gravado anteriormente.
Fechar o modal
Se o usuário fechar o modal sem salvar, a configuração exibida na tela volta para o último estado que havia sido salvo quando o modal foi aberto. Se o modal nunca chegou a carregar uma configuração salva anteriormente, a lista de destinos volta vazia.
Descrição de Cada Campo da Tela do Programa de Qualidade
Código
Tipo
Texto
Obrigatoriedade
Obrigatório
Descrição: Identifica de forma única o programa de qualidade dentro do sistema; é o valor usado para diferenciar um programa do outro.
Comportamento: Aceita até 40 caracteres. O sistema confere se o Código já está em uso por outro programa antes de salvar; se estiver, a gravação é rejeitada. Na edição, o próprio Código do registro que está sendo editado é aceito normalmente.
Impacto: Aparece na listagem de programas de qualidade e na mensagem de confirmação exibida antes de uma exclusão.
Descrição
Tipo
Texto
Obrigatoriedade
Opcional
Descrição: Um texto livre que detalha ou complementa o significado do programa de qualidade, ajudando a identificá-lo além do Código.
Comportamento: Aceita até 150 caracteres. Não há validação de duplicidade para este campo.
Impacto: Aparece na listagem de programas de qualidade e é usado como critério de busca por texto na pesquisa livre da listagem.
Status
Tipo
Seleção única
Obrigatoriedade
Obrigatório
Descrição: Indica se o programa de qualidade está ativo (em uso) ou inativo (fora de uso).
Comportamento: Apresenta as opções Ativo e Inativo. No cadastro de um programa novo, nenhuma opção aparece pré-marcada visualmente, mas o sistema assume Ativo como padrão se o usuário não alterar nada. Na edição, o valor atual do programa vem pré-selecionado. Internamente, o sistema reconhece o valor 1 como Ativo; qualquer outro valor gravado é tratado como Inativo.
Impacto: Determina o texto Ativo ou Inativo exibido na coluna Status da listagem.
Configuração de Envio de Relatório
Tipo
Botão de ação
Obrigatoriedade
Não aplicável
Descrição: Abre a janela (modal) onde o usuário define se o envio automático de relatório fica habilitado e para quais destinos ele deve ocorrer.
Comportamento: Só aparece no cabeçalho do formulário quando o programa já foi salvo pelo menos uma vez. No cadastro de um programa novo (ainda não salvo), este botão não é exibido.
Impacto: Dá acesso aos campos de configuração de envio descritos a seguir, que ficam gravados junto ao programa de qualidade.
Habilitar Envio Automático
Tipo
Interruptor (checkbox/toggle)
Obrigatoriedade
Obrigatório
Descrição: Define se o sistema deve, no futuro, enviar automaticamente um relatório sempre que uma planilha vinculada a este programa tiver sua assinatura fechada.
Comportamento: Quando marcado, o sistema exibe o painel de parâmetros de destino (Tipo de Destino e campos relacionados). Quando desmarcado, esse painel fica oculto e, ao salvar, o sistema apaga o destino gravado anteriormente e marca a configuração como desabilitada.
Impacto: Define se o processo de fechamento de assinatura de planilha, que ocorre em outra tela, vai ou não disparar o envio automático do relatório para este programa.
Tipo de Destino
Tipo
Seleção única
Obrigatoriedade
Obrigatório*
* Quando o envio automático está habilitado
Descrição: Define para onde o relatório deve ser enviado quando gerado: E-mail, Google Drive ou Azure Blob Storage.
Comportamento: Ao trocar a opção selecionada, o sistema exibe apenas os campos correspondentes àquele tipo de destino, ocultando os campos dos demais tipos. Internamente, o sistema reconhece três valores para este campo: 1 para E-mail, 2 para Google Drive e 3 para Azure Blob Storage; qualquer outro valor é rejeitado no momento de salvar, com a mensagem “Tipo de configuração desconhecido”.
Impacto: Determina qual conjunto de dados (endereços de e-mail, pasta do Google Drive ou container do Azure) será usado no momento do envio automático do relatório.
Endereços de e-mail (Destino E-mail)
Tipo
Lista de textos (adição de itens)
Obrigatoriedade
Obrigatório*
* Ao menos um endereço, quando o Tipo de Destino é E-mail
Descrição: Define para quais endereços de e-mail o relatório deve ser enviado quando o Tipo de Destino é E-mail.
Comportamento: O sistema exige ao menos um endereço cadastrado na lista. Cada endereço é comparado com os já adicionados sem diferenciar maiúsculas de minúsculas, e não pode haver repetição; ao tentar adicionar um endereço já presente, o sistema exibe a mensagem inline “Os seguintes e-mails já foram adicionados”. Antes de comparar e de enviar, cada endereço é ajustado automaticamente para letras minúsculas e sem espaços nas pontas.
Impacto: São os endereços que efetivamente recebem o relatório gerado no momento do fechamento de assinatura da planilha vinculada a este programa.
Conexão com o Google Drive
Tipo
Upload de arquivo
Obrigatoriedade
Obrigatório*
* Antes de adicionar destino Google Drive
Descrição: Autoriza o sistema a acessar a conta do Google Drive do usuário, permitindo o envio futuro do relatório para uma pasta específica.
Comportamento: O usuário seleciona um arquivo de credenciais no formato .json; o seletor de arquivos só aceita esse formato, mas o sistema não verifica o tamanho do arquivo no navegador antes do envio. Com o arquivo enviado, o sistema monta e conduz a autorização (OAuth) com o Google usando essas credenciais e o Id do programa de qualidade. Se a autorização falhar por um problema relacionado ao próprio Google, o sistema devolve essa informação normalmente para a tela tratar; qualquer outra falha aparece como um erro genérico do servidor.
Impacto: Sem essa conexão concluída, o destino Google Drive não pode ser adicionado à configuração de envio deste programa de qualidade.
ID da Pasta (Destino Google Drive)
Tipo
Texto
Obrigatoriedade
Obrigatório*
* Quando o Tipo de Destino é Google Drive
Descrição: Identifica a pasta específica dentro do Google Drive do usuário para onde o relatório deve ser enviado.
Comportamento: Só pode ser informado e aceito depois que a conexão OAuth com o Google já foi concluída nesta mesma tela; sem essa conexão, o destino Google Drive não é aceito mesmo que o ID da pasta tenha sido preenchido.
Impacto: Define exatamente qual pasta do Google Drive receberá o relatório no momento do envio automático.
URL do Container (Destino Azure Blob Storage)
Tipo
Texto
Obrigatoriedade
Obrigatório*
* Quando o Tipo de Destino é Azure Blob Storage
Descrição: Informa o endereço do container de armazenamento do Azure para onde o relatório deve ser enviado.
Comportamento: O sistema exige que essa URL esteja preenchida, seja um endereço absoluto e válido para aceitar o destino; sem ela, o destino Azure Blob Storage não é adicionado.
Impacto: Define o container do Azure que receberá o relatório no momento do envio automático.
Utilização e Consulta de Registros do Programa de Qualidade
Busca e Pesquisa
Na listagem, o usuário localiza programas de qualidade já cadastrados usando o campo de pesquisa livre. Essa pesquisa é comparada contra o Id (quando o texto digitado é somente números), a Descrição ou o Código do programa (quando o texto contém outros caracteres). A busca só é enviada ao servidor a partir de 3 caracteres digitados, ao apertar a tecla Enter, ou ao limpar o campo de pesquisa; além disso, o sistema aguarda 500 milissegundos após o usuário parar de digitar antes de buscar, para não disparar uma consulta a cada tecla pressionada.
Organização e Paginação
A grade de resultados é organizada e paginada pelo próprio servidor, exibindo 20 registros por página. A ordenação inicial é pelo Id em ordem decrescente (do mais recente para o mais antigo), mas o usuário pode clicar nas colunas Id, Código ou Descrição para reordenar a lista por elas. A coluna de quantidade de planilhas (que mostra quantas planilhas ativas estão vinculadas a cada programa) não pode ser usada como critério de ordenação nem de pesquisa.
Status e Exibição
A coluna Status é calculada automaticamente pela tela a partir do campo de situação do programa: exibe Ativo quando o valor gravado é 1, e Inativo em qualquer outro caso.
Informação Importante: Sem Separação por Empresa
A listagem de Programa de Qualidade não separa os registros por empresa. Diferente de outras telas do sistema, todos os programas de qualidade cadastrados aparecem juntos na mesma lista, independentemente da empresa a que pertencem.
Processo de Edição do Programa de Qualidade
A rotina permite editar um programa de qualidade já cadastrado. O usuário abre a edição pelo botão Editar ou por duplo clique na linha desejada na listagem; essa ação exige que o usuário tenha a permissão de editar programa de qualidade, a mesma permissão necessária apenas para consultar os dados de um programa específico.
Ao abrir a edição, a tela carrega o Código, a Descrição, o Status e a configuração de envio de relatório já salvos para aquele programa, e marca o Status atual como selecionado.
Campos Modificáveis
Todos os três campos principais podem ser alterados na edição: Código, Descrição e Status. O Código continua sendo validado contra duplicidade ao salvar, porém o próprio Código do registro em edição é aceito normalmente. Não há campo bloqueado especificamente para edição entre esses três.
Configuração de Envio de Relatório
Diferente do cadastro novo, na edição o botão Configuração de Envio de Relatório aparece disponível no cabeçalho do formulário, permitindo abrir o modal e alterar, a qualquer momento, se o envio automático está habilitado e para quais destinos ele deve ocorrer. Essa configuração de envio é gravada e desativada por uma operação própria, separada da gravação do Código, da Descrição e do Status: quando o usuário clica em salvar no formulário principal, apenas Código, Descrição e Status são enviados ao servidor; a configuração de envio só é alterada quando o usuário confirma a gravação dentro do próprio modal.
Comportamento em Caso de Exclusão
Se, entre a abertura da tela de edição e o clique em salvar, o registro tiver sido excluído por outro usuário, o sistema não grava a alteração e exibe a mensagem “Programa de Qualidade não encontrado.”.
Histórico e Auditoria
Não há, na documentação de origem, menção a um histórico ou log de alterações visível ao usuário para os campos do programa de qualidade. A exclusão do programa, por sua vez, é registrada com o identificador do usuário autenticado que a realizou e o instante em que ela ocorreu, embora não haja, na documentação de origem, indicação de uma tela onde o usuário final possa consultar esse registro de exclusão.
Estrutura Técnica e Comportamento do Sistema do Programa de Qualidade
Geração e Envio de Relatórios
Esta tela não gera nem envia relatório por conta própria. Ela apenas guarda as configurações que serão usadas por outro processo do sistema: o fechamento de assinatura de uma planilha da gestão da qualidade vinculada a este programa. Quando esse fechamento acontece e o envio automático está habilitado para o programa, o sistema gera o relatório e o envia de forma automática (em segundo plano, sem que o usuário precise fazer nada naquele momento) para os destinos configurados aqui: e-mail, Google Drive ou Azure Blob Storage.
Integração com Google Drive (OAuth)
A conexão com o Google Drive depende de uma autorização do próprio Google (processo conhecido como OAuth): o sistema monta um link de autorização usando o arquivo de credenciais enviado pelo usuário e o identificador do programa de qualidade. Se essa autorização falhar por um problema do lado do Google, o sistema mostra essa informação de forma diferenciada, para que a tela consiga explicar melhor o que aconteceu; qualquer outro tipo de falha aparece como um erro geral do sistema.
Carregamento da Listagem
Ao carregar a listagem, o sistema busca no banco de dados os programas que atendem à página, à busca e à ordenação solicitadas, e calcula, para cada programa, quantas planilhas ativas estão vinculadas a ele, exibindo esse total na coluna de quantidade de planilhas. Planilhas inativas não entram nessa contagem.
Bloqueio de Exclusão
Ao excluir um programa, o sistema verifica antes se ainda existe algum vínculo (por exemplo, planilhas relacionadas) que impeça a exclusão; se houver, a exclusão é bloqueada.
Regras de Negócio e Restrições do Programa de Qualidade
Valor Padrão e Reconhecimento do Status
O campo Status reconhece o valor 1 como Ativo; qualquer outro valor gravado é tratado como Inativo. Quando o usuário não altera nada no cadastro novo, o sistema assume Ativo como padrão.
Tipos de Destino Reconhecidos
O Tipo de Destino de envio de relatório reconhece apenas três valores: 1 para E-mail, 2 para Google Drive e 3 para Azure Blob Storage. Um valor fora dessa faixa é rejeitado no momento de salvar a configuração, com a mensagem “Tipo de configuração desconhecido”.
Paginação e Ordenação
A listagem exibe 20 registros por página, ordenados inicialmente pelo Id em ordem decrescente. A ordenação por coluna reconhece apenas Id, Código e Descrição; qualquer outra coluna clicada não altera a ordem apresentada. A coluna de quantidade de planilhas não pode ser usada para ordenar nem para pesquisar.
Ausência de Filtro por Empresa
A listagem de Programa de Qualidade não aplica filtro por empresa: programas de qualidade de todas as empresas aparecem juntos na mesma lista, sem isolamento multiempresa. Isso é diferente do comportamento padrão de outras listagens do sistema.
Tamanho e Obrigatoriedade dos Campos
O Código é obrigatório e aceita até 40 caracteres. A Descrição é opcional e aceita até 150 caracteres. O Status é obrigatório.
Bloqueio de Código Duplicado
Um Código já usado por outro programa é rejeitado tanto no cadastro de um programa novo quanto na edição de um programa existente, exceto quando o Código pertence ao próprio registro que está sendo editado, o que é permitido normalmente.
Bloqueio de Exclusão por Vínculo
A exclusão de um programa de qualidade é bloqueada quando ele está em uso em outros cadastros (por exemplo, planilhas vinculadas a ele) ou quando o registro que o usuário está tentando excluir já não existe mais no sistema.
Contagem de Planilhas Ativas
A quantidade de planilhas exibida na listagem conta somente as planilhas ativas vinculadas ao programa de qualidade. Planilhas inativas não entram nessa contagem.
Validação de Destinos por Tipo
Um destino de e-mail exige ao menos um endereço cadastrado na lista, com os endereços comparados sem diferenciar maiúsculas de minúsculas e normalizados para letras minúsculas e sem espaços nas pontas antes de comparar e de enviar. Um destino Google Drive exige a pasta informada e a conexão OAuth com o Google já concluída. Um destino Azure Blob Storage exige uma URL de container válida e completa. Um tipo de destino não reconhecido é rejeitado com a mensagem “Tipo de configuração desconhecido”.
Configuração Depende de Existência
A configuração de envio automático de relatório só pode ser criada ou alterada para um programa de qualidade que já tenha sido salvo pelo menos uma vez. Não é possível configurar o envio automático durante o cadastro de um programa novo, antes de ele existir no sistema.
Independência entre Cadastro e Configuração
Ao salvar o cadastro principal do programa (Código, Descrição e Status), a configuração de envio de relatório não é alterada junto: ela é gravada ou desativada apenas por meio de uma ação própria e independente, feita dentro do modal de Configuração de Envio de Relatório.
Registro de Auditoria na Exclusão
Toda exclusão de um programa de qualidade é registrada com o identificador do usuário autenticado que a realizou e o instante exato em que a exclusão ocorreu.
Permissões Independentes por Operação
Cada operação da tela exige uma permissão própria: visualizar exige a permissão de visualizar programa de qualidade; cadastrar exige a permissão de cadastrar programa de qualidade; editar (incluindo consultar um programa específico) exige a permissão de editar programa de qualidade; excluir exige a permissão de excluir programa de qualidade. Já a configuração de envio automático de relatório e a conexão com o Google Drive não exigem nenhuma dessas permissões específicas, bastando o usuário estar autenticado no Portal.
