Обработка связанных моделей в Revit Automation API: пошаговое руководство

Что вы узнаете из этого руководства?

При добавлении модели Revit в облачный автоматизированный процесс вместо ожидаемого RVT-файла можно получить ZIP-архив. Это не всегда означает ошибку загрузки: согласно руководству Autodesk, если связанные файлы модели Revit Cloud Worksharing опубликованы не в том же актуальном состоянии, что и основная модель, пакет загрузки может содержать основной RVT и связанные с ним RVT-файлы.

В этом руководстве вы узнаете, как определить, является ли модель файлом Revit Cloud Worksharing, помечена ли она как составной проект и какой метод автоматизации выбрать. Также рассмотрим различия в рабочем процессе для файлов, опубликованных до 7 февраля 2025 года и в эту дату или позже.

Autodesk указывает, что Revit API позволяет автоматизировать повторяющиеся задачи и расширять функциональность Revit. Revit Automation API, в свою очередь, позволяет выполнять такие операции, как создание, проверка и изменение данных Revit, с помощью облачных приложений и сервисов. В этом примере основное внимание уделяется корректной передаче файла Revit в задание автоматизации.

Требования и подготовка

Для рабочего процесса понадобятся приложение, способное работать с API Autodesk Platform Services (APS), возможность запрашивать сведения о файлах и их версиях, а также файлы моделей для передачи в задание. На странице API Autodesk перечислены руководства для разработчиков, SDK, примеры кода и ресурсы сообщества. Revit Automation API позволяет создавать облачные приложения с доступом к Revit DB API без установки Revit на настольный компьютер.

В старом объявлении об Automation API в источниках упоминается действующая подписка Forge или пробная учётная запись. Эта информация не подтверждает актуальные условия оплаты или доступа; перед началом работы проверьте цены и требования к учётной записи в актуальных материалах APS. В документации также не указана конкретная версия Revit для этой операции.

Перед началом подготовьте:

• Запись файла или версии модели Revit Cloud Worksharing, которая будет обрабатываться через APS.

• Данные доступа, необходимые для выполнения аутентифицированных вызовов API.

• Инструмент для проверки даты публикации и атрибутов версии файла.

• Информацию, содержащую дату публикации модели и имя основного файла.

Пошагово: определите тип модели и способ передачи

1. Проверьте, распознаётся ли файл как модель Revit Cloud Worksharing. В руководстве Autodesk рекомендуется проверять поле attributes.extension.type в ответе API, возвращающем содержимое папки проекта, запись элемента или сведения о версии. Если значение этого поля — versions:autodesk.bim360:C4RModel, файл определяется как модель Revit Cloud Worksharing. Проверяйте данные версии, а не делайте вывод только по расширению файла.

2. Проверьте, является ли проект составным. Поле attributes.data.isCompositeDesign в той же записи версии указывает, является ли модель составной. Значение true означает, что файл — составной проект Revit; скачанное содержимое может быть ZIP-архивом с RVT-файлами, связанными с основной моделью. Если значение false, согласно пояснению Autodesk, основной файл и его связи опубликованы в последних версиях, поэтому загрузка может состоять из одного RVT-файла.

3. Определите имя основного файла модели. В составной модели поле attributes.data.compositeParentFile содержит имя основного файла Revit. Это необходимо, чтобы указать в старом рабочем процессе, какой файл из ZIP следует использовать как основной. Не угадывайте имя основного файла — ориентируйтесь на значение из записи версии.

4. Выберите метод с учётом даты публикации. Если файл опубликован до 7 февраля 2025 года, можно использовать старый метод Autodesk: установите для входного файла задания значение zip в true, а в pathInZip укажите имя основного файла модели. Так ZIP-архив передаётся в задание автоматизации с указанием пути к основному файлу, который должен открыть Revit.

5. Для моделей, опубликованных 7 февраля 2025 года или позже, используйте новый метод. Для файла, опубликованного в эту дату или позднее, Autodesk рекомендует получить основную модель и неопубликованные связанные RVT-файлы с помощью вызова GET linked Revit files. Передайте в задание основную модель и сведения о связанных файлах, возвращённые этим вызовом. Вместо прямого применения старого подхода с ZIP используйте метод, соответствующий дате публикации.

6. Проверьте входные данные задания. Если выбран старый метод, убедитесь, что настройка ZIP и значение pathInZip указаны правильно. При новом методе проверьте, что вместе с основной моделью переданы и связанные файлы, возвращённые вызовом. В примере Autodesk для этих файлов используются подписанные URL. Не копируйте URL из примера — используйте актуальные значения из ответа собственного вызова API.

Распространённые ошибки

• Считать ZIP повреждённым файлом: если связанные модели не опубликованы в актуальных версиях, получение ZIP может быть ожидаемым поведением.

• Путать тип модели и её составной статус: значение C4RModel определяет тип файла Cloud Worksharing, а isCompositeDesign показывает, является ли проект составным. Проверьте оба параметра.

• Выбирать основной RVT наугад: получите имя нужного файла из ZIP из поля compositeParentFile.

• Не учитывать дату публикации: для файлов, опубликованных до 7 февраля 2025 года и после этой даты, в руководстве описаны разные способы передачи.

• Использовать временные ссылки доступа из примера: подписанные URL из источника — часть демонстрационного ответа. Используйте ссылки, полученные в результате собственного вызова.

Влияние на рабочие процессы архитектуры и визуализации

Этот подход важен для команд, которые интегрируют в облачные рабочие процессы на базе Revit повторяющуюся проверку моделей, извлечение данных, подготовку отчётов или автоматическую документацию. Среди вариантов применения, перечисленных Autodesk, — проверка и анализ данных Revit, экспорт данных, создание пользовательских семейств Revit и автоматическая генерация документации. Архитектурные бюро, команды по дизайну интерьеров и BIM-менеджеры могут снизить риск использования неверных или неполных входных данных, если будут проверять версии связанных моделей до запуска автоматизации.

Для команд визуализации совместная передача основного файла модели и связей позволяет автоматизации работать с ожидаемыми данными проекта. Однако в этом руководстве нет сведений о производительности рендеринга, требованиях к оборудованию или совместимости с конкретным ПО для визуализации. Перед внедрением проверьте условия доступа к API, статус лицензии и совместимость рабочего процесса с данными Revit.

Следующие шаги

Проведите первый тест на модели, не критичной для работы. Сохраните атрибуты версии файла, проверьте дату публикации и выберите подходящий метод. Убедитесь, что в результате автоматизации обработан ожидаемый основной RVT. Затем обратитесь к руководствам Autodesk по Revit API, вводным материалам и примерам кода, чтобы адаптировать рабочий процесс под свои задачи извлечения данных или подготовки отчётов.

Источник и лицензия

Это руководство адаптировано на турецкий язык на основе страниц Autodesk о Revit Automation API и Revit API, а также статьи для разработчиков о передаче составных проектов Revit в задания автоматизации. Все источники — официальные материалы для разработчиков Autodesk, распространяемые по открытой лицензии.