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

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

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

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

Бакеты

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

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

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

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

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

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

Нажмите Get buckets. Кнопка обращается к APS и открывает ответ (JSON-файл) — удобно, когда нужно проверить, что в данный момент создано в вашем приложении APS.

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

Выделите строку бакета и нажмите Delete. APS удалит бакет и всё его содержимое. Действие необратимо.

Модели

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

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

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

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

Put — загрузка в APS

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

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

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

Примечание

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

Transform — преобразование в SVF2

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

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

• Transform status = inprogress (или один из pending, running);
• Transform progress — это процент выполнения / название этапа.

Когда Transform status = success, модель готова к просмотру.

Conversion method

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

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

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

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

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

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

1. Выберите модель.
2. В панели деталей нажмите Get в строке Viewables.

MyCompany получит список представлений из APS и покажет их Name, Role (3d, 2d, …) и GUID. Выберите то, которое хотите посмотреть.

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

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

Get elements

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

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

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

Get properties

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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