Get Linked Element ID — документация BIMO

Get Linked Element ID позволяет выбрать один элемент внутри загруженной связи Revit и получить его числовой Element ID из связанного документа.

Текущая доступность: команда зарегистрирована в разделе BIMO > Manage, но скрыта в стандартной схеме Ribbon. Она появляется только при включении через тариф, рабочее пространство или брендированную конфигурацию панели. Если команды нет, обратитесь к администратору BIMO или напишите на support@bimo.tools.

Когда использовать

Получить ID объекта из связанной модели для координации или отладки.
Передать идентификатор коллеге вместе с названием связанного файла.
Подготовить значение для команды Find Linked Element.
Проверить, какой именно элемент связи был выбран в хост-модели.

Требования

Должен быть открыт проект Revit.
В проекте должна присутствовать загруженная связь Revit.
Нужно выбрать именно элемент внутри RVT-связи, а не экземпляр связи, объект хост-модели или CAD-связь.

Порядок работы

Запустите Get Linked Element ID.
В строке состояния Revit появится приглашение Pick an element inside a link.
Щёлкните один элемент внутри загруженной связи Revit.
BIMO покажет окно результата в формате:
Linked Element ID: 123456
Нажмите Copy output to clipboard, чтобы скопировать весь текст результата, либо закройте окно.

Клавиша Esc отменяет выбор и завершает команду без изменений.

Что именно возвращается

Команда использует Reference.LinkedElementId, поэтому возвращаемое число относится к элементу внутри связанного документа.

Это значение:

не является ID экземпляра RevitLinkInstance в хост-модели;
не является UniqueId;
не определяет, какой экземпляр одной и той же связи был выбран, если файл вставлен несколько раз;
имеет смысл только вместе с контекстом связанного файла.

Для последующего поиска укажите этот ID в Find Linked Element, а затем выберите нужный экземпляр связи.

Результат и влияние на модель

Команда не открывает транзакцию и не изменяет элементы модели.
Команда обрабатывает только один выбранный элемент за запуск.
Настроек, presets и variants у команды нет.
В сборках для Revit 2023 и новее выбранная ссылка дополнительно устанавливается как текущий выбор Revit.
В более ранних версиях Revit команда только показывает ID; отсутствие подсветки после выбора является ожидаемым поведением.

Изменение текущего выбора в Revit 2023+ не меняет геометрию или параметры модели и не требует Undo.

Предупреждения

Записывайте вместе с ID название связанного файла или модели. Само число недостаточно для однозначной координации между разными документами.
Если одна модель вставлена несколько раз, команда возвращает одинаковый ID элемента независимо от выбранного экземпляра связи.
Команда не копирует число автоматически: используйте ссылку Copy output to clipboard в окне результата.
Команда не выполняет поиск элемента и не создаёт 3D-вид. Для этого используйте Find Linked Element.

Устранение проблем

Проблема	Что проверить
Команда отсутствует на панели	Она скрыта в стандартной Ribbon-схеме. Проверьте тариф, рабочее пространство или брендированную конфигурацию.
Не удаётся выбрать объект	Убедитесь, что щёлкаете элемент внутри загруженной RVT-связи, а не экземпляр связи или элемент хост-модели.
Нажатие Esc закрывает команду	Это ожидаемая отмена выбора; модель не изменяется.
Получен ID не того объекта	Повторите запуск и приблизьте вид перед выбором элемента внутри связи.
После выполнения элемент не остаётся выделенным	Автоматическая установка выбора реализована только для Revit 2023 и новее.
Нужно найти элемент по полученному числу	Запустите Find Linked Element, введите ID и выберите правильный экземпляр связи.
Нужно только число без префикса	Скопируйте результат и удалите текст `Linked Element ID:` вручную.

Известные ограничения

За один запуск можно получить ID только одного элемента.
Выбор ограничен элементами внутри связей Revit.
Команда не показывает имя связанного файла, тип элемента, категорию или UniqueId.
Команда не сохраняет историю ранее полученных значений.
Контекст экземпляра связи не включается в вывод.