Коротко
- Проверьте поле `isCompositeDesign`, чтобы определить, содержит ли модель Revit Cloud Worksharing объединённый проект.
- Если `isCompositeDesign` имеет значение true, файл может скачиваться в виде ZIP-архива с основной моделью и связанными файлами RVT.
- Для файлов, опубликованных 7 февраля 2025 года или позднее, связанные модели можно получить вызовом GET linked Revit files.
- В прежнем рабочем процессе для ZIP-входных данных указывается `zip: true`, а имя основной модели внутри архива задаётся полем `pathInZip`.
Чему вы научитесь в этом руководстве?
Разберём, почему файл, опубликованный через Revit Cloud Worksharing, иногда скачивается не как отдельный RVT, а как ZIP-архив, и как передать такой проект в рабочий процесс Automation API. Главное — определить, является ли модель объединённым проектом: вместе с host-файлом в архиве могут находиться связанные модели RVT. Поэтому при подготовке задачи автоматизации недостаточно смотреть только на расширение файла — важно также проверить сведения из ответа API о версии файла.
Руководство опирается на поля API и два рабочих процесса, описанных в документации Autodesk Platform Services. Пороговая дата, разделяющая старый и новый методы, — 7 февраля 2025 года. Цель материала — не рассмотреть все этапы аутентификации и настройки приложения для вызовов API, а помочь интерпретировать сведения о модели и выбрать правильный формат входных данных.
Требования
Получите доступ к проекту Revit Cloud Worksharing и Autodesk Platform Services API, чтобы читать сведения о файлах. Пример из источников рассматривает сведения о проекте и версии файла с помощью вызовов API.
Для работы с Automation API учитывайте требование об активной пробной версии Forge или подписке, указанное в источниках. Соответствующий источник ссылается на отдельную страницу с подробностями о ценах, но актуальная стоимость здесь не приводится.
Убедитесь, что можете проверить дату публикации обрабатываемой модели и поля
attributes.extensionиattributes.dataв ответе о версии файла.Не считайте обязательной установку Revit для настольных компьютеров: в описании Revit Automation API от Autodesk говорится о доступе к Revit Database API без установленной настольной версии Revit. Однако это не означает, что доступ к API или необходимые входные данные проекта не требуются.
Поскольку источники не указывают конкретный номер версии Revit, актуальную стоимость подписки или полную процедуру настройки аутентификации, эти сведения здесь не предполагаются.
Пошаговая инструкция: определение типа проекта и подготовка задачи
Убедитесь, что файл представляет собой модель Revit Cloud Worksharing. В ответе на вызовы API для содержимого проекта, элемента файла или его версий проверьте поле
attributes.extension.type. Если его значение —versions:autodesk.bim360:C4RModel, согласно источнику, файл является моделью Revit Cloud Worksharing. Это первый шаг, позволяющий правильно интерпретировать сведения об объединённом проекте.Проверьте флаг объединённого проекта. В ответе для той же версии найдите поле
attributes.data.isCompositeDesign. Значениеtrueозначает, что модель помечена как объединённый проект; при скачивании может формироваться ZIP-архив с host-моделью и связанными файлами RVT. Если значениеfalse, источник указывает, что после публикации последних версий host-файла и связанных файлов будет получен один файл RVT.Определите имя основной модели. Для объединённого проекта поле
attributes.data.compositeParentFileсодержит имя host-файла Revit. Оно используется, в частности, в старом рабочем процессе, когда нужно выбрать основную модель в ZIP-архиве. Используйте значение поля как имя файла и не подменяйте значение, полученное от API, собственным предположением.Сопоставьте дату публикации с пороговой датой 7 февраля 2025 года. В источнике говорится, что для моделей, опубликованных до этой даты, применяется старый метод, а для опубликованных в этот день или позднее — новый. Примите решение на основе значения
attributes.createTimeфайла. Если не проверить дату и применять один и тот же формат входных данных ко всем моделям, входные данные могут не соответствовать ожиданиям задачи.Настройте ZIP-входные данные для старого рабочего процесса. Если файл был опубликован до 7 февраля 2025 года и содержит объединённый проект, задайте
zipравнымtrueв настройкахinputFileзадачи. В полеpathInZipукажите имя host-файла изcompositeParentFile. Так задача получает ZIP-архив, а параметр указывает, какой файл RVT внутри него нужно обработать. В источнике этот метод показан на примере задачи экспорта DXF; применяйте его с учётом требований выбранного действия к входным данным.Для нового рабочего процесса получите host-файл и связанные файлы вместе. Для файлов, опубликованных 7 февраля 2025 года или позднее, вызов GET linked Revit files может возвращать host-модель и неопубликованные связанные файлы RVT. Проверьте host-файл и результаты
linkedFilesв ответе, включая имена моделей, сведения о версиях и статус публикации. Затем передайте в качестве входных данных задачи подписанные URL, предоставленные этим вызовом. В примере источника для host-файла указан статусPublished, а для связанного файла —NotPublished; это показывает, что host- и связанный файлы могут иметь разные статусы публикации.Проверьте структуру входных данных перед запуском задачи. В старом методе используются ZIP и имя host-файла внутри архива; в новом — адреса host-файла и связанных моделей из ответа GET linked Revit files. Не смешивайте эти подходы, словно это одна структура. Убедитесь, что файлы, полученные от API, соответствуют входным данным, ожидаемым действием задачи.
Частые ошибки
Если скачивается ZIP, не стоит сразу считать файл повреждённым: такая интерпретация может быть неверной, когда есть неопубликованные связанные модели. Сначала проверьте поле isCompositeDesign и имя host-файла. Ещё одна ошибка — указывать zip: true для каждого файла, не проверив значение isCompositeDesign: для модели, не являющейся объединённой, этот параметр может не соответствовать ожидаемому входному файлу RVT.
Не следует забывать и о дате публикации. Согласно источнику, для файлов, опубликованных до 7 февраля 2025 года, используется старый метод, а для файлов, опубликованных в пороговую дату или позднее, — подход GET linked Revit files. Наконец, не подставляйте случайное имя файла вместо значения compositeParentFile и не пропускайте связанные файлы, получая только host-модель при использовании нового метода.
Влияние на рабочие процессы в архитектуре и визуализации
Это различие важно для команд, которые автоматически экспортируют, проверяют или обрабатывают отчёты по данным Revit в облаке. Не все связанные модели проекта могут быть опубликованы одновременно, поэтому автоматизация, ожидающая один файл RVT, может работать с неполными данными, если не обработает составной набор входных файлов должным образом. Предварительная проверка сведений о модели помогает автоматизации обрабатывать правильный набор файлов.
Для архитектурных бюро и BIM-команд главное — не оборудование, а доступ к API, условия подписки и правильная настройка входных данных. Команды визуализации могут использовать этот процесс для повторяющихся задач, например экспорта или анализа моделей; однако источники не приводят сведений о совместимости с конкретными программами для рендеринга, времени обработки или стоимости. Перед запуском в производственную среду стоит провести небольшую проверку с используемым действием и структурой файлов.
Дальнейшие шаги
В ресурсах для разработчиков Revit API от Autodesk перечислены руководства для начала работы, примеры кода и поддержка сообщества. Сначала проверьте в ответе о версии файла тип модели, флаг объединённого проекта и имя host-файла. Затем выберите метод в соответствии с датой публикации и протестируйте входные данные задачи. При расширении рабочего процесса рассмотрите перечисленные в источниках сценарии: извлечение и изменение данных Revit, автоматическую подготовку отчётов и создание документации.
Источники и лицензия
Это руководство подготовлено на основе общих сведений Autodesk Platform Services о Revit API, объявления об Automation API и руководства по обработке объединённых проектов Revit. Все три источника доступны открыто (лицензия = свободная); содержание адаптировано на турецкий язык.
Источники
Источников: 3Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Для бюро в Турции самое практичное преимущество этого подхода — возможность заранее выявить неожиданные ZIP-входные данные, возникающие из-за статуса публикации связанных моделей. Особенно для команд, регулярно выполняющих экспорт и анализ моделей, правильный выбор формата входных данных может сократить число повторных запусков и необходимость вручную разбирать файлы.
При принятии решения об инвестициях важнее сначала оценить доступ к API, условия подписки и совместимость с текущим рабочим процессом, а не мощность оборудования. Поскольку источники не приводят актуальную стоимость и расходы на обработку, бюро стоит проверить собственные сценарии использования на небольшом тесте. Для студентов это также полезный пример того, как связанные модели Revit передаются в облачную автоматизацию; однако совместимость с конкретными версиями программного обеспечения следует проверять отдельно.
Частые вопросы
Как определить, что файл является объединённым проектом в Revit Automation API?
Проверьте поле `attributes.data.isCompositeDesign` для версии файла. Если значение — `true`, проект помечен как объединённый, и при скачивании может быть создан ZIP-архив с host-файлом и связанными файлами RVT.
Какой метод используется для передачи связанных моделей Revit в Automation API?
Для файлов, опубликованных 7 февраля 2025 года или позднее, вызов GET linked Revit files может предоставить host-файл и связанные файлы. Подписанные URL из ответа передаются во входные данные задачи.
Требуется ли установка Revit для настольных компьютеров для Revit Automation API?
Согласно описанию Revit Automation API от Autodesk, к Revit Database API можно обращаться без установленной настольной версии Revit. В источниках отдельно упоминаются требования к доступу к API и подписке.



