Utilità della riga di comando per la creazione di modelli di Revit Server

È possibile utilizzare l'utilità della riga di comando per la creazione di modelli di Revit Server (RevitServerTool.exe) per automatizzare la creazione di modelli locali al fine di semplificare la condivisione del lavoro. È possibile posizionare nuovi modelli locali direttamente nel computer dei membri del team o nelle directory da cui è possibile accedervi.

RevitServerTool.exe è installato automaticamente su qualsiasi computer in cui si installa Revit o Revit Server con i ruoli Host o Accelerator abilitati.

Nel computer di un utente di Revit, il percorso di default di questo strumento è il seguente: %ProgramFiles%\Autodesk\<nome prodotto e versione>INSTALLDIR\RevitServerToolCommand\. Nelle istanze di Revit Server, il percorso di default di questo strumento è :%ProgramFiles%\Autodesk\<nome prodotto e versione>\tools\RevitServerToolCommand.

Nota: Per utilizzare questa utilità della riga di comando, è richiesta la conoscenza di DOS e della struttura delle righe di comando. Osservare inoltre che questa utilità funziona solo con la corrispondente versione di Revit Server; in altri termini, la versione 2014 di RevitServerTool.exe funziona solo con la versione 2014 di Revit Server.

Comandi e opzioni

Comando	Risultato
l, createLocalRvt	Crea un modello locale dal modello centrale basato su server specificato.
RevitServerTool -?	Visualizza la Guida dell'utilità ReverServerTool.

Opzioni	Risultato
<percorso modello>	Percorso del modello relativo alla directory di progetto di Revit Server (ad esempio: "Hospital \North Wing.rvt"). Si tratta di un argomento obbligatorio.
-d, -destination	Percorso che specifica la posizione e il nome file del nuovo modello. Sono supportati percorsi assoluti, relativi e UNC. Per default il nuovo modello viene creato nella sottocartella "RevitServerTool" della cartella Documenti dell'utente. Ad esempio, C:\\Utenti\|<nomeutente>\Documenti\RevitServerTool\<nomemodello>.rvt Nota: Se il nome del nuovo modello non è specificato nel percorso di destinazione, per default viene utilizzato il nome del modello centrale basato su server.
-s, -server	Nome del Revit Server Host in cui risiede il modello centrale. Si tratta di un argomento obbligatorio.
-a, -accelerator	Nome del Revit Server Accelerator. Quando questo argomento non è disponibile, l'utilità verifica la variabile di ambiente RSACCELERATOR2014 per determinare se è stato assegnato un Accelerator e, in caso affermativo, utilizza i dati memorizzati nella cache dell'Accelerator, se sono aggiornati. Se nessun Accelerator è presente nell'elenco, l'utilità copia i dati del modello centrale direttamente dal Revit Server Host. Analogamente, se il nome dell'Accelerator non è valido o se l'Accelerator non è disponibile, i dati vengono recuperati direttamente dall'Host.
-o, -overwrite	Sovrascrive il modello di destinazione eventualmente esistente.

Utilizzo:

RevitServerTool createLocalRVT <percorso modello> [-s | -server <nome server>] [-a | -accelerator <nome Accelerator>] [-d|-destination <percorso>] [-o|-overwrite]

Utilizzo	Risultato
RevitServerTool createLocalRVT <percorso modello> [-server <nome server>]	Viene creata una copia locale del modello centrale specificato dal percorso del modello sul Revit Server Host specificato nella directory personale dell'utente, utilizzando il nome utente definito nel sistema operativo.
RevitServerTool createLocalRVT <percorso modello> [-server <nome server>] [-destination <percorso>] [-overwrite]	Viene creata una copia locale del modello centrale specificato dal percorso del modello sul Revit Server Host specificato nella posizione del percorso di destinazione, sostituendo qualsiasi eventuale versione precedente.
RevitServerTool createLocalRVT <percorso modello> [-server <nome server>] [-destination <percorso>] [-accelerator <nome Accelerator>]	Viene creata una copia locale del modello centrale specificato dal percorso del modello sul Revit Server Host specificato in base alla cache del Revit Server Accelerator specificato; tale copia viene poi posizionata nella destinazione specificata.

