Listagem de Documentos em Criação

A listagem de Documentos em Criação exibe, por linha: checkbox de seleção, Título, Número Completo, Tipo de Documento, Processo, Versão, Criador, Data de Criação (formato DD/MM/AAAA HH:mm), Status (selo colorido com a descrição do status) e uma coluna de Ações com os ícones Histórico e Exibir Documento. A grid pagina e ordena no servidor; o tamanho de página padrão é 30 registros; a ordenação inicial é pela coluna Data de Criação, decrescente; as colunas de seleção e de ações não são ordenáveis nem pesquisáveis. A busca textual da grid só dispara ao digitar pelo menos 3 caracteres, ou ao apertar Enter (que dispensa o mínimo), e considera Título, Criador, Processo e Tipo de Documento, sem diferenciar maiúsculas de minúsculas. O checkbox do cabeçalho seleciona ou deseleciona todas as linhas visíveis; a cada paginação ou recarga da grid, o checkbox de cabeçalho volta a ficar desmarcado.

Painel de filtros da listagem de Documentos em Criação

O painel de filtros permite filtrar por Tipo de Documento (múltipla seleção via busca), Processo (múltipla seleção via busca), Setor (múltipla seleção via busca, trazendo todos os setores) e por intervalo de Data Inicial/Data Final. O painel inicia recolhido. Os filtros aplicados ficam em cache por sessão do navegador, específico desta tela, e são restaurados automaticamente ao reabri-la — inclusive ao retornar da tela de formulário pelo botão Cancelar.

Ações em lote na listagem de Documentos em Criação (enviar para revisão, aprovação, arquivar)

Os botões “Enviar para Revisão” e “Enviar para Aprovação” exigem ao menos um documento selecionado e que todos os documentos selecionados possuam arquivo anexado. O botão “Arquivar” exige apenas documento selecionado e, antes de prosseguir, pede confirmação num diálogo com título “Confirmar Arquivamento”; se o usuário cancelar, nada acontece. As três ações abrem um modal comum pedindo uma Observação, sempre obrigatória, com texto e cor de botão diferentes por ação (“Enviar” azul para Revisão, “Enviar” verde para Aprovação, “Arquivar” vermelho para Arquivamento). Ao confirmar, a grid é recarregada em caso de sucesso.

Navegação para novo documento e edição na tela de Documentos em Criação

O botão “Novo” navega para o formulário de novo documento. Duplo clique numa linha da grid, ou o botão “Editar” (exige uma linha selecionada), navegam para a edição do documento.

Modal de histórico do documento em criação

O ícone de Histórico abre um modal listando a linha do tempo de mudanças de status do documento: data/hora, selo de status, usuário responsável e observação quando houver. Mostra um indicador de carregamento enquanto busca os dados.

Modal de visualização do arquivo em conferência — Documentos em Criação

O modal exibe cabeçalho com Título e “Versão {versão} • {processo}”, um selo indicando o modo de exibição (Cópia Controlada, Cópia Não Controlada ou Visualização para conferência) e rodapé com Tipo, Data de Publicação, Próxima Revisão e Observação. Ao fechar o modal, a URL temporária do arquivo é liberada da memória do navegador.

Formulário de Documentos em Criação — aba Dados

A aba “Dados” reúne título, tipo de documento, processo, setor, número completo, versão, data de cadastro (somente leitura quando o documento não é novo), data de versão atual, data de revisão e upload do arquivo. Ao abrir o formulário de novo documento, o combo de Tipo de Documento é preenchido apenas com os tipos que o usuário logado está autorizado a criar. Ao abrir a edição, os dados atuais do documento e a mesma lista de tipos permitidos são carregados antes de exibir a tela, e o campo Processo é pré-preenchido reaproveitando o processo já vinculado ao documento (vazio se não houver vínculo).

Campo Setor com obrigatoriedade condicional no formulário de Documentos em Criação

O campo Setor exibe um asterisco de obrigatoriedade condicional apenas quando a máscara de numeração do tipo selecionado usa o placeholder de setor E o Número Completo exibido em tela ainda é exatamente igual ao valor gerado automaticamente (não editado manualmente). Se o usuário alterar o número manualmente, a obrigatoriedade visual desaparece. Ao selecionar um Setor, o sistema consulta a sigla desse setor no servidor antes de recalcular o Número Completo automático.

Geração automática do Número Completo no formulário de Documentos em Criação

