Autodesk Revit 2019-2025.

Установите модуль «ИОС (общее) - Revit» в PikToolsBOX
Подробнее об установке на странице PikTools

Плагин решает задачу массового обновления атрибутивных данных элементов в модели Revit.
Основная проблема:
 При работе над проектом возникает необходимость заменять производителя, артикул или другие параметры у тысяч однотипных элементов. Ручное изменение каждого элемента занимает много времени и приводит к ошибкам.
Что делает плагин:
 Инструмент автоматически заменяет значения параметров у элементов массово или выборочно, при этом сами семейства остаются неизменными. Логика подбора производителей из каталога и их привязка к элементам настраивается в таблице-конфигураторе.
Для каких элементов применяется:
 Плагин работает со всеми категориями элементов Revit, которые имеют заполняемые параметры экземпляра. Это могут быть трубы, воздуховоды, кабельные лотки, арматура, оборудование и любые другие элементы.

Ключевые сценарии использования:

1. Изменение поставщика на этапе рабочей документации
Заказчик решил сменить поставщика оборудования. Плагин обновляет все элементы за несколько минут.

2. Актуализация данных по итогам тендера
 После выбора победителя тендера необходимо проставить артикулы и производителей в соответствии с договором.

3. Переход на единый стандарт наименований
 Инструмент приводит значения параметров к единому формату по всей модели.

Плагин записывает значения параметров для элементов модели двумя способами:

1. Сопоставление значений

• Плагин сравнивает исходные значения параметров в семействе с выбранными пользователем
• Замена происходит при наличии настроенного сопоставления в таблице-конфигураторе

2. Прямое назначение

• Пользователь выбирает требуемых производителей без сопоставления
• Выбранные производители должны присутствовать в таблице-конфигураторе

Перед запуском убедитесь в выполнении условий:

1. Завершите моделирование всех элементов, которые станут основой для работы плагина
2. Создайте конфигурационную таблицу с правилами
3. Проверьте наличие параметров на моделируемых категориях (параметры задаются в конфигурационной таблице)
4. Убедитесь, что параметры изменяются по экземплярам группы

Правила в конфигурационной таблице содержат два блока информации:

Блок 1: Фильтрация для уникальных групп

Диапазон: столбцы от A до столбца с наименованием «Сопоставление» включительно.
 Столбцы определяют, какие элементы необходимо обработать.

1. Пользовательское имя группы 
Объедините схожие элементы в логические группы. Это имя отобразится в главном окне плагина, см. пункт Интерфейс.
2. Заголовки 
Укажите обобщенное название для групп элементов. Один заголовок может объединять несколько пользовательских групп. Заголовки отобразятся в главном окне плагина, см. пункт Интерфейс.
3. Категория 
Укажите категорию элементов Revit. При запуске инструмента происходит проверка, работает ли инструмент с указанной категорией и имеются ли экземпляры этой категории в модели. Все категории, с которыми будет работать плагин, укажите на отдельном листе таблицы "Обрабатываемые категории".
4. Фильтры 
Все столбцы после "Категория" до столбца "Сопоставление" являются фильтрами. В фильтрах могут быть любые параметры, и их количество не ограничено. Для фильтров поддерживается символ * (звездочка):

• Если указано только *, подойдет любое значение.
• Если * в начале, в конце или значение между двумя *, будет выполняться поиск по части значения (например ВР*, *К, *-200-*)

5. Сопоставление 
В столбце "Сопоставление" выберите режим работы, записав «Да» или «Нет»:
- Режим "Да" означает, что перед назначением нового производителя будет производиться сравнение с текущим значением в модели. Данный режим полезен, когда выборка элементов слишком большая и создать конкретные фильтры неудобно — проще сопоставить старые значения с новыми.
- Режим "Нет" означает, что исходное значение производителя у элемента в модели не важно, будет назначен любой выбранный производитель при условии, что он есть для этой группы в таблице-конфигураторе.

Блок 2: Наборы производителей и параметров 

