Утилита командной строки Revit Server для создания модели

Утилиту командной строки Revit Server для создания модели (RevitServerTool.exe) можно использовать для автоматизации создания локальных моделей в целях упрощения совместной работы на основе сервера.

Новые локальные модели можно размещать непосредственно на компьютерах участников рабочей группы или в папках, к которым они имеют доступ.

Утилита RevitServerTool.exe устанавливается автоматически на всех компьютерах, где установлены Revit или Revit Server и включены роли "Хост" или "Акселератор".

На компьютере пользователя Revit этот инструмент по умолчанию устанавливается в папку%ProgramFiles%\Autodesk\<имя и версия программы >INSTALLDIR\RevitServerToolCommand\. На экземплярах сервера Revit Server этот инструмент по умолчанию устанавливается в папку%ProgramFiles%\Autodesk\<имя и версия программы >\tools\RevitServerToolCommand.

Прим.: Для использования этой утилиты командной строки необходим опыт работы с DOS и понимание структуры командных строк. Обратите внимание на то, что эта утилита работает только с соответствующей версией Revit Server; то есть версия 2015 инструмента RevitServerTool.exe работает только с версией Revit Server 2015.

Команды и параметры

Команда	Результат
l, createLocalRvt	Создание локальной модели на основе указанной модели из хранилища.
RevitServerTool -?	Отображение справки по утилите ReverServerTool.

Параметры	Результат
<путь к модели>	Путь к модели относительно каталога проекта Revit Server (например, "Hospital \North Wing.rvt"). Это обязательный аргумент.
-d, -destination	Путь, указывающий папку и имя файла создаваемой модели. Поддерживаются абсолютные, относительные пути и пути в формате UNC. По умолчанию новая модель создается во вложенной папке "RevitServerTool" внутри пользовательской папки "Документы". Например, C:\\Users|<имя пользователя>\Document\RevitServerTool\<имя модели>.rvt Прим.: Если новое имя модели не указано в пути назначения, по умолчанию используется имя модели из хранилища на базе сервера.
-s, -server	Имя хоста Revit Server, на котором хранится модель из хранилища. Это обязательный аргумент.
-a, -accelerator	Имя акселератора Revit Server. Если этот параметр не указан, утилита проверяет переменную среды RSACCELERATOR2015 и определяет, назначен ли акселератор. Если он назначен, утилита использует кэшированные данные на этом акселераторе в случае их актуальности. Если акселератор в списке отсутствует, утилита копирует данные модели из хранилища с хоста Revit Server. Аналогичным образом, если имя акселератора недопустимо или же акселератор отключен, данные извлекаются непосредственно с хоста.
-o, -overwrite	Перезапись целевой модели, если она уже существует.

Использование:

RevitServerTool createLocalRVT <путь к модели> [-s | -server <имя сервера>] [-a | -accelerator <имя акселератора>] [-d|-destination <путь>] [-o|-overwrite]

Использование	Результат
RevitServerTool createLocalRVT <путь к модели> [-server <имя сервера>]	Локальная копия модели из хранилища, указанная с помощью пути к модели на заданном хосте Revit Server, создается в личном каталоге пользователя с использованием имени пользователя, определенного в операционной системе.
RevitServerTool createLocalRVT <путь к модели> [-server <имя сервера>] [-destination <путь>] [-overwrite]	Локальная копия модели из хранилища, указанная с помощью пути к модели на заданном хосте Revit Server, создается в целевой папке и перезаписывает все существующие предыдущие версии.
RevitServerTool createLocalRVT <путь к модели> [-server <имя сервера>] [-destination <путь>] [-accelerator <имя акселератора>]	Локальная копия модели из хранилища, указанная с помощью пути к модели на заданном хосте Revit Server, создается из кэша на заданном акселераторе Revit Server и помещается в указанную папку.

Примеры использования командной строки

Прим.: Кавычки в следующем примере необходимы для правильной обработки аргументов, содержащих пробелы.

Создание локальной модели на основе модели из хранилища, называемой "As-Built complex.rvt", которая находится в каталоге "2011 Hospital Project" на хосте Revit Server с именем 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

Создание локальной модели на основе той же модели из хранилища с присвоением ей имени "As-Built complex myLocal.rvt" и сохранением ее в папке 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

Примечания об использовании

• Порядок указания параметров не имеет значения.
• Утилита поддерживает использование в пути как обратной, так и обычной косой черты. Кроме того, при вводе данных для этого инструмента допустимо использовать косые черты в начале и в конце строки ввода.
• Как правило, при обнаружении условия исключения утилита пытается повторить попытку.
• Если указанный акселератор завершает работу в ходе выполнения операции, утилита также завершает работу, а затем повторяет попытку выполнить операцию.
• Если в качестве целевого значения не указать файл ".rvt", применяются следующие правила:
  • Если значение параметра места назначения заканчивается на \ или /, то имя файла вывода будет совпадать с именем исходного файла, и он будет создан в каталоге, определенном значением параметра назначения.
  • Если значение параметра места назначения не заканчивается на \ или /, то в качестве имени файла назначения будет использована последовательность символов, следующая за последней косой чертой \ или / в значении параметра места назначения, а в качестве расширения будет указано ".rvt".
  • Если значение места назначения не является путем (т.е. в нем отсутствуют символы \ или /), то имя выходного файла будет совпадать с этим значением, и в качестве расширения будет указано ".rvt".

Условия ошибок и ответы утилиты

Условие. Пользователь указывает путь к модели, но не указывает обязательный аргумент -server.

Ответ. В команде отсутствует обязательный аргумент server.

Условие. Указанный путь к модели не существует на сервере.

Ответ. Создать локальную модель невозможно, поскольку модель "<путь к модели>" отсутствует на Revit Server "<сервер>".

Условие. Указанный целевой путь не существует. Если пользователь имеет соответствующие права, будет создана новая папка, в которой будет выполнено сохранение новой модели.

Ответ. Локальная модель "<целевой путь>" успешно создана.

Условие. Путь назначения (новая модель) уже существует, пользователь очевидно не задействовал параметр [-overwrite].

Ответ. Создать локальную модель невозможно, поскольку модель "<путь к модели>" уже существует.

Условие. Указанный сервер недоступен или сеть отключена.

Ответ. Создать локальную модель невозможно, поскольку Revit Server в настоящий момент недоступен.

Условие. Модель в настоящий момент используется на сервере.

Ответ. Создать локальную модель невозможно, поскольку модель "<путь к модели>" в настоящий момент используется.

Условие.

Не удалось выполнить операцию по неизвестной причине. Возможные причины: модель повреждена; у пользователя отсутствует право доступа к целевой папке; общая длина целевого пути превышает 255 символов; пользователь не указал целевой путь; не удалось создать папку.

Ответ. Создать локальную модель в папке "<целевой путь>" невозможно.