Para documento novo, ao selecionar ou alterar o Tipo de Documento (ou o Setor, quando a máscara usa setor), o Número Completo é gerado automaticamente substituindo, na máscara de numeração do tipo, os placeholders `{SEQ}` (pela próxima sequência do tipo), `{TIPO}` (pela sigla do tipo), `{SETOR}` (pela sigla do setor selecionado), `{ANO}` (pelo ano atual) e `{ANO2}` (pelos dois últimos dígitos do ano atual).

Campos com restrição de formato no formulário de Documentos em Criação

O campo Versão só aceita dígitos e pontos, até 20 caracteres. O campo Título é enviado ao servidor sem espaços à esquerda.

Formulário de Documentos em Criação — aba Restrições

A aba “Restrições” define quem pode revisar, aprovar, publicar e visualizar o documento. Cada campo de restrição (Revisado/Aprovado/Publicado/Visualizado por) tem um seletor de abrangência com as opções “Grupo” ou “Usuários” e uma lista de responsáveis correspondente. Ao trocar a abrangência para “sem restrição” (valor 0), a lista de responsáveis é desabilitada, limpa e deixa de ser obrigatória. Ao escolher Grupo ou Usuários, a lista é habilitada, a URL de busca de responsáveis muda para a de grupos ou de usuários conforme a escolha, a lista é limpa e passa a ser obrigatória. Na edição, cada lista de responsáveis é pré-preenchida buscando o nome correspondente a cada responsável salvo naquele campo — conforme a abrangência salva (grupo ou usuário).

Upload e pré-visualização do arquivo no formulário de Documentos em Criação

O upload aceita apenas um arquivo por vez, nos formatos PDF, DOC ou DOCX, com tamanho máximo de 50MB; ao anexar um novo arquivo quando já havia um, o anterior é substituído automaticamente. O botão “Visualizar” do arquivo anexado só fica habilitado quando há um arquivo anexado (novo ou pré-existente): se é o arquivo já salvo no documento (edição), abre a visualização de conferência via URL do servidor; se é um arquivo novo do tipo PDF, é exibido diretamente do arquivo local, sem enviar ao servidor; se é um arquivo novo do tipo DOC/DOCX, o arquivo é enviado ao servidor para gerar um preview em PDF.

Encerramento do formulário de Documentos em Criação

Ao clicar em Cancelar, o usuário retorna à listagem preservando os filtros previamente aplicados. Ao salvar (Novo ou Editar), o botão Salvar é desabilitado durante o envio e reabilitado ao final, sucesso ou falha; ao fechar o alerta de sucesso, o usuário também retorna à listagem preservando os filtros.

Feedbacks — ações em lote na listagem de Documentos em Criação

Feedbacks — filtro da listagem de Documentos em Criação

Feedbacks — validação do formulário de Documentos em Criação (aba Dados)

Feedbacks — validação da aba Restrições do formulário de Documentos em Criação

Feedbacks — anexo de arquivo no formulário de Documentos em Criação

Feedbacks — salvar documento em criação (criação/edição)

Feedbacks — visualização e conferência do arquivo de Documentos em Criação

Numeração automática do Número Completo

O Número Completo automático só é montado pelo sistema quando o formulário sinaliza explicitamente que usou a máscara de numeração automática E o tipo de documento realmente tem uma máscara configurada; do contrário, o sistema aceita o Número Completo exatamente como o formulário enviou. Ao montar automaticamente, se o número resultante ultrapassar 50 caracteres, a criação é rejeitada. A máscara substitui `{SEQ}` pela próxima sequência do tipo de documento, `{TIPO}` pela sigla do tipo, `{SETOR}` pela sigla do setor selecionado, `{ANO}` pelo ano atual e `{ANO2}` pelos dois últimos dígitos do ano atual.

Incremento da sequência de numeração

A cada novo documento criado com numeração automática, a próxima sequência do tipo de documento é incrementada em 1, partindo de 1 quando ainda não houver sequência definida; a sequência obtida é a usada na numeração desse novo documento.

Unicidade de Número Completo por Versão

A criação e a edição rejeitam Número Completo já usado por outro documento na mesma Versão; na edição, o próprio documento em edição é ignorado nessa checagem.

Campos obrigatórios na criação e na edição

São obrigatórios: Título, Tipo de Documento diferente de zero e Versão. A extensão do arquivo, quando enviado, precisa ser PDF, DOC ou DOCX. Na edição, o tipo de documento informado precisa existir e o documento a editar precisa existir.

