Бакеты и модели

На этой странице описан повседневный сценарий загрузки 3D-модели в MyCompany, чтобы её можно было показать на проекте, спецификации или производственном заказе. Настройка учётных данных рассматривается отдельно на странице Настройка.

Отдельная страница Autodesk расположена по пути Справочники → Autodesk. Страница состоит из трёх областей:

• селектор Бакета сверху;
• список моделей (с действиями загрузки / преобразования) и рядом с ним таблицу представлений выбранной модели;
• панель деталей с деревом элементов и 3D-просмотрщиком.

Бакеты

Бакет — это контейнер хранилища Autodesk Platform Services. Все ваши исходные файлы (Revit, IFC, DWG, NWD, …) находятся внутри одного или нескольких бакетов.

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

Ключи бакетов глобально уникальны в рамках всего APS, а не только вашего тенанта. Если вы попытаетесь создать бакет с именем models или test, скорее всего получите 409 Conflict — Bucket already exists, потому что этот ключ уже занят кем-то другим в APS. Используйте префикс, привязанный к тенанту, например mycompany-prod-models.

Создание бакета

Бакеты ведутся на вкладке «Объекты» формы integrations (на отдельной странице Справочники → Autodesk можно только выбрать существующий бакет).

1. Откройте форму integrations и перейдите на вкладку «Объекты».
2. Нажмите +, чтобы добавить новую строку бакета (создаётся только локальная запись в MyCompany).
3. Заполните:
   • Ключ — глобально уникальное имя (нижний регистр, 3–128 символов, только a-z 0-9 _ - .);
   • Политика — срок хранения исходного файла в APS:
     • transient — 24 часа (используется для разовых преобразований);
     • temporary — 30 дней;
     • persistent — хранится бессрочно (используется для рабочих данных).
4. Нажмите Создать — именно это действие создаёт бакет в APS. Ответ APS на экран не выводится; при неуспешном запросе будет показана ошибка. Чтобы убедиться, что бакет создан, используйте Получить бакеты.

Просмотр существующих бакетов

Нажмите Получить бакеты (на той же вкладке «Объекты»). Кнопка обращается к APS и открывает ответ (JSON-файл) — удобно, когда нужно проверить, что в данный момент создано в вашем приложении APS. Локальная таблица бакетов при этом не заполняется: локальные строки и бакеты APS ведутся отдельно.

Удаление бакета

На вкладке «Объекты» есть два одинаково названных элемента Удалить: кнопка Удалить внутри строки таблицы обращается к APS и удаляет бакет вместе со всем его содержимым — это необратимо; кнопка Удалить на панели инструментов удаляет только локальную строку и не затрагивает APS.

Модели

Модель — это один исходный файл, загруженный в бакет. Каждая строка модели содержит имя файла (ключ), сам бинарный файл, присвоенный APS URN и текущий статус преобразования.

Загрузка модели (выбор файла)

1. Выберите бакет в селекторе Бакета.
2. Нажмите Загрузить модель.
3. Выберите файл на компьютере (Revit .rvt, IFC .ifc, AutoCAD .dwg, Navisworks .nwd и т. п.).
4. Появится новая строка модели с прикреплённым файлом. Файл ещё не загружен в APS — он находится только на стороне MyCompany.

В любой момент можно нажать Открыть и скачать исходный файл обратно из MyCompany.

Действие Удалить в строке модели удаляет только локальную запись MyCompany — уже загруженный объект из бакета APS оно не удаляет.

Поместить — загрузка в APS

Нажмите Поместить в строке модели. Затем MyCompany:

1. Запрашивает у APS подписанные URL-адреса S3 для загрузки (по одному на каждый чанк; крупные файлы делятся на чанки по 50 МБ);
2. Загружает каждый чанк напрямую в S3;
3. Обращается к APS для завершения загрузки.

После завершения действия заполняется поле URN. Файл теперь находится внутри APS, и его можно преобразовывать.

Примечание

Поддерживаются файлы размером примерно до 10 ГБ. Загрузка использует современный подход APS signed S3, поэтому размер ограничен только политикой бакета APS и пропускной способностью сети.

Преобразовать — преобразование в SVF2

Выберите Метод конвертации (см. ниже) и нажмите Преобразовать. APS начинает преобразование исходного файла в SVF2 (формат, который читает просмотрщик).

Преобразование выполняется асинхронно — действие возвращает управление сразу. Время от времени нажимайте Получить статус, чтобы обновить манифест. Пока задание выполняется:

• Статус преобразования = inprogress (или один из pending, running);
• Прогресс преобразования — это процент выполнения / название этапа.

Когда Статус преобразования = success, модель готова к просмотру.

Метод конвертации

Используется только для исходных файлов IFC (другие форматы это поле игнорируют):

• v4 — текущая рекомендация Autodesk; соответствует движку, который Autodesk Docs использует для новых проектов.
• v3 — предыдущий движок IFC; по-прежнему поддерживается.
• modern — более старый, но широко используемый.
• legacy — ещё более старый; в режиме поддержки.

