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 é compartilhada — e não muda ao publicar. O código de adequação (S2, A1…) é um eixo separado e não entra no nome do arquivo. 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. O envio a partir do Revit usa as mesmas regras, conferidas antes de exportar o IFC — ver Revit: IFC e apontamentos.

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 o coordenador liberou o ajuste para a disciplina do arquivo) — 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. Nos campos de texto livre o delimitador não é aceito: se você digitar ou colar o caractere que separa os segmentos (_, por exemplo), ele é trocado por hífen na hora — um delimitador dentro de um segmento quebraria o nome em uma parte a mais e a linha nunca ficaria válida. O cabeçalho da coluna avisa isso (sem _).
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: o arquivo fica sem nomenclatura padronizada no histórico do projeto e não há como renomeá-lo depois pela interface — a saída é apagar ou arquivar o documento e enviá-lo de novo com o nome correto.

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.

O nome corrigido acompanha o restante do envio

Depois da correção na tabela de ajuste, é o nome novo que aparece nos passos seguintes do assistente (metadados e confirmação) e na tela de progresso — e é ele que será gravado no projeto, tanto na biblioteca quanto no arquivo servido no download.

O nome original do arquivo no seu computador continua visível como referência: como uma linha secundária discreta nos dois primeiros passos, e na dica que aparece ao passar o mouse sobre o nome nos demais. Ele só é exibido quando difere do nome corrigido.

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 compartilhar.
• Conflito — o RXX presente no nome do arquivo já corresponde a uma revisão já compartilhada ou 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. O código de adequação nunca faz parte do nome.

Resumo visual

Para coordenadores e administradores