Fuso horário da data de cadastro

A data de cadastro do documento é obtida considerando o fuso horário da empresa do usuário logado, não o horário local do servidor sem ajuste.

Quem pode criar um documento de cada tipo

Um tipo de documento só aparece como permitido para criação a um usuário quando o tipo está ativo E: não tem restrição de criação configurada, ou restringe por usuário e existe permissão de “Criar” registrada para aquele usuário especificamente naquele tipo, ou restringe por grupo e existe permissão de “Criar” registrada para um dos grupos do usuário naquele tipo.

Transições de status permitidas

“Enviar para Revisão” muda o status de “Em Criação” para “Em Revisão” e só é aceita se TODOS os documentos selecionados estiverem atualmente no status “Em Criação”; caso algum não esteja, a operação inteira é rejeitada. “Enviar para Aprovação” muda o status para “Em Aprovação” sem exigir um status de origem específico. “Arquivar” muda o status para “Arquivado” sem exigir status de origem e sem exigir arquivo anexado — diferente das duas outras transições, que exigem todos os documentos selecionados com arquivo anexado.

Busca por texto na listagem

A busca por texto livre da listagem considera Título, Criador, Processo e Tipo de Documento, sem diferenciar maiúsculas de minúsculas.

Filtro por data de criação considera o dia inteiro

Ao aplicar o filtro de Data Final na listagem, o sistema considera o dia inteiro do valor selecionado: documentos criados em qualquer horário desse dia entram no resultado, não apenas os criados até o início do dia.

Substituição completa das restrições ao salvar

Ao salvar um documento, novo ou em edição, as restrições de quem pode revisar, aprovar, publicar e visualizar são sempre recriadas a partir do que está preenchido na aba Restrições no momento do salvamento — qualquer configuração de restrição anterior daquele documento é substituída integralmente, nunca combinada com a nova seleção.

Botão de ação em lote na listagem de Documentos em Criação não faz nada e mostra “Selecione ao menos um documento”

Cenário: o usuário aciona Enviar para Revisão, Enviar para Aprovação ou Arquivar sem selecionar nenhuma linha da listagem.

Mensagem exibida: “Selecione ao menos um documento para executar esta ação.”

O que fazer: selecionar ao menos uma linha antes de acionar o botão.

Envio para revisão ou aprovação de Documentos em Criação bloqueado por arquivo faltante

Mensagem exibida: “Anexe o arquivo do documento antes de enviar: {lista de títulos sem arquivo, separados por vírgula}.”

O que fazer: abrir cada documento listado e anexar o arquivo antes de repetir a ação em lote.

Arquivamento de Documentos em Criação pede confirmação e não executa nada se cancelado

Cenário: o usuário aciona “Arquivar” com documentos selecionados na tela de Documentos em Criação.

Mensagem exibida: diálogo “Confirmar Arquivamento” — “Deseja realmente arquivar os documentos selecionados?”

O que fazer: confirmar para prosseguir; cancelar não altera nenhum documento.

Botão Editar da listagem de Documentos em Criação não navega e mostra “Selecione um registro para editar”

Mensagem exibida: “Selecione um registro para editar.”

O que fazer: selecionar exatamente a linha do documento a editar, ou dar duplo clique diretamente sobre ela.

Envio para revisão de Documentos em Criação falha com “documento(s) não estão no status esperado”

Cenário: um ou mais documentos selecionados não estão no status “Em Criação” (por exemplo, já foram enviados para revisão por outro usuário).

Mensagem exibida: “{quantidade} documento(s) não estão no status esperado para esta operação.”

O que fazer: atualizar a listagem e repetir a seleção apenas com documentos ainda em “Em Criação”.

Modal de histórico do documento em criação mostra “Nenhum histórico encontrado”

Cenário: o documento não tem entradas de histórico registradas, ou a busca do histórico falhou.

Mensagem exibida: “Nenhum histórico encontrado.”

O que fazer: se o documento já mudou de status e a mensagem persistir, tratar como falha de comunicação e tentar novamente.

Filtro de data da listagem de Documentos em Criação bloqueado: “A Data Inicial não pode ser maior que a Data Final”

Mensagem exibida: “A Data Inicial não pode ser maior que a Data Final.”

O que fazer: corrigir o intervalo de datas do filtro antes de buscar.

Formulário de Documentos em Criação não salva por falta de Título, Tipo, Número ou Versão

