Validação de nomenclatura

Para que qualquer pessoa consiga identificar um arquivo sem precisar abri-lo, o CDE exige que os nomes de arquivo sigam um padrão de nomenclatura definido para o projeto. Este capítulo explica como esse padrão funciona e o que fazer quando um arquivo não está de acordo com ele.

O que é um nome válido

Um nome de arquivo válido é composto por segmentos (partes) separados por um delimitador (geralmente - ou _). Cada segmento representa uma informação específica sobre o arquivo, por exemplo:

SIGLA-ETAPA-DISCIPLINA-Descricao-R01.pdf

Nesse exemplo: sigla do projeto, etapa, disciplina, uma descrição livre e um código de revisão no nome (R01). Esse segmento no nome serve para identificar e agrupar arquivos do mesmo documento; a revisão formal registrada no sistema (R00, R01…) só é atribuída quando a versão é publicada — veja Aprovações e reprovações. O padrão exato — quais segmentos existem, em que ordem e com quais valores permitidos — é configurado pelo coordenador do projeto e pode variar por tipo de arquivo (PDF, DWG, IFC etc.).

A validação acontece automaticamente assim que os arquivos são adicionados ao assistente de upload — não é necessário nenhum passo extra.

Estados possíveis de um arquivo

O que fazer quando o nome está incorreto

Quando um arquivo aparece marcado como inválido, você tem até três caminhos, dependendo de como o projeto está configurado:

1. Corrigir o arquivo na origem — renomear o arquivo no computador e enviá-lo novamente.
2. Usar a tabela de ajuste de nomenclatura (se habilitada pelo coordenador) — uma tabela interativa é exibida ao lado do arquivo inválido, com um campo por segmento do nome. Campos com uma lista de valores conhecidos (como etapa, disciplina ou revisão) aparecem como menus de seleção; campos de texto livre podem ser digitados diretamente. O nome final é montado automaticamente conforme você preenche os campos, e o indicador de status muda para válido assim que o nome estiver correto.
3. Enviar mesmo assim (se habilitado pelo coordenador) — marca o arquivo para envio mesmo com o nome fora do padrão. Use esse caminho apenas em casos excepcionais, já que o arquivo ficará sem nomenclatura padronizada no histórico do projeto.

Se nenhuma dessas opções resolver, o arquivo pode simplesmente ser removido da lista antes de continuar o envio, usando o botão de remoção individual ou a ação em lote Remover com erro.

Ao expandir a linha de um arquivo inválido, a plataforma mostra o diagnóstico segmento a segmento: o que era esperado em cada posição do nome e o que foi encontrado, além de um exemplo de nome correto para aquele tipo de arquivo.

Detecção de versão e revisão no nome

Quando a detecção de revisão está ativa no projeto, cada arquivo enviado é comparado com o histórico do projeto (pelo nome-base, sem o sufixo RXX):

• Novo — é a primeira vez que esse documento/modelo é enviado.
• Nova versão (ex.: v2 → v3) — já existe uma versão anterior desse arquivo; o envio criará a próxima versão interna (versionNumber), preservando o histórico. A revisão formal (R00, R01…) não é criada nesse momento — só ao publicar.
• Conflito — o RXX presente no nome do arquivo já corresponde a uma revisão já publicada desse documento/modelo. Não é possível enviar até corrigir o código no nome (ou remover o arquivo da lista).

O segmento de revisão no nome do arquivo é, portanto, um auxílio de nomenclatura e de detecção de conflito — não o número da revisão no banco.

Resumo visual

Para coordenadores e administradores