Диапазон: от столбца «C1» до столбца «Конец» включительно.
Второй блок разделен на наборы, каждый из которых представляет собой группу параметров и значений, соответствующих одному производителю. Создавая новые наборы, вы формируете каталог производителей, из которого в дальнейшем будете выбирать нужного производителя в интерфейсе плагина.

Правила создания наборов:

1. Каждый новый набор начинается со столбца, содержащего букву "С" (C1, C2, C3 и т.д.). Записывайте названия наборов строго по порядку, не пропуская номера.
2. Сразу за столбцом с буквой «С» должен располагаться столбец с наименованием производителя. Именно эти значения формируют выпадающие списки в главном окне плагина (подробнее см. пункт Интерфейс).

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

3. После столбца с производителем вы можете добавить любое количество дополнительных параметров в любом порядке.
4. Перечень дополнительных параметров должен быть одинаковым в каждом наборе (порядок и названия столбцов должны совпадать во всех наборах).
5. Количество наборов не ограничено до столбца «Конец».

Важно:
В выпадающий список в главном окне плагина попадает только столбец с наименованием производителя (например BS_Изготовитель). Остальные параметры (например, BS_Артикул) становятся доступными для выбора в дополнительном окне выбора параметров, см. пункт Интерфейс.

Дополнительные листы в таблице-конфигураторе

Лист "Производители"
Заполните список допустимых производителей на данном листе. Инструмент проверяет соответствие производителей этому списку и предотвращает ошибки написания и дублирование. Для удобства на листе "Сопоставление значений" в ячейках с производителями настроены выпадающие списки, сформированные из данных этого листа. 

Лист "Обрабатываемые категории"
Определите перечень категорий элементов, с которыми будет работать плагин. Выбор категорий зависит от дисциплины и потребностей проекта. При запуске инструмент проверяет наличие указанных категорий в модели и на листе "Сопоставление артикулов".

Лист "Сопоставление параметров"
Используйте данный лист в двух случаях: когда невозможно заполнить параметры для анализа или когда необходимо намеренно заменить исходные параметры на другие. Правила сопоставления с этого листа отображаются в интерфейсе в окне выбора параметров.

Основное окно содержит:

1. Выпадающий список – выбор производителя для каждой группы элементов
2. Флажок «Свернуть/развернуть всё» – переключение режима отображения списка
3. Режим обработки – вся модель, видимые элементы, выбранные элементы
4. Кнопка «Выбрать таблицу» – загрузка конфигурационной таблицы
5. Кнопка «Экспортировать настройки» – сохранение выбранных производителей в файл JSON
6. Кнопка «Загрузить настройки» – импорт ранее сохраненного файла JSON
7. Кнопка «Выбрать параметры для заполнения»

– список параметров для заполнения (по умолчанию только "Изготовитель")

1. Запустите плагин
Нажмите на вкладку PikTools - панель ИОС Общее – кнопка Назначить производителя. Запуск плагина осуществляется с любого вида

2. Выберите конфигурационную таблицу
Нажмите кнопку "Выбрать таблицу", укажите полный путь к файлу .xlsx. Путь сохраняется для последующих запусков

3. Назначьте производителей
Вернитесь в главное окно и в выпадающих списках выберите новых производителей для каждой уникальной группы элементов. После выбора хотя бы одного производителя кнопка "Запустить" станет активной

4. Настройте параметры заполнения
В главном окне нажмите "Выбрать параметры для заполнения" и выберите параметры для заполнения (список формируется из наборов в конфигурационной таблице)

5. Сохраните настройки (опционально)
После выбора производителей для групп элементов нажмите "Экспортировать настройки", укажите имя файла и сохраните JSON-файл. Для загрузки ранее сохраненных настроек нажмите "Загрузить настройки"

6. Выберите режим работы

• Вся модель – обработка всех элементов
• Видимые элементы на виде – обработка только видимых на активном виде
• Выбранные элементы – обработка предварительно выбранных элементов

7. Запустите обработку
Нажмите кнопку "Запустить" и дождитесь завершения выполнения

8. Проанализируйте результаты
Проверьте элементы, попавшие в итоговое окно, при необходимости скорректируйте настройки и повторите запуск