Run Dynamo выполняет выбранный Dynamo-граф .dyn из Revit в фоновом automation mode, не открывая интерфейс рабочей области Dynamo. Перед выполнением BIMO может передать сохранённые входные значения, а после — показать значения нод, отмеченных как outputs.
Команда находится в BIMO > Interact > Run Dynamo.
Внимание: Dynamo-граф может изменять активную модель Revit, записывать файлы или обращаться к внешним сервисам. Run Dynamo не является sandbox и не предоставляет автоматический rollback. Незнакомый граф сначала проверяйте на копии модели и сохраняйте работу перед запуском.
Эта страница описывает встроенную команду BIMO Library. Если нужно вывести конкретный файл .dyn как отдельную именную кнопку панели, см. Создание команд из Dynamo .dyn.
Доступность И Версии Revit
Run Dynamo присутствует и видима в стандартной Ribbon BIMO. Текущие исходники противоречат друг другу по минимальной рабочей версии Revit:
Версия Revit | Текущее Поведение, Подтверждённое Исходниками |
|---|---|
2021–2022 | Version check команды отменяет выполнение и просит использовать Revit 2023 или новее. |
2023 | Metadata разрешает запуск, но зарегистрированный Dynamo execution service в этой сборке является заглушкой NotImplemented. Не рассчитывайте на Run Dynamo в Revit 2023 до устранения расхождения. |
2024–2027 | Текущая реализация содержит фоновый запуск Dynamo. При этом граф должен быть совместим с версией Dynamo соответствующего релиза Revit. |
Старая Landing-страница заявляет Revit 2023 и новее. Таблица выше следует исполняемой реализации, а не этому более широкому обещанию.
Когда Использовать
Нужно запустить отдельный .dyn без открытия интерфейса Dynamo.
Нужно повторно использовать один граф с разными путями или значениями через presets.
Нужно запускать типовые конфигурации через три toolbar variants.
Нужно показать вычисление или отчёт из output nodes Dynamo.
Нужно выполнить проверенный граф, изменяющий активную модель Revit.
Используйте сгенерированную пользовательскую Dynamo-команду, если графу нужны собственное имя на панели, типизированные Revit selection inputs или отдельная идентичность команды.
Перед Запуском
Закройте интерфейс Dynamo. Run Dynamo не запускается, пока Dynamo открыт в UI mode.
Откройте Revit-документ и вид, которые ожидает граф.
Откройте и проверьте граф вручную в версии Dynamo текущего релиза Revit.
Сохраните .dyn в постоянной доступной папке.
Установите все необходимые Dynamo packages и обеспечьте доступ к внешним файлам.
Отметьте переиспользуемые ноды как Is Input, а ноды результата — как Is Output.
Сохраните или сделайте резервную копию модели перед запуском графа, меняющего данные.
Настройки
Настройка | По Умолчанию | Что Делает |
|---|---|---|
Файл скрипта | Пусто | Путь к файлу Dynamo .dyn. Диалог выбора фильтрует Dynamo-файлы. |
Входные значения | Пусто | Необязательные строки, связывающие ID ноды Dynamo со значением, которое применяется перед выполнением. |
From Script | — | Читает сохранённые input nodes выбранного графа и заново формирует список по их ID, именам и сохранённым значениям по умолчанию. |
Каждая строка input содержит:
Поле | Значение |
|---|---|
ID ввода | Идентификатор ноды, по которому BIMO ищет input Dynamo. |
Название ввода | Read-only подпись из графа для пользователя. |
Значение | Строка, передаваемая в input node до запуска графа. |
Важно: форма настроек не проверяет существование файла и применимость каждого значения. Поэтому пустой, перемещённый или несовместимый файл может дойти до этапа выполнения и завершиться ошибкой там.
Как Использовать
Закройте Dynamo и откройте целевой Revit-документ.
Запустите BIMO > Interact > Run Dynamo.
В поле Файл скрипта выберите нужный .dyn.
Если граф имеет переиспользуемые inputs, нажмите From Script.
Проверьте каждый ID ввода, Название ввода и Значение.
Подтвердите настройки, чтобы запустить граф.
Дождитесь завершения и изучите окно результата или ошибки BIMO.
Основной пункт Run Dynamo всегда открывает окно настроек перед выполнением. После начала графа текущая реализация не предоставляет окно прогресса или кнопку отмены BIMO.
Подготовка Inputs
From Script читает ноды, сохранённые как Dynamo inputs, и заменяет текущий список входных значений значениями из графа. Если нажать кнопку повторно после ручного редактирования, снова проверьте список: будут загружены сохранённые defaults графа.
Для передачи inputs действуют важные правила:
BIMO сопоставляет input по ID ноды, а не по отображаемому имени.
Имена служат только подписями и не исправляют устаревший или ошибочный ID.
Значения передаются как строки; используйте формат, ожидаемый целевой нодой.
Для dropdown используйте точное имя пункта, сохранённое в Dynamo.
Если ID ноды не найден или Dynamo отклонил обновление значения, текущий сервис не предупреждает об этом input отдельно и может запустить граф со значением, уже сохранённым в нём.
Встроенная команда Library не открывает типизированные Revit pickers для выбора элементов, граней или рёбер. Графы, требующие нового интерактивного выбора, лучше публиковать как сгенерированные пользовательские Dynamo-команды.
После изменения input nodes сохраните .dyn, снова выполните From Script и проверьте presets, зависящие от прежних ID.
Выполнение И Outputs
BIMO запускает Dynamo в фоновом automation mode, загружает выбранный граф, применяет строки inputs и принудительно выполняет один запуск.
При успешном выполнении:
значения собираются только с нод, отмеченных Is Output;
одна output node показывается без префикса с её именем;
несколько output nodes показываются вместе с именами;
collections и dictionaries форматируются для чтения;
результат можно скопировать в буфер обмена.
Если у графа нет output nodes или отформатированный результат пуст, BIMO не показывает success dialog. Это не доказывает, что граф не запускался или не изменил модель.
При ошибках:
Dynamo nodes в состоянии Error вызывают окно ошибки;
детали exception можно раскрыть и скопировать;
обычные warnings Dynamo не всегда считаются ошибкой выполнения;
проверка ошибок происходит после запуска графа и не гарантирует rollback ранее выполненных изменений модели.
Presets И Variants
Run Dynamo поддерживает presets для сохранения:
пути к .dyn;
импортированных ID и имён inputs;
входных значений.
Preset можно назначить на Variant #1, Variant #2 или Variant #3. Основной пункт открывает настройки; variant использует назначенный preset и может пропустить окно, если форма считается корректной.
Внимание: проверка пути не устанавливает, существует ли файл. Поэтому variant может попытаться выполнить перемещённый или удалённый граф без предварительного открытия настроек.
Каждый variant является отдельным пунктом Revit Ribbon, поэтому ему можно назначить Revit Keyboard Shortcut. Горячая клавиша сразу запускает назначенный preset: заранее проверьте активный документ, путь к графу и inputs, изменяющие модель.
После запуска variant BIMO возвращает ранее активный preset. Подробнее: Presets и Variants.
Примеры
Запустить Read-Only Проверку Модели
Подготовьте граф, читающий активный документ, и отметьте итоговую ноду как Is Output. Импортируйте inputs, сохраните preset и запустите его в нужном проекте. Проверьте или скопируйте результат.
Заполнить Параметры В Двух Конфигурациях
Сохраните отдельные presets для тестовых и production-значений параметров. Проверьте оба на копии модели до назначения production-preset на variant.
Экспортировать Данные
Используйте input node для пути экспорта и отметьте status node как Is Output. Убедитесь, что папка назначения существует и граф должен создавать или перезаписывать файлы.
Влияние На Модель И Систему
Граф выполняется с доступом к активной среде Revit/Dynamo.
Изменения модели, доступ к файлам, сетевые вызовы и поведение packages определяются графом и его нодами.
BIMO не показывает preview изменений и не оборачивает весь граф в гарантированный rollback.
Граф может частично изменить модель до сообщения об ошибке.
Поведение Undo зависит от Dynamo и используемых нод; не считайте весь запуск одной гарантированно обратимой операцией.
После начала фонового выполнения отмена со стороны BIMO недоступна.
Ошибки И Диагностика
Проблема | Что Проверить |
|---|---|
Dynamo is currently open with UI | Полностью закройте окно Dynamo и повторите запуск. |
Unsupported Revit version | Revit 2021–2022 блокируются metadata команды. Используйте подтверждённо поддерживаемую сборку. |
Run Dynamo не выполняется в Revit 2023 | Metadata и реализация расходятся; execution service для Revit 2023 не реализован. |
Файл скрипта не открывается | Проверьте существование пути, расширение .dyn и доступ для текущего Windows-пользователя. |
From Script не находит inputs | Сохраните граф после маркировки inputs, убедитесь, что .dyn открывается, и проверьте поддержку его структуры. |
Изменённый input не влияет на результат | ID ноды мог измениться или Dynamo мог отклонить строку. Снова выполните From Script и сравните данные с графом. |
Dropdown выбирает неверный пункт | Введите точное имя пункта Dynamo и проверьте граф вручную. |
Граф работает в Dynamo UI, но не здесь | Уберите UI-зависимые действия, проверьте packages и протестируйте граф в форме, совместимой с automatic/headless запуском. |
Ошибка отсутствующей ноды или package | Установите packages и custom nodes, необходимые графу для этой версии Revit/Dynamo. |
Окно результата не появляется | Добавьте ноду Is Output с непустым значением. Помните, что граф уже мог выполниться. |
После изменения модели граф сообщил об ошибке | Сразу проверьте модель. Сообщение об ошибке не гарантирует rollback прежних изменений. |
Известные Ограничения
Подтверждённая реализация выполнения сейчас начинается с Revit 2024, хотя metadata указывает Revit 2023.
Принимает один файл графа на preset и не проверяет файл до выполнения.
Работает в headless mode и не запускается при открытом интерфейсе Dynamo.
Не имеет BIMO progress display или отмены выполнения.
Встроенные inputs передаются строками и не предоставляют типизированные Revit object pickers.
Не сообщает отдельно о каждом неудачном обновлении input.
Не каждый warning или unsupported node считается блокирующей ошибкой.
Показывает значения только с Dynamo nodes, отмеченных как outputs.
Не гарантирует rollback после ошибки графа.