Cenário: o usuário tenta salvar sem preencher Título, Tipo de Documento, Número Completo ou Versão.

Mensagem exibida: conforme o campo — “Informe o título.”, “Selecione o tipo de documento.”, “Informe o Número completo.” ou “Informe a versão.”

O que fazer: preencher o campo indicado e salvar novamente.

Setor obrigatório por numeração automática do tipo de documento (formulário de criação)

Cenário: o tipo de documento selecionado usa a sigla do setor na máscara de numeração e o Setor não foi preenchido.

Mensagem exibida: “Selecione o setor, pois a numeração do tipo de documento utiliza a sigla do setor.”

O que fazer: selecionar um Setor antes de salvar.

Restrição do formulário de Documentos em Criação exige responsável e não foi preenchida

Cenário: um campo da aba Restrições tem abrangência “Grupo” ou “Usuários” escolhida, mas nenhum responsável foi selecionado.

Mensagem exibida: “Informe ao menos um responsável para \”{rótulo do campo}\”.”

O que fazer: selecionar ao menos um responsável no campo indicado, ou trocar a abrangência para “sem restrição”.

Upload rejeitado por tipo de arquivo não permitido no formulário de criação

Mensagem exibida: “Tipo de arquivo não permitido. Utilize apenas PDF, DOC ou DOCX.”

O que fazer: converter o arquivo para um dos formatos aceitos antes de anexar.

Upload rejeitado por tamanho acima do limite no formulário de criação

Mensagem exibida: “Arquivo muito grande. O tamanho máximo permitido é 50MB.” (ou “Arquivo não pode ter mais de {tamanho}mb!” no componente padrão)

O que fazer: reduzir o tamanho do arquivo antes de anexar.

Pré-visualização de arquivo Word ainda não salvo falha no formulário de criação

Mensagem exibida: “Não foi possível gerar a visualização em PDF deste arquivo. Salve o documento e tente novamente.”

O que fazer: salvar o documento primeiro; a conversão volta a ser tentada na gravação.

Número Completo automático ultrapassa 50 caracteres na criação

Mensagem exibida: “O número gerado ultrapassa 50 caracteres. Ajuste a máscara de numeração do tipo de documento.”

O que fazer: encaminhar ao responsável técnico para ajustar a máscara de numeração do tipo de documento envolvido.

Duplicidade de Número Completo e Versão na criação ou edição

Mensagem exibida: “Já existe um documento com o número completo ‘{número}’ na versão ‘{versão}’.”

O que fazer: informar um Número Completo ou uma Versão diferentes para o documento.

Extensão de arquivo rejeitada pelo servidor ao salvar documento em criação

Cenário: um arquivo com extensão fora de PDF, DOC ou DOCX chega até a validação do servidor.

Mensagem exibida: “Extensão ‘{extensão}’ não permitida. Use PDF, DOC ou DOCX.”

O que fazer: anexar um arquivo em um dos formatos aceitos.

Edição de documento em criação falha com “Tipo de documento não encontrado”

Cenário: o tipo de documento vinculado ao registro em edição foi excluído ou está inconsistente.

Mensagem exibida: “Tipo de documento não encontrado.”

O que fazer: encaminhar ao responsável técnico para verificar a integridade do tipo de documento vinculado.

Edição de documento em criação falha com “Documento não encontrado”

Cenário: o documento em edição foi removido ou o identificador está inválido.

Mensagem exibida: “Documento não encontrado.”

O que fazer: atualizar a listagem; se o documento deveria existir, encaminhar ao responsável técnico.

Documento em criação salvo mas conversão do arquivo para PDF falhou

Cenário: o usuário anexa um arquivo Word e a conversão automática para PDF falha no servidor.

Mensagem exibida: “O arquivo foi anexado, mas não foi possível convertê-lo para PDF. A visualização do documento ficará indisponível até que a conversão seja possível. Detalhe: {mensagem técnica}.”

O que fazer: o documento foi salvo; para restaurar a visualização, anexar novamente o arquivo (nova tentativa de conversão) ou encaminhar o detalhe técnico ao responsável técnico.

Visualização de documento em criação indisponível: “Arquivo não encontrado para este documento”

Cenário: o usuário aciona “Exibir Documento” ou a visualização de conferência para um documento sem arquivo anexado.

Mensagem exibida: “Arquivo não encontrado para este documento.”

O que fazer: abrir o documento em edição e anexar o arquivo.

Falha genérica ao salvar o documento em criação

