Abrir um modelo (modello_apri)

O que faz

Abre um arquivo do Revit, um projeto .rvt ou uma família .rfa, que está no seu disco ou numa pasta de rede, para que a sua IA possa lê-lo com as outras ferramentas do BIMit sem que você precise abri-lo manualmente.

A abertura é um trabalho (job): um modelo grande leva minutos, então a sua IA não fica esperando. O BIMit responde na hora com o id do trabalho (ou com o resultado, se o modelo abrir dentro do tempo de espera pedido); depois Status do trabalho acompanha o andamento e Cancelar o trabalho o interrompe.

Modelos compartilhados (workshared): por padrão abrem desvinculados do central, mantendo os conjuntos de trabalho (workset), com todos os worksets de usuário fechados. Nada é gravado na pasta do central. É possível escolher os worksets a abrir, ou abrir o modelo desvinculado sem worksets.
Em segundo plano: o modelo não se torna o documento ativo, a menos que você peça. As outras ferramentas o alcançam pelo título.
Nunca auditoria: o modelo sempre abre sem a opção Auditoria.
Proteção de memória: se durante a abertura a memória física disponível cair abaixo de um mínimo (2048 MB por padrão), a abertura é cancelada e o Revit continua utilizável.
Modelos na nuvem (BIM 360, Autodesk Docs, Revit Server): ainda não suportados.

Como funciona

A sua IA chama a ferramenta com o caminho completo do arquivo (por exemplo C:\Projetos\Edificio.rvt ou \\servidor\projetos\Central.rvt) e, se necessário, os worksets a abrir.
O BIMit verifica o caminho (completo, extensão .rvt ou .rfa, arquivo existente) e coloca a abertura na fila: ela começa assim que o Revit terminar o que está fazendo.
No Revit, o BIMit lê as informações do arquivo: se o arquivo for de uma versão mais recente do Revit, para; se for de uma versão anterior, o Revit o atualiza na memória (mais lento, o arquivo não muda). Se o modelo já estiver aberto neste Revit, o BIMit usa esse sem reabri-lo.
O Revit abre o modelo com as opções escolhidas. O BIMit registra fase, porcentagem e memória disponível, que a sua IA lê com Status do trabalho. Se o Revit mostrar uma janela durante a abertura, o BIMit não responde por você: a sua IA avisa e a abertura continua quando você responder no Revit.
No fim, a sua IA recebe título, caminho, se é uma família, se é compartilhado, se está ativo, o estado dos worksets, a memória e os segundos de abertura, além de eventuais observações.

Enquanto o Revit abre o modelo, as outras ferramentas que usam o Revit esperam; Status do trabalho e Cancelar o trabalho respondem na hora.

Exemplos de pedido

"Abra em segundo plano o modelo \\servidor\projetos\Hospital\Central_ARQ.rvt e me diga quantos níveis ele tem."
"Abra C:\Projetos\Escola.rvt só com os worksets Estrutura e Fachadas e depois liste as paredes externas."
"Abra a família C:\Bibliotecas\Janela_dupla.rfa e me mostre os parâmetros dela."

O que muda e como desfazer

Abrir um modelo não altera o arquivo: por padrão um modelo compartilhado abre desvinculado do central e nada é gravado na pasta do central. Um arquivo de versão anterior é atualizado só na memória e continua igual até você salvá-lo.

A única exceção é a opção "copia_locale", para usar só se você pedir: o BIMit cria uma cópia local do central em %LOCALAPPDATA%\BIMit\Copie locali e a abre vinculada ao central, o que registra o seu usuário na pasta do central. O caminho de uma cópia local existente também a abre vinculada.

Uma abertura na fila ou em andamento é interrompida com Cancelar o trabalho: uma abertura cancelada não deixa o modelo aberto e o Revit continua utilizável. Se o cancelamento chegar quando o Revit já terminou, o BIMit fecha o modelo sem salvar (não consegue fechá-lo se for o documento ativo: nesse caso, feche você no Revit).

A ferramenta não altera elementos do modelo, então não há nada a desfazer com Ctrl+Z.

Limites

O nível de IA "Leitura" basta para abrir um modelo desvinculado; a opção "copia_locale" exige o nível "Equipe", que só você escolhe no botão "Nível" da aba BIMit.
Arquivos .rvt e .rfa no disco ou na rede, com caminho completo. Modelos na nuvem: ainda não.
Um arquivo salvo numa versão mais recente do Revit não abre.
Uma única chamada espera no máximo 120 segundos; uma abertura mais longa é acompanhada com Status do trabalho.

Parâmetros

Parâmetro	Significado
`percorso`	Obrigatório. Caminho completo do arquivo `.rvt` ou `.rfa`, no disco ou na rede (ex. `C:\Projetos\Edificio.rvt`, `\\servidor\projetos\Central.rvt`).
`workset`	Modelos compartilhados: nomes dos worksets de usuário a abrir, os outros ficam fechados; `["*"]` = todos. Padrão: todos fechados (abertura mais rápida, menos memória).
`scollega`	Modelos compartilhados: `conserva_workset` (padrão: desvinculado do central, worksets mantidos), `scarta_workset` (desvinculado, sem worksets), `copia_locale` (só se você pedir: cria uma cópia local do central e a abre vinculada). Ignorado para modelos não compartilhados.
`attiva`	`true` = o modelo se torna o documento ativo na janela do Revit. Padrão `false`: aberto em segundo plano.
`memoria_minima_mb`	Memória física disponível mínima (MB) durante a abertura: abaixo dela, a abertura é cancelada. `0` = sem proteção. Padrão: a configuração do BIMit, senão 2048.
`attesa_s`	Segundos para esperar nesta chamada o modelo aberto (0-120). Padrão 0: responde na hora com o id do trabalho.

Abrir um modelo