Apri un modello (modello_apri)

Cosa fa

Apre un file di Revit, un progetto .rvt o una famiglia .rfa, che si trova sul tuo disco o in una cartella di rete, così la tua IA può leggerlo con gli altri strumenti di BIMit senza che tu debba aprirlo a mano.

L'apertura è un lavoro (job): un modello grande richiede minuti, quindi la tua IA non resta in attesa. BIMit risponde subito con l'id del lavoro (oppure con il risultato, se il modello si apre entro il tempo di attesa richiesto); poi Stato del lavoro ne segue l'avanzamento e Annulla il lavoro lo ferma.

Modelli condivisi (workshared): per default si aprono scollegati dal centrale conservando i workset, con tutti i workset utente chiusi. Nulla viene scritto nella cartella del centrale. Si possono scegliere i workset da aprire, oppure aprire il modello scollegato senza workset.
In background: il modello non diventa il documento attivo, salvo richiesta. Gli altri strumenti lo raggiungono indicando il suo titolo.
Mai audit: il modello si apre sempre senza l'opzione Controlla (audit).
Guardia di memoria: se durante l'apertura la memoria fisica disponibile scende sotto un minimo (2048 MB per default), l'apertura si annulla e Revit resta utilizzabile.
Modelli cloud (BIM 360, Autodesk Docs, Revit Server): non ancora supportati.

Come funziona

La tua IA chiama lo strumento con il percorso completo del file (per esempio C:\Progetti\Edificio.rvt o \\server\progetti\Centrale.rvt) e, se serve, i workset da aprire.
BIMit controlla il percorso (completo, estensione .rvt o .rfa, file esistente) e mette l'apertura in coda: parte appena Revit finisce quello che sta facendo.
In Revit, BIMit legge le informazioni del file: se il file è di una versione di Revit più recente si ferma; se è di una versione precedente Revit lo aggiorna in memoria (più lento, il file non cambia). Se il modello è già aperto in questo Revit, BIMit usa quello senza riaprirlo.
Revit apre il modello con le opzioni scelte. BIMit registra fase, percentuale e memoria disponibile, che la tua IA legge con Stato del lavoro. Se Revit mostra una finestra durante l'apertura, BIMit non risponde al tuo posto: la tua IA ti avvisa e l'apertura riprende quando rispondi in Revit.
Alla fine la tua IA riceve titolo, percorso, se è una famiglia, se è condiviso, se è attivo, lo stato dei workset, la memoria e i secondi di apertura, ed eventuali note.

Mentre Revit apre il modello, gli altri strumenti che usano Revit aspettano; Stato del lavoro e Annulla il lavoro rispondono subito.

Esempi di richiesta

«Apri in background il modello \\server\progetti\Ospedale\Centrale_ARC.rvt e dimmi quanti livelli ha.»
«Apri C:\Progetti\Scuola.rvt solo con i workset Struttura e Facciate, poi elenca i muri esterni.»
«Apri la famiglia C:\Librerie\Finestra_doppia.rfa e mostrami i suoi parametri.»

Cosa cambia e come si annulla

Aprire un modello non cambia il file: per default un modello condiviso si apre scollegato dal centrale e nulla viene scritto nella cartella del centrale. Un file di una versione precedente viene aggiornato solo in memoria e resta com'è finché non lo salvi.

Fa eccezione solo la scelta «copia_locale», da usare solo se lo chiedi tu: BIMit crea una copia locale del centrale in %LOCALAPPDATA%\BIMit\Copie locali e la apre collegata al centrale, il che registra il tuo utente nella cartella del centrale. Anche il percorso di una copia locale esistente la apre collegata.

Un'apertura in coda o in corso si ferma con Annulla il lavoro: un'apertura annullata non lascia il modello aperto e Revit resta utilizzabile. Se l'annullamento arriva quando Revit ha già finito, BIMit chiude il modello senza salvare (non può chiuderlo se è il documento attivo: in quel caso lo chiudi tu in Revit).

Lo strumento non modifica elementi del modello, quindi non c'è nulla da annullare con Ctrl+Z.

Limiti

Il livello dell'IA «Lettura» basta per aprire un modello scollegato; la scelta «copia_locale» richiede il livello «Squadra», che scegli solo tu nella scheda BIMit («Livello»).
File .rvt e .rfa su disco o in rete, con percorso completo. Modelli cloud: non ancora.
Un file salvato con una versione di Revit più recente non si apre.
Una singola chiamata aspetta al massimo 120 secondi; un'apertura più lunga si segue con Stato del lavoro.

Parametri

Parametro	Significato
`percorso`	Obbligatorio. Percorso completo del file `.rvt` o `.rfa`, su disco o in rete (es. `C:\Progetti\Edificio.rvt`, `\\server\progetti\Centrale.rvt`).
`workset`	Modelli condivisi: nomi dei workset utente da aprire, gli altri restano chiusi; `["*"]` = tutti. Default: tutti chiusi (apertura più veloce, meno memoria).
`scollega`	Modelli condivisi: `conserva_workset` (default: scollegato dal centrale, workset conservati), `scarta_workset` (scollegato, senza workset), `copia_locale` (solo se lo chiedi tu: crea una copia locale del centrale e la apre collegata). Ignorato per i modelli non condivisi.
`attiva`	`true` = il modello diventa il documento attivo nella finestra di Revit. Default `false`: aperto in background.
`memoria_minima_mb`	Memoria fisica disponibile minima (MB) durante l'apertura: sotto, l'apertura si annulla. `0` = nessuna guardia. Default: l'impostazione di BIMit, altrimenti 2048.
`attesa_s`	Secondi da aspettare in questa chiamata il modello aperto (0-120). Default 0: risponde subito con l'id del lavoro.

Apri un modello