Revit: projeto, IFC, apontamentos, links e clashes

O add-in studioBIM fala com a Catena de dentro do Revit. Os comandos ficam na aba Catena:

Tudo usa o mesmo login da web. Nada disso exige chave de API: o add-in repete o fluxo de credenciais da plataforma e guarda o cookie de sessão.

Pré-requisitos

• Revit 2021 a 2026. Há um binário por versão; o instalador marca as que encontrar na máquina.
• O add-in studioBIM, baixado da página de releases . Feche o Revit antes de instalar.
• O arquivo do projeto já salvo. O nome do .rvt é o que amarra o modelo ao projeto e à disciplina no Catena — um documento nunca salvo não tem como ser enviado.
• (Opcional) O endereço da organização em Config. → Geral → Catena Build, no formato https://<organização>.catena.build. Sem isso, o add-in descobre a org pelo e-mail e a senha.

Famílias (.rfa) não vão para o Catena. Abra o projeto.

Login

Na primeira ação (enviar ou abrir apontamentos), o add-in pede e-mail e senha — os mesmos da web. A descoberta da organização sai do apex (catena.build): se a conta existir em mais de uma, o add-in lista as opções. Marque Manter conectado neste computador para a sessão durar 30 dias; sem isso, o login é pedido de novo no dia seguinte.

O cookie fica cifrado com a DPAPI do Windows, em %AppData%\studioBIM\catena.session. Só o usuário que fez o login consegue lê-lo. Se a sessão expirar no meio de um envio ou de uma consulta, o login volta a aparecer e a operação se repete.

Projeto, nomenclatura e cronograma

Ao abrir um arquivo salvo, o add-in tenta amarrá-lo ao projeto Catena pela sigla (slug) no nome — o mesmo project_code da nomenclatura. Se já houve uma escolha manual, ela prevalece. O botão Projeto no ribbon mostra a sigla; um ponto de exclamação indica nome fora do padrão.

O painel Projeto (somente leitura) traz:

• a faixa de nomenclatura: válido, inválido, conflito de revisão ou sem regra — as mesmas regras do envio, agora ao abrir o arquivo, sem renomear o .rvt;
• o feed de atividades do projeto (uploads, aprovações, apontamentos);
• o cronograma das próximas semanas: entregas da disciplina do modelo, eventos e a alocação de quem está logado. A edição continua na aba Cronograma da web.

Enviar modelo, na faixa, abre o diálogo de envio IFC quando o nome precisa de correção.

Enviar o modelo em IFC

1. Na aba studioBIM, clique em Enviar ao Catena.
2. Confirme o projeto (sugerido pela sigla no nome do arquivo — o mesmo slug que a nomenclatura valida no segmento project_code).
3. Escolha a configuração de exportação IFC. A lista vem do próprio arquivo — as mesmas da caixa Exportar → IFC do Revit. Se o arquivo não tiver nenhuma salva, o add-in cai nos padrões internos (IFC 2x3 Coordination View 2.0 e IFC 4 Reference View).
4. Opcionalmente, mande como ifcZIP. O Catena extrai o IFC de dentro do pacote; a nomenclatura é conferida sobre o nome com extensão .ifc de qualquer forma.
5. Confirme. O IFC é gerado numa pasta temporária, sobe, e o arquivo local some assim que o envio termina.

A versão entra no trabalho em andamento da disciplina, como um upload pela web. O processamento IFC continua no servidor: quando terminar, o modelo aparece na biblioteca. Gestores que marcaram avançar no workflow no upload da web continuam valendo só para aquele canal — o envio pelo Revit não pula a fila de revisão.

Nomenclatura

As regras são as mesmas do assistente de upload e da validação de nomenclatura. O add-in confere o nome antes de exportar, porque a rota que valida no servidor já cria o registro do modelo. O que a tela oferece diante de um nome fora do padrão não é escolha do plugin: sai da configuração do projeto.

O ajuste vale só para o nome que sobe ao Catena — o arquivo do Revit não é renomeado. Uma revisão que já existe no modelo bloqueia o envio em qualquer um dos casos.

Painel de apontamentos (BCF)

O comando Apontamentos mostra ou esconde o painel dockable Apontamentos, ao lado da vista. Ele não cria apontamento: a criação continua no visualizador 3D, na prancha PDF ou pela importação de .bcfzip. O painel é para navegar e resolver a fila no modelo nativo.

Lista e filtros

O projeto é sugerido pelo nome do arquivo; se a sigla não bater, escolha na lista. Filtros:

Quando o projeto tem catálogo, aparecem também categoria, etiqueta e local. A lista acompanha criação e mudança de outras pessoas sem recarregar — o indicador no canto mostra ao vivo ou reconectando.

Se o módulo de apontamentos estiver desligado no projeto, a lista abre só para leitura.

Ir até o viewpoint

Ir até aplica no modelo aberto o que o apontamento guardou:

• a câmera (olho, alvo e acima), convertida do Y-up do viewer para o Z-up do Revit, em pés;
• a origem do export IFC (SitePlacement: compartilhado, implantação ou projeto), lida da mesma configuração usada no envio;
• os elementos cujo IfcGUID ainda existe neste arquivo;
• a caixa de corte, quando os GUIDs não estão neste modelo (por exemplo, o conflito nasceu num IFC federado) ou a seleção é grande demais para isolar;
• o View Template escolhido no painel — o padrão sugerido é studioBIM Apontamentos, se existir no arquivo.

O add-in conta quantos GUIDs o viewpoint citou e quantos este arquivo encontrou. GUID só em link ou lista enorme → caixa de corte. Tudo achado neste arquivo → seleciona e isola.

Comentar, resolver e reabrir

Com o apontamento aberto:

• Comentar grava na mesma thread da web.
• Resolver pede um comentário obrigatório (o mesmo gesto da plataforma) e passa o status para Resolvido.
• Reabrir devolve a Ativo, também com comentário.

Apontamento Fechado não aceita comentário nem mudança de status pelo painel. Proprietários, coordenadores e o responsável designado continuam podendo resolver e reabrir — as mesmas regras da página de apontamentos.

Links do projeto

O Catena versiona .rvt e IFC. Não há “Revit link” na API: o painel Links cruza pelo nome do arquivo e pela disciplina.

Baixar grava a última versão visível em %AppData%\studioBIM\links\<projeto>\. Carregar faz LoadFrom / cria o link quando o arquivo é .rvt. IFC continua sendo vinculado pelo próprio Revit (Inserir → Vincular IFC). O reload exige transação e, em worksharing, workset editável — não acontece sozinho ao ocioso.

O viewpoint dos apontamentos também procura IfcGUID nos documentos linkados, não só no host.

Clashes

A detecção continua no visualizador web. O painel Clashes lista os testes do projeto e as interferências abertas que envolvem a disciplina do modelo:

• Ir até aplica caixa de corte e os IfcGUID dos dois lados (e dos links, se estiverem carregados);
• Resolver / Falso + gravam o reviewStatus na plataforma;
• Apontar cria um tópico BCF a partir do clash — o item cai no painel de apontamentos. Com o módulo de issues desligado, a criação é recusada, como na web.

Criar teste, SmartViews e o overview colorido ficam na web.

O que continua na web

O add-in não substitui o CDE: ele encurta o caminho entre o modelo nativo e a fila que já vive na plataforma.