Коротко
- Walkthrough по Revit посвящён запуску уже существующего плагина в Automation Service, а не разработке плагинов.
- В облачной среде Revit взаимодействие с пользователем невозможно, поэтому ссылки на пользовательский интерфейс нужно удалить из плагина.
- Примерный процесс требует изменений в коде на C#; тем, у кого нет опыта работы с C#, можно начать со второго задания и примера плагина DeleteWalls.dll.
- Запросы можно отправлять через cURL или выполнять с помощью коллекции Postman, подготовленной для walkthrough.
Autodesk Platform Services (APS) Design Automation API v3 позволяет создавать, анализировать и изменять данные Revit в облаке. В официальном walkthrough Autodesk для Revit показано, как запускать существующий плагин Revit в Automation Service без пользовательского интерфейса. Руководство посвящено не разработке плагина, а подготовке готового плагина к запуску в облаке и выполнению описанных в документации запросов. В документации не указаны конкретный номер версии Revit, требования к оборудованию или стоимость.
Какие задачи можно перенести в облако?
Определите повторяющуюся задачу. Сначала выясните, какие операции в файлах Revit часто повторяются или должны выполняться для большого количества моделей. В документации APS Design Automation API описан как сервис, на который можно перенести повторяющиеся или масштабные рабочие нагрузки. Примеры задач для Revit: создание моделей, анализ данных модели, автоматическое формирование отчётов, изменение существующих моделей в соответствии с корпоративными стандартами и подготовка документации.
Этот этап помогает понять, подходит ли задача для автоматизации. Если операция зависит от решения пользователя или элемента управления на экране, перенести её в облачную среду без изменений может быть невозможно. Чёткое определение входных данных и ожидаемого результата позволяет удерживать объём работ под контролем при подготовке плагина.
Возьмите за основу существующий плагин Revit. Walkthrough не объясняет, как писать плагины, а посвящён только процессу их запуска в Automation Service. Если плагина ещё нет, это руководство не следует считать самостоятельной инструкцией по его созданию. За информацией о разработке плагинов Autodesk направляет в Revit Developer Center.
Это важное различие: запуск в облаке не заменяет разработку плагина. Нельзя считать, что плагин, используемый в офисе, автоматически заработает и в облаке; зависимости от пользовательского интерфейса и логики выполнения нужно рассматривать отдельно. Если начать с одной чётко определённой задачи, будет проще понять, какая подготовка необходима.
Подготовка плагина к запуску в облаке
Удалите зависимости от пользовательского интерфейса. По данным Autodesk, взаимодействие с пользователем в Automation Service невозможно. Плагины Revit обычно рассчитаны на взаимодействие с пользовательским интерфейсом, поэтому перед запуском в облаке из плагина необходимо удалить все ссылки на интерфейс.
Причина в том, что в облачной среде пользователь не сможет открыть окно на экране, сделать выбор или нажать кнопку подтверждения. Поэтому процесс нужно преобразовать в сценарий, не требующий промежуточных решений пользователя. В документации Task 1 обозначен как этап адаптации плагина для Automation API. Удаление ссылок на пользовательский интерфейс — часть этой подготовки.
Оцените необходимость изменения кода. В walkthrough Autodesk для выполнения первого задания требуется изменить код на C#. Если у вас недостаточно опыта работы с C#, в документации предлагается начать с Task 2, используя готовый пример плагина
DeleteWalls.dll, подготовленного для Automation API. Это имя файла примера плагина; его не следует считать универсальным инструментом для любых задач Revit.Пример может помочь пройти этапы отправки запросов, однако сам по себе он не устранит зависимости от пользовательского интерфейса и не адаптирует логику плагина для реального проекта. При переходе к собственному плагину нужно отдельно проверить код и выполняемые им операции. В документации нет конкретного списка необходимых изменений кода или универсальной инструкции по преобразованию всех плагинов.
Отправка запросов и выполнение рабочего процесса
Следуйте последовательности заданий в walkthrough. Walkthrough по Revit разделяет на этапы процесс, необходимый для запуска плагина в Automation Service. Первое задание выполняется только в Visual Studio и не предполагает отправки запроса в APS. Поэтому в коллекции Postman от Autodesk нет группы для Task 1.
Это поможет не принять отсутствие первого задания в Postman за ошибку. Сначала плагин нужно подготовить к запуску, а затем перейти к взаимодействию с сервисом. Названия заданий и запросов в документации соотнесены друг с другом; следуя этому именованию, проще понять, к какому этапу относится тот или иной запрос.
Используйте Postman или cURL. Подготовленная Autodesk коллекция Postman объединяет HTTP-запросы, используемые в walkthrough. Запросы сгруппированы по заданиям; если вы не хотите пользоваться Postman, walkthrough можно пройти с помощью cURL. Postman представлен как вариант с графическим интерфейсом для отправки HTTP-запросов.
Те, кто предпочитает отправлять запросы вручную, могут выбрать cURL, а тем, кто хочет выполнять их через интерфейс, подойдёт коллекция Postman. Важно сверять название примера запроса и соответствующее ему задание. В исходном тексте не приводятся таблица совместимости с версиями Revit или параметры запросов, подходящие для любого проекта, поэтому не следует предполагать значения, которых нет в документации.
Запустите процесс в облачной среде Revit. APS предоставляет доступ к облачной версии Revit без пользовательского интерфейса через Automation API. В документации указано, что доступ к Revit DB API можно получить без установки Revit на настольный компьютер. Это открывает возможности для облачных приложений и сервисов, которые создают, извлекают и изменяют данные моделей.
На этом этапе проверьте, соответствует ли целевая операция плагина требованиям проекта, какие входные данные используются и какой результат ожидается. Это не означает, что Autodesk предоставляет специальную команду для такой проверки; речь идёт о практике, которая помогает безопасно внедрить автоматизацию в офисный рабочий процесс. В источниках не описан подробный способ скачивания результатов и не указана конкретная версия Revit.
Влияние на рабочие процессы архитектуры и визуализации
Архитектурным и интерьерным бюро, которые регулярно проверяют модели Revit, извлекают данные, формируют отчёты или готовят документацию, стоит рассмотреть такой подход. Если одинаковые операции выполняются для нескольких моделей, это хорошая отправная точка, чтобы оценить, можно ли автоматизировать в облаке задачи, которые сейчас выполняются по отдельности на настольных компьютерах. При этом в источниках не указано, насколько вырастет скорость или сколько времени можно сэкономить.
Для archviz-команд функция рендеринга непосредственно не описана. Документация посвящена запуску плагинов Revit в облаке и не содержит сведений о движке рендеринга, настройках качества изображения или требованиях к видеокарте. Поэтому область применения следует ограничить данными модели и операциями плагинов Revit. Условия лицензирования и стоимость также не описаны; их нужно изучить отдельно перед переходом на облачный рабочий процесс.
Частые ошибки
Переносить плагин, взаимодействующий с пользовательским интерфейсом, в Automation Service без изменений. Согласно документации, ссылки на интерфейс необходимо удалить.
Считать walkthrough обучением разработке плагинов. Руководство описывает запуск существующего плагина.
Искать Task 1 в коллекции Postman. Первое задание выполняется в Visual Studio и не предполагает отправки запроса в APS.
Считать пример
DeleteWalls.dllготовым решением для любого проекта. В источнике он представлен как конкретный пример плагина, с которого можно начать Task 2.Предполагать версии Revit, стоимость, требования к оборудованию или параметры запросов, не указанные в документации. В исходных материалах эти сведения отсутствуют.
Источники
Источников: 2Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Для архитектурных и интерьерных бюро в Турции APS Design Automation может быть интересным решением, особенно для команд, которые постоянно выполняют одни и те же операции в Revit. Однако основная работа заключается не только в отправке запроса в облако: нужно избавиться от зависимостей плагина от пользовательского интерфейса и проверить, что он выдаёт правильный результат в реальном рабочем процессе. Поэтому разумнее начать с небольшой, чётко очерченной задачи.
В документации не указаны стоимость, условия лицензирования, версия Revit и требования к оборудованию; не следует принимать решение, исходя из предположений о цене или совместимости. Кроме того, пример `DeleteWalls.dll` не заменяет плагины конкретного бюро. Практичным началом будет оценить имеющийся плагин и потребность в знаниях C#, а затем пройти официальный walkthrough с помощью Postman или cURL.
Частые вопросы
Можно ли запускать плагины Revit в облаке с помощью APS Design Automation?
Да. В документации Autodesk по APS Design Automation API v3 есть walkthrough по запуску плагинов Revit в Automation Service. В облачной среде взаимодействие с пользователем невозможно.
Что нужно сделать перед запуском плагина Revit в Automation Service?
Нужно удалить ссылки плагина на пользовательский интерфейс. Walkthrough Autodesk также включает этап подготовки, требующий изменений в коде на C#.
Можно ли отправлять запросы Revit Automation API через Postman?
Да. Коллекция Postman от Autodesk содержит HTTP-запросы из walkthrough, сгруппированные по заданиям. Запросы также можно отправлять с помощью cURL.



