Перейти к основному содержимому
Версия: 7.0

Настройка

На этой странице описано, как подключить MyCompany к Autodesk Platform Services (APS), чтобы стала доступной остальная часть интеграции (бакеты, модели, просмотрщик).

Настройка выполняется администратором однократно. Обычным пользователям не нужно повторять эти шаги — им достаточно поставить флаг Autodesk в своём профиле.

1. Создание приложения APS​

  1. Перейдите на https://aps.autodesk.com/myapps/ и войдите под учётной записью Autodesk.

  2. Нажмите Create Application.

  3. Укажите имя (оно отображается только внутри консоли APS) и отметьте API, необходимые для интеграции:

    • Data Management API — для бакетов и загрузки исходных файлов.
    • Model Derivative API — для преобразования в SVF2 и чтения дерева объектов.

    BIM 360, Construction Cloud, Webhooks, Reality Capture или Design Automation не требуются.

  4. Интеграция использует 2-legged (server-to-server) OAuth, поэтому поле Callback URL можно оставить пустым (или указать заглушку вида http://localhost).

  5. Сохраните приложение. APS покажет вам Client ID и Client Secret — не закрывайте эту страницу, оба значения понадобятся на следующем шаге.

Регион​

По умолчанию интеграция использует регион US Autodesk. Если требуется размещение данных в EU / EMEA, обратитесь к разработчику — для этого нужен дополнительный заголовок x-ads-region при создании бакета и изменение JavaScript-кода просмотрщика (api: 'derivativeV2_EU'). Текущая сборка настроена на US.

2. Ввод учётных данных в MyCompany​

  1. В MyCompany откройте форму настройки integrations (расположение зависит от сборки — обычно Администрирование → Интеграции или аналогичное).
  2. Найдите панель Autodesk.
  3. Вставьте:
    • Key = Client ID из APS;
    • Secret = Client Secret из APS.
  4. Сохраните.

Учётные данные хранятся в MyCompany; пользователям знать их не требуется.

Как получаются токены​

Дополнительных действий не требуется — каждое действие Autodesk в MyCompany автоматически запрашивает свежий OAuth-токен у APS перед обращением к API. Токены переиспользуются до тех пор, пока до их истечения не останется менее 60 секунд, после чего запрашивается новый.

Если самое первое действие возвращает «Token is not provided» или AUTH-010, проверьте:

  • значения Key / Secret в точности совпадают с консолью APS;
  • в приложении APS отмечены Data Management API и Model Derivative API;
  • межсетевой экран не блокирует исходящий HTTPS на адрес developer.api.autodesk.com.

3. Включение Autodesk для пользователя​

Интеграция включается каждым пользователем по желанию.

  1. Каждый пользователь, которому нужен просмотрщик, открывает Редактировать профиль.
  2. Ставит флаг Autodesk.
  3. Сохраняет и перезагружает страницу (JavaScript просмотрщика загружается только при первом отображении страницы после установки флага).

Пока флаг не установлен, вкладка Autodesk на формах проекта / спецификации / производственного заказа скрыта.

4. Проверка​

Быстрая проверка корректности подключения:

  1. Откройте Справочники → Autodesk.
  2. Нажмите Get buckets — если учётные данные верны, ответ откроется в виде JSON-файла (на этом этапе список может быть пустым — это нормально).
  3. Если возвращается 401 Unauthorized — учётные данные неверны. Введите их заново.
  4. Если возвращается другая ошибка — см. Бакеты и модели — решение проблем.

Теперь вы готовы создать бакет и загрузить модель. После того как модель будет преобразована и привязана, конечные пользователи увидят её на формах проекта / спецификации / производственного заказа.