Run Python

После запуска команды пользователь может ввести собственный Python-скрипт. Скрипт будет выполнен в контексте активного документа Revit. Ниже описано, как настроить и запустить скрипт с доступом к объектам Revit API.

• Execution Engine :

  Execution Engine :

  Выберите между IronPython и Dynamo_CPython3. IronPython предоставляет доступ к глобальным переменным Revit, таким как __doc__ и __uidoc__. В режиме Dynamo_CPython3 эти переменные недоступны, скрипт выполняется аналогично Python-узлу в Dynamo.

  Выберите между IronPython и Dynamo_CPython3. IronPython предоставляет доступ к глобальным переменным Revit, таким как __doc__ и __uidoc__. В режиме Dynamo_CPython3 эти переменные недоступны, скрипт выполняется аналогично Python-узлу в Dynamo.

• Script file :

  Script file :

  Необязательный путь к файлу скрипта. Если поле Script пустое, будет использован код из указанного файла.

  Необязательный путь к файлу скрипта. Если поле Script пустое, будет использован код из указанного файла.

• Script :

  Script :

  Введите Python-скрипт, который нужно выполнить. Оба движка поддерживают использование переменных IN (входные данные) и OUT (выходной результат). Код будет выполнен либо из этого поля, либо из указанного файла, если поле пустое.

  Введите Python-скрипт, который нужно выполнить. Оба движка поддерживают использование переменных IN (входные данные) и OUT (выходной результат). Код будет выполнен либо из этого поля, либо из указанного файла, если поле пустое.

• IN :

  IN :

  Список строк, передаваемых в скрипт. Эти значения доступны через переменную IN.

  Список строк, передаваемых в скрипт. Эти значения доступны через переменную IN.

В зависимости от выбранного движка исполнения доступны следующие переменные:

• IN :

  IN :

  Список входных строк, указанных в настройках. Доступен как в IronPython, так и в Dynamo_CPython3.

  Список входных строк, указанных в настройках. Доступен как в IronPython, так и в Dynamo_CPython3.

• OUT :

  OUT :

  Переменная, в которую необходимо записать результат выполнения скрипта. Этот результат будет отображен по завершении.

  Переменная, в которую необходимо записать результат выполнения скрипта. Этот результат будет отображен по завершении.

• __doc__ :

  __doc__ :

  Доступна только при использовании IronPython. Представляет активный объект Document.

  Доступна только при использовании IronPython. Представляет активный объект Document.

• __uidoc__ :

  __uidoc__ :

  Доступна только при использовании IronPython. Представляет объект UIDocument для взаимодействия с пользовательским интерфейсом.

  Доступна только при использовании IronPython. Представляет объект UIDocument для взаимодействия с пользовательским интерфейсом.

• __revit__, __uiapp__ :

  __revit__, __uiapp__ :

  Также доступны только в IronPython. Обеспечивают доступ к объекту UIApplication и контексту Revit-приложения.

  Также доступны только в IronPython. Обеспечивают доступ к объекту UIApplication и контексту Revit-приложения.

После настройки скрипта и входных значений нажмите кнопку "ОК", чтобы запустить выполнение. Результат будет показан в отдельном диалоговом окне.

• Вывод результата :

  Вывод результата :

  Чтобы вернуть результат, присвойте значение переменной OUT. Например:

  OUT = "Обработано элементов: {0}".format(element_count)

  Это сообщение будет отображено в окне результата.

  Чтобы вернуть результат, присвойте значение переменной OUT. Например:

  OUT = "Обработано элементов: {0}".format(element_count)

  Это сообщение будет отображено в окне результата.

После успешного выполнения результат, указанный в OUT, отобразится в диалоговом окне. В случае ошибки будет показано сообщение с деталями и трассировкой.