Narzędzie wiersza poleceń tworzenia modelu na serwerze Revit

Można korzystać z narzędzie wiersza poleceń tworzenia modelu na serwerze Revit (RevitServerTool.exe) do automatyzacji tworzenia modeli lokalnych, aby ułatwić współdzielenie pracy. Można umieścić nowe modele lokalne bezpośrednio na komputerach członków zespołu lub w katalogach, z których mogą być one udostępniane.

Narzędzie RevitServerTool.exe jest instalowane automatycznie na wszystkich komputerach, w których zainstalowano program Revit lub Revit Server z włączoną rolą obiektu nadrzędnego lub akceleratora.

W komputerze użytkownika programu Revit domyślne położenie narzędzia to: %ProgramFiles%\Autodesk\<nazwa i wersja produktu>INSTALLDIR\RevitServerToolCommand\. W przypadku wystąpienia modułu Revit Server, domyślne położenie to: %ProgramFiles%\Autodesk\<nazwa i wersja produktu>\tools\RevitServerToolCommand.

Uwaga: Aby użyć narzędzia z linii poleceń, należy zapoznać się z systemem DOS i rozumieć budowę linii poleceń. Należy również zauważyć, że to narzędzie działa tylko w połączeniu z odpowiednią wersją programu Revit Server. Narzędzie RevitServerTool.exe w wersji 2014 działa tylko wraz z wersją 2014 programu Revit Server.

Polecenia i opcje

Polecenie	Wynik
l, createLocalRvt	Tworzy model lokalny z określonego modelu centralnego opartego na serwerze.
RevitServerTool -?	Wyświetla Pomoc dla narzędzia ReverServerTool.

Opcje	Wynik
<ścieżka modelu>	Ścieżka modelu względem katalogu projektu serwera Revit (na przykład: „Hospital \North Wing.rvt”). Jest to wymagany argument.
-d, -destination	Ścieżka, która określa położenie i nazwę pliku nowego modelu. Obsługiwane są ścieżki bezwzględne, względne i UNC. Domyślnie, nowy model jest tworzony w podfolderze „RevitServerTool” w folderze użytkownika Dokumenty. Na przykład C:\\Users\|<nazwa_użytkownika>\Document\RevitServerTool\ <nazwa_modelu>.rvt Uwaga: Jeśli nowa nazwa modelu nie jest określona w ścieżce docelowej, domyślną nazwą staje się nazwa modelu centralnego opartego na serwerze.
-s, -server	Nazwa obiektu nadrzędnego Revit Server, gdzie znajduje się model centralny. Jest to wymagany argument.
-a, -akcelerator	Nazwa akceleratora Revit Server. Gdy argument ten jest niedostępny, w narzędziu sprawdzana jest zmienna środowiskowa RSACCELERATOR2014, aby określić, czy program Accelerator został przypisany. Jeśli tak, użyta zostaje pamięć podręczna w tym programie, o ile zapisane tam dane są aktualne. Jeśli nie przypisano akceleratora, narzędzie kopiuje dane modelu centralnego bezpośrednio z obiektu nadrzędnego Revit Server. Podobnie, jeśli nazwa akceleratora jest nieprawidłowa lub akcelerator jest niewłaściwy, dane są pobierane bezpośrednio z obiektu nadrzędnego.
-o, -overwrite	Zastępuje docelowy model, jeśli już istnieje.

Typ użytkowy:

RevitServerTool createLocalRVT <ścieżka modelu > [-s | -serwer <nazwa serwera >] [-a | -akcelerator<nazwa polecenia >] [-d | -przeznaczenie <ścieżka >] [-o | -nadpisanie ]

Typ użytkowy	Wynik
RevitServerTool createLocalRVT<ścieżka modelu> [-serwer <nazwa serwera>]	Kopia lokalna modelu centralnego określonego przez ścieżkę modelu w określonym obiekcie nadrzędnym Revit Server zostanie utworzona w osobistym katalogu użytkownika, przy użyciu nazwy użytkownika zdefiniowanej w systemie operacyjnym.
RevitServerTool createLocalRVT <ścieżka modelu> [-serwer <nazwa serwera>] [-przeznaczenie <ścieżka>] [-nadpisanie]	Kopia lokalna modelu centralnego określonego przez ścieżkę modelu w określonym obiekcie nadrzędnym Revit Server zostanie utworzona w położeniu docelowym, z nadpisaniem poprzedniej wersji, która już istnieje.
RevitServerTool createLocalRVT <ścieżka modelu> [-serwer <nazwa serwera>] [-przeznaczenie <ścieżka>] [-akcelerator <nazwa polecenia >]	Kopia lokalna modelu centralnego określonego przez ścieżkę modelu w określonym obiekcie nadrzędnym Revit Server zostanie utworzona z pamięci podręcznej w określonym akceleratorze Revit Server i umieszczona w określonej lokalizacji.