Оставьте поле пустым, чтобы использовать значение по умолчанию платформы (modern). Для нового IFC-контента предпочтителен v4.

Представления

Представление — это одна отображаемая сцена внутри преобразованной модели: 3D-вид, 2D-лист и т. п. Один файл Revit может порождать несколько представлений.

После успешного преобразования:

1. Выберите модель.
2. Нажмите Получить на панели инструментов таблицы представлений (рядом со списком моделей).

MyCompany получит список представлений из APS и покажет их Имя, Роль (3d, 2d, …) и GUID. Выберите представление, с элементами и свойствами которого хотите работать — сама 3D-сцена всегда показывает вид модели по умолчанию.

Элементы и свойства

После выбора представления можно извлечь его дерево объектов (элементы) и метаданные по каждому элементу (свойства).

Получение элементов

Нажмите Получить на панели инструментов дерева элементов. MyCompany запрашивает у APS дерево объектов выбранного представления, разбирает его в иерархию и показывает слева. У каждого элемента есть:

• числовой ID (objectid из APS);
• Имя (например, Wall — Generic 200mm);
• связь «родитель/потомок», повторяющая иерархию исходного файла.

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

Получение свойств

Нажмите Свойства на панели инструментов дерева элементов. MyCompany получает полный набор свойств для каждого элемента выбранного представления и сохраняет их. Свойства группируются по категориям (Identity Data, Constraints, Materials, …); чтобы посмотреть свойства, откройте элемент (редактирование).

Получение свойств заменяет сохранённый набор свойств всей модели: действие Свойства сначала очищает ранее загруженные значения, а затем загружает значения выбранного представления. После переключения на другое представление выполните Свойства ещё раз.

Примечание

Запрос свойств может занимать заметное время на больших моделях. Первый вызов после преобразования может вернуть пустой ответ, пока APS ещё готовит данные — подождите минуту и нажмите снова.

Привязка к номенклатуре

Чтобы модель отображалась на вкладке Autodesk номенклатуры:

1. Откройте отдельную страницу Справочники → Autodesk.
2. Выделите модель.
3. В её поле Номенклатура укажите нужную номенклатуру.

Привязка к номенклатуре — самый мощный вариант: помимо отображения на самой форме номенклатуры, та же модель автоматически появляется на каждой спецификации и на каждом производственном заказе для этой номенклатуры — без необходимости задавать отдельную привязку к спецификации или заказу. См. Просмотрщик в формах → В номенклатуре.

Привязка к проекту

Чтобы модель отображалась на вкладке Autodesk проекта:

1. Откройте отдельную страницу Справочники → Autodesk.
2. Выделите модель.
3. В её поле Проект укажите нужный проект.

3D-просмотрщик появится на форме проекта у любого пользователя, у которого в профиле включён Autodesk — см. Просмотрщик в формах → На проекте, где описано, что именно видит пользователь.

Привязка к спецификации

Заполните поле Bill of Materials (спецификация) на модели, когда нужно привязать её к одной конкретной спецификации (а не ко всем спецификациям, использующим одну и ту же номенклатуру). Одну модель можно одновременно привязать к проекту, спецификации и номенклатуре, но каждая форма использует свои привязки: форма проекта показывает модели, привязанные к проекту, форма номенклатуры — модели, привязанные к номенклатуре, спецификация — модели, привязанные к самой спецификации или к её номенклатуре, а производственный заказ — модели, привязанные к его спецификации или номенклатуре. Результат на форме описан в разделе Просмотрщик в формах → На спецификации.

При открытии производственного заказа MyCompany автоматически подбирает модель, привязанную к спецификации этого заказа или к его номенклатуре — отдельной привязки «Производственный заказ» устанавливать не нужно. См. Просмотрщик в формах → На производственном заказе.

Решение проблем

Симптом	Вероятная причина	Что делать
401 Unauthorized — Token is not provided (AUTH-010)	Учётные данные отсутствуют или указаны неверно.	Заново вставьте Key / Secret. Убедитесь, что в приложении APS включены нужные API.
409 Conflict — Bucket already exists	Ключ бакета уже занят глобально в APS.	Подберите более уникальный ключ (с префиксом вашего тенанта).
Преобразование не завершается	Слишком сложный или неподдерживаемый исходный файл.	Нажмите Получить статус — форма показывает общий статус и прогресс манифеста (Статус преобразования / Прогресс преобразования). Подробную ошибку APS администратор смотрит через API APS.
Пустые Viewables / Elements	Преобразование завершилось успешно, но запрос пришёл раньше, чем APS закончил подготовку метаданных.	Подождите 30–60 секунд и нажмите Получить снова.
Просмотрщик показывает чёрный холст	Срок действия токена APS истёк и не был обновлён.	Перезагрузите форму.
На форме нет вкладки Autodesk	У текущего пользователя в профиле выключен Autodesk.	См. Настройка.
Вкладка Autodesk пуста (нет модели для выбора)	К объекту пока ничего не привязано или преобразование не завершилось.	Привяжите модель и дождитесь, когда Статус преобразования = success.