Кнопка «Экспорт в Умную воду»

Что делает кнопка

По выбранной трубе плагин «обходит» всю связанную с ней сеть водоснабжения (трубы одной системы, фитинги, арматуру, сантехприборы), разбивает её на пронумерованные участки и пути (аналог расчётных участков сети), записывает эти номера и координаты прямо в модель Revit (в служебные параметры «…УВ – …»), и позволяет выгрузить всё это в CSV‑файл для внешнего сервиса «Умная вода» (расчёт/мониторинг систем водоснабжения). Дополнительно можно построить наглядный 3D‑вид сети с марками путей.

Подготовка моделей

1. В модель, из которой будут экспортироваться данные, должны быть подгружены все связи, которые необходимы для полной схемы системы.
2. Все модели, участвующие в экспорте с помощью плагина должны иметь одинаковые экспортируемые типы систем трубопроводов: с одинаковым сокращением и классификацией.
3. Системы не должны иметь разрывов, все коннекторы должны быть соединены, если они не конечные.
4. На концах участков систем должны находиться конечные сантехприборы, если их необходимо экспортировать в “Умную воду”.
5. Участки труб, переходящие в систему связи Revit должны быть полностью соосны и совпадать по окончанию в вашем файле и началу в файле связи.
6. Подготовьте вид, на котором будет видна только та система, которую собираетесь экспортировать: можете ограничить фильтром по параметру Имя системы или …Тип системы.

Шаг 1: выбор трубы

После нажатия кнопки нужно выбрать в модели одну трубу — с неё начнётся обход сети («Выберите трубу, с которой начинается сеть для экспорта в Умную воду»). Если выбрать не трубу — команда покажет предупреждение и завершится.

Шаг 2: проверка параметров

Плагин проверяет наличие 13 служебных параметров с префиксом «…УВ – » (ID участка, ID пути, ID старшего участка, координаты начала/конца по X/Y/Z, количество водопотребителей, стандарт‑GUID/имя, наименование прибора, точка начала) и при необходимости добавляет их в проект. Часть параметров — экземпляра (у труб/гибких труб), часть — параметры типа (у арматуры/приборов, например «…УВ – Стандарт – GUID»/«…УВ – Наименование прибора»). Если добавить не получилось (например, нет нужного параметра в подключённом ФОП) — показывается ошибка со списком проблемных параметров, и команда прерывается.

Выбранной трубе сразу проставляется отметка «Точка начала» в параметр «…УВ – Точка начала» — это видимый в модели признак, откуда именно был начат обход сети в последний раз.

Шаг 3: анализ сети и открытие окна «ИНФОРМАЦИЯ О СИСТЕМЕ»

Плагин проходит сеть от выбранной трубы во все стороны (по трубам и через фитинги/арматуру), пока не закончатся трубы той же инженерной системы (системы различаются по её сокращению — параметр «Сокращение системы» самой трубы). Каждая пройденная труба становится одной строкой‑«участком»:

• Id — порядковый номер участка (сквозной, начиная с 1);
• ParentId — Id участка, из которого пришли в этот («-» для самого первого);
• RouteId («путь») — см. ниже, как формируются номера путей;
• координаты начала/конца участка в мм (относительно внутренней, не общей, базовой точки проекта) — причём в местах, где труба проходит через фитинг (отвод, тройник), берётся не точка коннектора, а вычисленная точка пересечения осей труб в этом узле — это точнее для последующих расчётов;
• прибор на конце участка (если есть) и список прочих фитингов/арматуры на этом участке (для справки).

По завершении обхода открывается окно «ЭКСПОРТ В УМНУЮ ВОДУ» с сводкой — это своего рода панель предпросмотра и управления, из которой доступны все дальнейшие действия.

Как нумеруются «пути» (Route)

Путь — это условная группировка последовательных участков одного характера, похожая на разбивку сети на расчётные ветки:

• Магистраль/основной путь («Main») — номера 1–20; при разветвлении путь «продолжается» с тем же номером у той трубы, что идёт наиболее прямо (по направлению) от предыдущей, а остальные ответвления получают новый номер (не выше 20).
• Стояк («Riser») — труба (и все жёстко соединённые с ней вертикальные трубы) считается стояком, если она вертикальна и суммарная высота вертикального участка ≥ 3 м; стоякам присваиваются номера начиная с 21.
• Разводка после стояка («Distribution») — как только путь после стояка снова идёт горизонтально, начинается новая нумерация с 100, с той же логикой «прямое продолжение — тот же номер, ответвление — новый».

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

В сводке могут появиться два типа предупреждений (с кнопкой «Выделить», которая подсвечивает нужные элементы в модели):