Przykłady użycia narzędzi z wiersza poleceń

Uwaga: Użycie znaków cudzysłowu w poniższych przykładach jest wymagane, aby prawidłowo przetworzyć argumenty zawierające spacje.

Aby utworzyć model lokalny z modelu centralnego o nazwie As-Built complex.rvt znalezionego w katalogu 2011 Hospital Project w aplikacji Revit Server Host o nazwie SERVER01

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

LUB

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

Aby utworzyć model lokalny z tego samego modelu centralnego, nadając nazwę As-Built complex myLocal.rvt i zapisać go w folderze C:\local files

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

LUB

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

Uwagi dotyczące korzystania z funkcji

Kolejność, w której użytkownik określa opcje nie ma znaczenia.
Narzędzie obsługuje zarówno z ukośnik odwrotny, jak i ukośnik w ścieżkach. Ponadto narzędzie akceptuje danych wprowadzone z zerami wiodącymi i zakończonych ukośnikami.
Ogólną zasadą jest, narzędzie podejmuje próbę ponowienia działania po wystąpieniu wyjątku
Jeśli we wskazanym akceleratorze wystąpi błąd w trakcie operacji, działanie narzędzia nie powiedzie się, wówczas ponów próbę.
Jeśli użytkownik nie określił pliku „.rvt” dla wartości docelowej, zostają użyte następujące reguły:
- Jeśli wartość docelowa jest zakończona przez \ lub / to nazwa pliku wyjściowego będzie taka sama jak nazwa pliku źródłowego i zostanie on utworzony w katalogu określonym przez wartość opcji docelowej.
- Jeśli wartość docelowa nie jest zakończona przez \ lub / to nazwa pliku wyjściowego będzie używana jest po ostatnim znaku \ lub / w wartości opcji docelowej i będzie miał rozszerzenie „.rvt”.
- Jeśli wartość docelowa nie koduje ścieżki (np. nie użyto znaku \ ani /), wówczas nazwa pliku wyjściowego będzie wartością własną z rozszerzeniem „.rvt”.

Błędy i odpowiedzi narzędzi

Warunek: użytkownik określa ścieżkę modelu, ale nie można określić wymaganego argumentu -serwer.

Odpowiedź: nie jest wymagany argument, serwer.

Warunek: określona ścieżka modelu nie istnieje na serwerze.

Odpowiedź: nie można utworzyć modelu lokalnego, ponieważ „<ścieżka modelu>” nie istnieje na serwerze Revit „<serwer>”.

Warunek: określona ścieżka docelowa nie istnieje. Jeśli użytkownik posiada uprawnienia, może utworzyć nową ścieżkę i umieścić nowy model.

Odpowiedź: model lokalny „<ścieżka docelowa >” został pomyślnie utworzony.

Warunek: ścieżka docelowa (nowy model) już istnieje i nie jest używana jawnie przez użytkownika [-nadpisanie].

Odpowiedź: nie można utworzyć modelu lokalnego, ponieważ model „<ścieżka modelu >” już istnieje.

Warunek: wskazany serwer nie jest dostępny lub sieć przestaje działać.

Odpowiedź: nie można utworzyć modelu lokalnego, ponieważ nie jest on obecnie dostępny w programie Revit Server.

Warunek: model na serwerze jest aktualnie w użyciu.

Odpowiedź: nie można utworzyć modelu lokalnego, ponieważ model ”<ścieżka modelu >” jest obecnie w użyciu.

Warunek:

Wykonywanie operacji nie powiodło się z nieznanych przyczyn, ponieważ model jest uszkodzony lub użytkownik nie ma dostępu do ścieżki docelowej lub całkowita długość ścieżki docelowej przekracza 255 znaków lub użytkownik nie określił ścieżki docelowej lub nie można utworzyć ścieżki.

Odpowiedź: nie można utworzyć modelu lokalnego w położeniu „<ścieżka docelowa>”.