Если инженер каждый раз выбирает одну и ту же спецификацию, переносит столбцы и исправляет выгрузку, задачу можно описать как одну повторяемую операцию. При заказе плагина для Revit мы предлагаем начать с её входных данных и эталонного результата. Так BIM-руководитель сможет сравнить предложения подрядчиков и проверить пилот: пробную версию одной операции на копии своей модели.
Ниже разберём, что передать разработчику, какие ограничения API проверить и как принять результат. В центре проверки будут состав выгрузки, разрешённые изменения модели, отмена и журнал ошибок. В статье есть короткое ТЗ и матрица «до / после», которые можно заполнить для своего бюро.
Выберите операцию, результат которой можно сверить
Формулировка «автоматизировать Revit под проектное бюро» оставляет слишком много вариантов. Для первого задания полезнее назвать действие инженера: выгрузить выбранную спецификацию в шаблон, заполнить конкретный параметр у отобранных элементов или найти нарушения одного правила модели.
Например, бюро нужна ведомость оборудования в согласованном файле. Сначала проверим штатный экспорт: Revit 2026 экспортирует спецификации в текстовый файл с разделителями, который можно открыть в Excel. Если этого достаточно, заказная разработка может оказаться лишней. Плагин имеет смысл оценивать, когда к выгрузке добавляются правила вашего бюро: выбор полей, оформление, сопоставление кодов или проверка обязательных данных.
Одна операция для пилота: сотрудник выбирает спецификацию, плагин проверяет её по согласованным правилам, сохраняет файл и показывает отчёт. Создание новых видов, исправление параметров и отправка в 1С получают отдельные требования.
Плагин проверки BIM-модели тоже требует конкретного правила. Можно начать с поиска оборудования без согласованного кода и отчёта по найденным элементам. Автоматическое исправление добавляет другой объём работ: нужно определить новое значение, права на запись и последствия для связанных данных.
Проверьте версию и доступность API до оценки
В ТЗ запишите год выпуска и установленное обновление Revit, язык интерфейса, способ установки плагина и список рабочих мест. Передайте копию модели с нужными семействами и параметрами. Обезличивание должно сохранить связи и особенности, на которых строится операция.
API — программный доступ к возможностям Revit. Подрядчик должен показать, какими методами он прочитает данные и выполнит выбранное действие в вашей версии. Например, ViewSchedule.Export в API 2026 сохраняет данные спецификации в текстовый файл. Готовый XLSX с вашим оформлением потребует отдельного формирования файла и проверки формата.
Обычный плагин загружается внутрь Revit. Autodesk описывает доступ к API через главный поток Revit. Для окна, которое остаётся открытым во время работы, разработчик должен отдельно объяснить, как передаёт команды в допустимый контекст API. Само наличие окна ещё не доказывает корректность доступа к модели.
В проверку среды включаем доступную лицензированную установку, права пользователя, условия использования и распространения расширения. Поддержку нескольких версий фиксируем списком и проверяем на каждой: Autodesk предупреждает о частичной совместимости API между основными выпусками. Обновление Revit должно иметь свой порядок проверки плагина.
Короткое ТЗ: выгрузка одной спецификации
Ниже демонстрационный пример задания. Он задаёт границы чтения и выгрузки; реальные имена параметров, единицы и шаблон нужно взять из модели бюро. Для начала можно заполнить эту таблицу и приложить правильный результат, который инженер собрал вручную.
| Поле ТЗ | Что зафиксировать |
|---|---|
| Операция и запуск | Выгрузить выбранную ведомость оборудования по команде пользователя. Назвать допустимые виды спецификаций и правило выбора. |
| Входные данные | Копия контрольной модели, версия Revit, идентификатор спецификации, шаблон файла и пример правильной выгрузки. |
| Правила данных | Столбцы, единицы, округление, сортировка, группировка и итоги. Для параметров указать способ идентификации, принадлежность типу или экземпляру и поведение при пустом значении. |
| Границы | Чтение согласованной спецификации без изменения элементов, параметров и видов модели. Данные связанных моделей включать только по отдельному правилу. |
| Файл и отмена | Формат, каталог и права записи. Существующий файл заменять только с подтверждением. При отмене сохранить старый файл; неполную выгрузку не выдавать за готовую. |
| Ошибки | Нет поля, выбрана неподходящая спецификация, каталог недоступен или файл занят. Согласовать остановку и понятную причину для каждого случая. |
| Результат сотруднику | Путь к файлу, число выгруженных строк, список предупреждений и сведения о запуске. Инженер понимает, можно ли передать файл дальше. |
Скриншот ведомости помогает обсудить оформление. Состав строк, единицы и итоги сверяем по контрольной модели и эталонному файлу. Например, две строки с одинаковым названием могут относиться к разным типам оборудования: правило объединения должен подтвердить BIM-руководитель.
Если команда меняет модель: транзакция и отмена
Для заполнения параметров или изменения элементов понадобится отдельное задание на запись. Допустим, нужно заполнить согласованный код у выбранного оборудования. До запуска фиксируем набор элементов, исходные значения, источник новых кодов и поля, которые разрешено менять. Изменение параметра типа проверяем особенно внимательно: оно может затронуть другие экземпляры этого типа.
Транзакция объединяет изменения модели в управляемую операцию. В Revit API изменения документа выполняются внутри открытой транзакции. Чистая проверка или выгрузка без записи в модель такого изменения не требует; для внешней команды предусмотрен режим ReadOnly.
Подрядчик должен проверить итог завершения транзакции. Commit, команда фиксации изменений, может завершиться откатом или ожиданием действий пользователя. Пока результат не определён, сообщение «Готово» преждевременно. Для отказа до фиксации изменений предусмотрен RollBack, команда отката; его завершение тоже нужно проверить.
После успешной записи отдельно проверяем Undo, штатную отмену в Revit. Согласуем, сколько действий потребуется и какие значения восстановятся. Если команду разбили на несколько транзакций, их объединение в один пункт Undo требует отдельного решения, например TransactionGroup.Assimilate. На приёмке выполняем отмену и повторный запуск.
Внешний результат проверяем отдельно. Откат транзакции Revit относится к изменениям модели. Для созданного файла или уже переданного сообщения в 1С нужно собственное правило отмены и восстановления. Запись в модель и отправку наружу нельзя считать одной общей отменяемой операцией без проверки каждого направления.
Неполные данные и совместная работа
Добавьте в контрольную модель элементы с пустым параметром, неподходящим типом и ограничением записи. Закреплённый элемент тоже полезен для проверки, если операция меняет его положение; закрепление само по себе не означает запрет на любые изменения параметров. Для каждого случая заранее выберите результат: остановить весь запуск или пропустить элемент и явно включить его в отчёт.
В совместной модели, где несколько инженеров работают с общими данными, нужен сценарий занятого элемента. GetCheckoutStatus возвращает локально сохранённые сведения о владении. Они могут устареть и сами по себе не гарантируют возможность немедленной записи. Поэтому проверяем реальный отказ при изменении и согласованное поведение команды.
Например, один элемент недоступен, а остальные подходят. При правиле «всё или ничего» результатом будет отказ без частичного изменения модели. При разрешённых пропусках инженер увидит, что изменено, что пропущено и по какой причине. Эти два варианта дают разный рабочий результат и должны быть явно отражены в ТЗ.
Журнал запуска связывает результат с версией плагина, моделью, временем, выбранной операцией и идентификаторами элементов. Для записи сохраняем согласованные значения до и после; для выгрузки — состав и место сохранения файла. Доступ к журналу и срок хранения определяем вместе с бюро, особенно если в данных встречаются сведения о проекте.
Матрица приёмки «до / после»
Каждую проверку начинаем с известного состояния копии модели. BIM-руководитель подтверждает ожидаемый результат, профильный разработчик выполняет команду, затем сверяем данные и журнал. Скорость измеряем в среде бюро на согласованном объёме, когда уже подтверждена правильность операции.
| Сценарий | До запуска | После запуска |
|---|---|---|
| Обычная выгрузка | Известная спецификация, эталон строк и итогов. | Файл совпадает с согласованными данными; модель не изменена. |
| Неполные данные | Отсутствует обязательное поле или значение. | Согласованный отказ или предупреждение; проблема названа, готовность файла не скрывает пропуски. |
| Файл занят / отмена выгрузки | В каталоге есть правильный предыдущий файл. | Предыдущий файл сохранён; неполный результат не выдан как готовый. |
| Запись в модель | Согласованы элементы и значения параметров. | Изменены только разрешённые данные; связанные изменения сверены с границами ТЗ. |
| Занятый элемент / ошибка записи | Один элемент недоступен, выбран режим «всё или ничего». | Изменения операции откатились; причина и итог отражены в журнале. |
| Undo и повтор | Запись успешно завершена, исходные значения сохранены для сверки. | Undo восстанавливает согласованное состояние; повторный запуск даёт предусмотренный результат без лишних изменений. |
В комплект приёмки включаем установочный пакет, перечень поддерживаемых версий, инструкцию запуска, контрольную модель, эталон результата и отчёты проверок. Передачу исходного кода, порядок исправлений и обновления для следующего выпуска Revit закрепляем в договорённостях.
Связь с номенклатурой 1С начинается с сопоставления
Для интеграции Revit с 1С сначала определим, что передаём: потребность из спецификации, код номенклатуры или сведения для другого процесса. Затем выберем источник каждого значения и правило связи элементов с учётной системой. Одинаковое название оборудования ещё не задаёт надёжное соответствие: нужно согласовать код, единицу измерения и обработку неоднозначных совпадений.
В «Бакаеве» мы связали приложение, админ-панель и 1С через сервер синхронизации. Замена фотографии в админ-панели отражается в 1С, заказ из приложения меняет остатки в обеих системах, а изменения из 1С доходят до приложения. Для модели Revit предлагаем отдельно спроектировать сопоставление и сверку вместе с профильными специалистами по Revit и конфигурации 1С.
Перед оценкой проверяем доступный интерфейс 1С, права и сетевую среду. На пилоте полезно передать одну согласованную позицию, затем проверить неизвестный код, расхождение единиц и повтор после пропавшего ответа. Результат должен показывать, что приняла учётная система и какие позиции требуют решения сотрудника.
Сравнивайте стоимость по составу работ
Смета разработки плагина Revit складывается из проверки API, правил операции, интерфейса, обработки отказов, установки и приёмки. Поддержка нескольких версий и обмен с 1С добавляют свои проверки. Обоснованная оценка появляется после разбора модели и границ первой версии.
Например, два предложения на «выгрузку в Excel» могут включать разную работу. В одном есть только сохранение данных, в другом — шаблон бюро, проверка полей, отчёт ошибок, установка на рабочие места и проверка обновлений. Сопоставьте эти результаты по одной таблице ТЗ, прежде чем сравнивать суммы.
При выборе исполнителя попросите показать профильную компетенцию: пример команды на нужной версии, способ работы с API, отмену и отказ на тестовой модели. Согласуйте, кто отвечает за Revit, правила BIM и 1С. В 13FOX мы предлагаем начать с предпроектного разбора операции и критериев пилота; состав исполнителей согласуем по подтверждённой компетенции.
Перед заказом плагина
Можно начать без готового ТЗ?
Да. Опишите одну повторяемую операцию, укажите версию Revit и подготовьте обезличенную контрольную модель с примером правильного результата. По этим данным можно собрать требования и критерии пилота.
Нужен ли плагин для любой выгрузки спецификации?
Сначала проверьте штатный экспорт. Заказное расширение стоит оценивать, когда нужны правила отбора, оформление, проверки или обмен, которые выходят за ваш текущий рабочий сценарий.
Будет ли плагин работать во всех версиях Revit?
Поддерживаемые версии нужно перечислить и проверить отдельно. В ТЗ включите установку, контрольную операцию и порядок проверки после обновления Revit.
Как проверить связь с 1С до большого проекта?
Согласуйте одну позицию, её код и единицу, источник значений и направление обмена. Проверьте успешную передачу, неизвестный код, расхождение единиц и повтор после сбоя на доступном интерфейсе вашей конфигурации.
Разберём одну операцию Revit
Пришлите одну операцию, версию Revit и обезличенную контрольную модель. Разберём требования к профильному пилоту, проверку API и критерии результата; состав исполнителей согласуем по подтверждённой компетенции.
Оставьте контакт и краткое описание операции. Способ передачи модели согласуем при обсуждении.