• «К выбранной системе подключена система ‹X›. Место подключения — ID ‹N›.» — рядом с обходимой сетью физически подключена труба другой системы (другое сокращение системы) — например, случайно соединили разные сети.
• «Элементы не подключенные к системе: количество N. Количество участков с рассоединением: M.» — рядом (ближе всего к обойдённой сети) найдены трубы той же самой системы, которые физически не подключены к пройденной сети — то есть похоже на разрыв/недомоделированный стык в той же системе.

Кнопки окна «ЭКСПОРТ В УМНУЮ ВОДУ»

«Обновить из Revit»

Заново обходит сеть от той же начальной трубы (учитывая любые изменения в модели с момента открытия окна), обновляет параметры на трубах и сводку в окне. Файл при этом не создаётся — это просто актуализация данных перед экспортом.

«Заполнить параметр»

Позволяет заново заполнить параметры участков/путей без экспорта в файл, и при этом выбрать, с какого номера начинать нумерацию:

• «С номера 1» — обычная нумерация с начала.
• «Выбрать связь» — нужно выбрать трубу (или изоляцию трубы) в связанном файле, к которой подключается текущая система; тогда нумерация участков и путей продолжится от максимальных номеров, уже использованных в системе связанного файла (а первый участок получит родителем участок связи, к которому подключились) — удобно, если сеть моделируется по частям в разных файлах и нужно, чтобы номера не пересекались.

«Выбрать связи»

Открывает выбор элементов в связанных файлах — можно указать трубы (или изоляцию труб) из связей, вниз по течению от которых тоже нужно учесть сеть при экспорте. Выбранные трубы отображаются в таблице «Выбранные трубы из связей» внизу окна. При экспорте в CSV плагин обходит сеть и в каждой такой связи, аккуратно продолжая нумерацию участков/путей от основной модели (при конфликте номеров между связями — перенумеровывает строки из связей заново, о чём выдаст предупреждение) и подключая их к ближайшему участку основной сети по расстоянию между открытыми концами труб.

«Построить 3D вид»

Создаёт новый закреплённый 3D‑вид (изометрию), называет его по имени системы, и если в проекте есть вид‑шаблон с именем «ВК – Рабочие виды – Умная вода» — применяет его. Дополнительно пытается расставить по одной марке на трубу каждого уникального пути («марки путей»), используя специальное семейство марки труб для Умной воды — если такого семейства ещё нет в проекте, плагин попробует загрузить его с диска.

«Экспорт в CSV»

Спрашивает, куда сохранить .csv‑файл (по умолчанию имя вида «‹ИмяФайлаRevit›_smartwater_export‑ГГГГММДДЧЧММСС.csv»), формирует итоговый список строк (участки основной сети + участки из выбранных связей) и сохраняет. После сохранения автоматически открывается папка с файлом в Проводнике. Показывается итоговое сообщение с числом участков (и отдельно — сколько из них из связей) и списком предупреждений, если они есть.

Формат CSV: разделитель ;, кодировка Unicode (UTF‑16), первая строка — заголовки колонок: Begin.X, Begin.Y, Begin.Z, End.X, End.Y, End.Z, ParentId, Id, Equip, SystemName, Route_Id, Num_consumer, Cons_type, Eq_name, Num_equipment, Other_equipment.

Сводка в окне

• Имя системы — сокращение системы обойдённой сети.
• Количество участков — число строк (труб), попавших в сеть.
• Количество путей — число уникальных номеров путей.
• Диктующая ветка — путь от начала сети до самой удалённой (по суммарной длине участков) точки сети, показан как цепочка номеров путей через дефис — ориентир на самую протяжённую/нагруженную ветку сети.
• Приборы — таблица приборов на этой сети, сгруппированных по наименованию (параметр «…УВ – Наименование прибора» или, если он пуст, «…УВ – Стандарт – Имя»), с количеством. Приборы без этих параметров попадают в отдельную строку «Ошибка! Не заполнены параметры …УВ» — сигнал, что у таких приборов нужно проверить и заполнить типовые параметры.
• Выбранные трубы из связей — что было выбрано кнопкой «Выбрать связи».

Требования и подготовка

• В подключённом ФОП должны быть все параметры «…УВ – …», иначе автодобавление не сработает.
• У труб системы должно быть корректно заполнено «Сокращение системы» — по нему определяются границы обходимой сети и распознаются «чужие»/несвязанные участки.
• Сантехприборы/точки водопотребления должны иметь заполненные параметры «…УВ – Количество водопотребителей», «…УВ – Стандарт – GUID/Имя», «…УВ – Наименование прибора» — иначе они попадут в сводку как «Ошибка! Не заполнены параметры …УВ», а в CSV эти поля останутся пустыми.
• Для 3D‑вида с марками путей нужен либо уже загруженный в проект вид‑шаблон «ВК – Рабочие виды – Умная вода» и семейство марки труб для Умной воды, либо готовность к тому, что вид создастся без марок.