Mensagem exibida: “Ocorreu um erro ao salvar.” (quando o servidor não retorna detalhe) ou a mensagem de erro devolvida pelo servidor.

O que fazer: tentar novamente; se persistir, encaminhar ao responsável técnico com o horário da tentativa.

Opção “Documentos em Criação” não aparece no menu

Cenário: o usuário não enxerga a tela no menu de Gestão de Documentos.

Mensagem exibida: Nenhuma — a opção simplesmente não aparece.

O que fazer: verificar se o usuário tem o papel “ViewDocumentoCriacao” atribuído.

Formulário de novo documento em criação não abre ou combo de tipos vem vazio

Cenário: o usuário não tem o papel exigido para criar documentos, ou não está autorizado a nenhum tipo de documento.

Mensagem exibida: Nenhuma — o botão “Novo” fica indisponível, ou o combo de Tipo de Documento abre sem opções.

O que fazer: verificar se o usuário tem o papel “NovoDocumentoCriacao” e se há ao menos um tipo de documento ativo autorizado para ele.

Edição de documento em criação bloqueada por falta de papel

Cenário: o usuário tenta editar um documento sem ter o papel necessário.

Mensagem exibida: Nenhuma visível na tela — a chamada ao servidor é recusada antes de exibir os dados do documento.

O que fazer: verificar se o usuário tem o papel “EditarDocumentoCriacao” atribuído.

Ações em lote da listagem de Documentos em Criação (revisão, aprovação, arquivar) não funcionam para o usuário

Cenário: o usuário aciona uma das três ações em lote sem ter o papel necessário.

Mensagem exibida: Nenhuma tratada de forma específica pela tela — a chamada ao servidor é recusada.

O que fazer: verificar se o usuário tem o papel “AlterarStatusDocumentoCriacao” atribuído.

Documento em criação existe mas não aparece na listagem para um usuário específico

Cenário: outro usuário enxerga o documento normalmente, mas para este usuário a linha não aparece mesmo com os filtros corretos.

Mensagem exibida: Nenhuma — a listagem simplesmente vem sem aquela linha.

O que fazer: verificar se existe permissão específica para aquele documento restringindo o acesso a outro usuário ou grupo, e se o tipo de documento tem restrição de visualização que não inclui este usuário nem seus grupos.

Caso 1 — Criação de um novo documento com numeração automática por setor

Um usuário com o papel “NovoDocumentoCriacao” abre “Novo”, seleciona o tipo de documento “Procedimento Operacional Padrão”, cuja máscara de numeração inclui o setor. O campo Setor fica com asterisco de obrigatório. O usuário seleciona o setor “Produção” (sigla PRD); o Número Completo é preenchido automaticamente como “POP-PRD-014-2026”. Ele preenche Versão “1.0”, anexa um PDF de 2MB e salva. O sistema exibe “Operação efetuada com sucesso.” e retorna à listagem.

Caso 2 — Envio em lote de documentos em criação para revisão com um documento sem arquivo

Um usuário seleciona três documentos em “Em Criação” e aciona “Enviar para Revisão”. Dois têm arquivo anexado e um não. O sistema bloqueia a operação inteira com “Anexe o arquivo do documento antes de enviar: Instrução de Limpeza de Linha 3.” O usuário abre esse documento, anexa o arquivo e repete a ação; desta vez preenche a observação “Revisão semestral programada” e confirma; a grid é recarregada com os três documentos em “Em Revisão”.

Caso 3 — Edição de documento em criação ajustando restrição de aprovação por grupo

Um usuário com o papel “EditarDocumentoCriacao” abre um documento existente para edição. Na aba Restrições, altera o campo “Aprovado por” de “sem restrição” para “Grupo” e seleciona o grupo “Qualidade — Supervisores”. Ao salvar, o sistema recria as permissões de aprovação do documento a partir da seleção atual, substituindo qualquer configuração anterior daquele campo.

Caso 4 — Arquivamento direto de um documento em criação sem passar por revisão

Um documento está em “Em Criação” havendo sido cadastrado por engano, sem necessidade de seguir o fluxo de revisão e aprovação. O usuário o seleciona na listagem e aciona “Arquivar”; confirma o diálogo “Confirmar Arquivamento”; preenche a observação “Documento duplicado, arquivado sem revisão” e confirma. Como a transição para “Arquivado” não exige status de origem específico nem arquivo anexado, a operação é aceita mesmo que o documento não tivesse arquivo anexado.