Esempi di utilizzo delle righe di comando

Nota: L'utilizzo delle virgolette negli esempi è obbligatorio per elaborare correttamente gli argomenti contenenti spazi.

Per creare un modello locale da un modello centrale denominato As-Built complex.rvt, situato nella directory 2011 Hospital Project sul Revit Server Host denominato SERVER01

RevitServerTool createLocalRvt "2011 Hospital Project\As-Built complex.rvt" -s SERVER01 -o

RevitServerTool L "2011 Hospital Project\As-Built complex.rvt" -s SERVER01 -o

Per creare un modello locale da questo stesso modello centrale, assegnandogli il nome As-Built complex mylocal.rvt e memorizzandolo nella cartella C:\local files

RevitServerTool createLocalRvt "2011 Hospital Project\As-Built complex.rvt" -s SERVER01 -d "c:\local files\As-Built complex_myLocal.rvt" -o

RevitServerTool L "2011 Hospital Project\As-Built complex.rvt" -s SERVER01 -d "c:\local files\As-Built complex_myLocal.rvt" - o

Utilizzo delle note

L'ordine in cui l'utente specifica le opzioni non è rilevante.
L'utilità supporta sia la barra, sia la barra rovesciata nei percorsi. Inoltre, lo strumento accetta input con barre iniziali o finali.
Come regola generale, quando si verifica una condizione eccezionale, l'utilità cercherà di ripetere l'operazione.
Se l'Accelerator specificato incontra un problema nel corso di un'operazione, l'utilità non viene eseguita correttamente e l'operazione verrà ripetuta in seguito.
Se l'utente non specifica un file ".rvt" come valore di destinazione, vengono utilizzate le seguenti regole:
- Se il valore di destinazione termina in \ o /, il nome del file di output sarà uguale al nome del file di origine e verrà creato nella directory specificata dal valore dell'opzione di destinazione.
- Se il valore di destinazione non termina in \ o /, il nome del file di output sarà qualsiasi nome che segue l'ultima \ o / nel valore dell'opzione di destinazione e avrà l'estensione ".rvt".
- Se il valore di destinazione non codifica un percorso (ovvero non utilizza i caratteri \ o /), il nome del file di output corrisponderà al valore stesso con l'estensione ".rvt".

Condizioni di errore e risposta dell'utilità

Condizione: l'utente specifica il percorso del modello, ma non indica l'argomento -server richiesto.

Risposta: al comando manca l'argomento -server richiesto.

Condizione: il percorso di modello specificato non esiste nel server.

Risposta: non è possibile creare il modello locale poiché il modello "<percorso modello>" non esiste nel Revit Server "<server>".

Condizione: il percorso di destinazione specificato non esiste. Se l'utente dispone delle autorizzazioni necessarie, viene creato il nuovo percorso e il nuovo modello verrà posizionato in tale destinazione.

Risposta: il modello locale "<percorso di destinazione>" viene creato correttamente.

Condizione: il percorso di destinazione (nuovo modello) esiste già e l'utente non ha espressamente selezionato l'opzione [-overwrite].

Risposta: non è possibile creare il modello locale poiché il modello "<percorso modello>" esiste già.

Condizione: il server specificato non è accessibile o la connessione con la rete è interrotta.

Risposta: non è possibile creare il modello locale poiché Revit Server non è attualmente disponibile.

Condizione : il modello sul server è attualmente in uso.

Risposta: non è possibile creare il modello locale poiché il modello "<percorso modello>" è attualmente in uso.

Condizione:

Esecuzione non riuscita per motivi sconosciuti, perché il modello è danneggiato o perché l'utente non ha accesso al percorso di destinazione, oppure perché la lunghezza totale del percorso di destinazione è maggiore di 255, o l'utente non ha specificato il percorso di destinazione, ma non è stato possibile crearlo.

Risposta: non è possibile creare il modello locale nella posizione "<percorso di destinazione>".