Принцип работы.

Tangl может связывать три части: внешнюю систему, облачный сервис Tangl Cloud и фермы с Autodesk Revit. Посредник в этом процессе — Координатор в Tangl Cloud, благодаря которому процесс обработки становится автоматическим.

Revit-ферма

Автоматическое преобразование моделей формата .rvt в формат Tangl, используя воркеры, осуществляется Revit-фермой.

Revit-ферма содержит:

1. Координатор : размещён в облачной инфраструктуре Tangl Cloud, управляет процессом запуска и мониторинга заданий на экспорт.
2. Агент Revit: представляет собой службу Windows, принимающую задачи от координатора и передающую их дальше на установленную копию Revit с плагином Tangl.
3. Плагин Tangl для Revit: обеспечивает взаимодействие с агентом и обработку поступающих задач на экспорт.

Схема Revit-фермы:

Процесс работы:

1. Внешняя система генерирует запрос на экспорт модели и направляет его в облачную инфраструктуру Tangl Cloud.
2. Координатор выбирает доступный свободный агент и назначает ему данную задачу.
3. Агент Revit получает задачу и переправляет её плагину Tangl для Revit, который выполняет непосредственное преобразование файла.
4. Завершив преобразование, плагин отправляет готовый файл обратно на сервер Tangl Cloud.

Установка и запуск агентов и воркеров для синхронизации моделей

Предварительно, для корректной работы системы синхронизации моделей с помощью Tangl необходимо наличие установленного плагина Tangl для Revit, установленного Агент Revit и настроенные воркеры Revit.

Воркер Revit: запущенный Revit с установленным и авторизованным плагином Tangl, который работает в режиме воркера. Его задача — конвертировать и обрабатывать экспортируемые модели по поручениям, полученным от Координатора, без участия пользователя в самой Revit-сессии.

Агент Revit — это служба, координирующая запущенные воркеры Revit на одном ПК.

Установка Агента Revit

1. Скачать установщик Tangl Revit Agent из Личного кабинета.
2. Запустить установщик с правами администратора:
   1. Нажать правой кнопкой мыши на загруженный файл установщика
   2. Выбрать в меню пункт «Запуск от имени администратора».

После установки в списке служб Windows появится служба TanglRevitAgent, которая будет запускаться автоматически при запуске ПК.

Настройка воркера Revit

Для настройки воркера Revit необходимо:

1. Установить плагин для Revit из личного кабинета, подробнее в статье Установка плагина для Revit.
2. Авторизоваться в плагине, выбрать необходимую компанию.
3. Открыть настройки плагина и отметить опцию Режим воркера.

1. Нажать «Ок» для сохранения изменений.
2. Revit подключится к Агенту и будет доступен для задач экспорта моделей.

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

Ошибки подключения

Если по какой-либо причине воркеру Revit не удалось подключиться к Агенту, или к Координатору, отобразится окно с информацией об ошибке. Для повторного подключения необходимо будет повторно зайти в настройки и повторно отметить опцию Режим воркера.

Если по каким-то причинам воркер Revit не смог подключиться к Агенту или Координатору, откроется окно с сообщением об ошибке. Для повторной попытки подключения следует снова открыть настройки плагина и заново отметить опцию Режим воркера.

Экспорт модели

При поступлении HTTP-запроса типа «Экспорт файла Х для компании Y» Координатор определяет, к какой компании он относится, проверяет наличие подключённых агентов для этой компании и, если агенты есть, направляет задание) одному из них.

Агентов может быть много: для разных компаний — свои наборы агентов.

Агент получает команду, скачивает модель по предоставленной ссылке, открывает её в плагине Tangl для Revit и выполняет экспорт. В процессе выполнения агент отправляет координатору прогресс: подтверждения скачивания, процент выполнения, успех или провал. По завершении агент отсылает модель в облако и отмечает задачу как успешно выполненную.

Ошибки при работе

Если обработка файла прошла неудачно (невозможно скачать файл, ошибка при обработке), задача помечается как завершённая с ошибкой и автоматически не перезапускается. Однако существуют сценарии автоматической постановки задачи в очередь заново:

• ­ Если агент недоступен в момент поступления задачи или сообщение не было принято агентом (потеря связи, закрытие приложения Revit).
• ­ Повторные проверки происходят каждые пять минут вплоть до появления подходящего агента или изменения состояния задачи.
• В случае разрыва соединения между агентом и координатором во время обработки задачи агент продолжает выполнение локально. Когда соединение восстанавливается, агент должен подтвердить завершение процесса и отправить итоговую модель. Таким образом, несмотря на временное отсутствие связи, задача считается завершённой после успешного подключения и отправки результата.

Интеграция с внешней системой (СОД)

Предполагается, что внешняя система представлена как СОД (Система общих данных) — информационная система, предназначенная для централизованного хранения, обработки и предоставления общей информации различным пользователям и организациям.

Пользователь может загрузить в СОД rvt-файл; однако СОД сам по себе не способен запустить Autodesk Revit и конвертацию — необходим плагин. Чтобы автоматизировать передачу файлов из СОД в Tangl, провайдер СОД должен создать для rvt-файла ссылку для скачивания и сообщить Координатору об этом по HTTP: идентификатор компании, модель, имя файла и ссылка на скачивание. Координатор заносит такую задачу и, когда у компании подключится агент, агент увидит задачу, перейдёт по ссылке, скачает rvt и попробует загрузить её в плагин Tangl для Revit.

Если файл формата IFC, то он будет обработан в фоновом режиме на сервере Tangl без участия пользователя.

Подробнее

API интерфейс для управления задачами экспорта Координатором (Export Farm Coordinator)Утилита командной строки Tangl Export Farm