SDK для интеграции с PLM
Краткий обзор
- Узнайте, когда стоит использовать SDK: для работы с неподдерживаемыми PLM-системами, реализации собственной логики интеграции или учета ограничений корпоративного развертывания.
- Изучите, как коннектор взаимодействует с Altium 365 и обеспечивает синхронизацию, публикацию спецификаций (BOM) и проектов.
- Найдите пример реализации, инструкции по развертыванию и регистрации, а также сведения о требовании к лицензии Enterprise Toolkit.
SDK для интеграции с PLM позволяет создать собственный коннектор между рабочим пространством Altium 365 и любой PLM-системой, в том числе не поддерживаемой по умолчанию, сохраняя привычный для пользователей Altium 365 процесс интеграции с PLM.
SDK представляет собой фреймворк на C#, реализующий интерфейс PLM Connector: службу gRPC, которую Altium 365 вызывает для взаимодействия с экземпляром PLM-системы. Вы реализуете логику коннектора, а Altium 365 обеспечивает интеграцию со стороны рабочего пространства.
SDK repository and full documentation: AltiumDeveloper/plm-integration-sdk-cs
Когда использовать
Используйте SDK для интеграции с PLM в следующих случаях:
-
Your PLM is not natively supported – Altium 365 напрямую поддерживает несколько PLM-систем. Для всех остальных модель Generic Connector позволяет создать полноценную интеграцию, которая со стороны рабочего пространства работает точно так же.
-
You need custom integration logic – Требуются правила сопоставления, особенности управления жизненным циклом или синхронизации, выходящие за рамки возможностей стандартного интерфейса настройки или настройки на основе XML.
-
Enterprise deployment constraints – Нужны локальные шлюзы, контролируемая сборка пакетов или схемы развертывания, требующие управления коннектором как развертываемой службой.
Как это работает
Altium 365 взаимодействует с коннектором по протоколу gRPC. Коннектор работает как служба, которая получает вызовы от платформы и преобразует их в операции в вашей PLM-системе.
Перед каждой операцией Altium 365 вызывает Auth endpoint, чтобы проверить, предоставляют ли настроенные пользователем учетные данные доступ к PLM-системе. Затем IContext, содержащий эти учетные данные, становится доступен по всей цепочке вызовов благодаря внедрению зависимостей — передавать учетные данные между операциями вручную не требуется.
Операции
SDK для интеграции с PLM реализует следующие операции:
Операция |
Описание |
Sync to PLM |
Считывает компоненты из Altium 365 и создает или обновляет соответствующие объекты в PLM-системе |
Sync to Altium |
Запрашивает объекты в PLM-системе и сохраняет полученные данные в Altium 365 |
Publish BOM |
Выполняется при публикации проекта; создает определения связей между проектом и его объектами в PLM-системе |
Publish Project |
Создает или обновляет все компоненты проекта, загружает вложенные файлы и устанавливает связи; при соответствующей настройке может переводить процесс на следующий этап |
Подробное описание каждого процесса см. в статье «Порядок выполнения операций».
Начало работы
-
Клонируйте репозиторий AltiumDeveloper/plm-integration-sdk-cs или создайте его форк. Репозиторий содержит рабочий пример реализации с хранением данных в файловой системе — он поможет понять, как операции сопоставляются с вызовами PLM-системы.
-
Ознакомьтесь с тем, как работает интеграция с PLM в Altium 365, — в частности, с моделью Generic Connector, настройкой подключения и выбором направления синхронизации.
-
Реализуйте интерфейсы коннектора для своей PLM-системы и разверните службу так, чтобы она была доступна для Altium 365.
-
Зарегистрируйте коннектор в своем рабочем пространстве в разделе Admin → PLM Integration.
Требования
Enterprise license – Интеграция с PLM (включая драйвер Generic Connector) входит в состав Enterprise Toolkit. Параметр Generic Connector не будет отображаться в настройках подключения к PLM, если вашему рабочему пространству не назначена соответствующая лицензия.
Дополнительные материалы
-
Интеграция с PLM в Altium 365 – настройка со стороны рабочего пространства и основные понятия
-
Документация SDK – справочник API и статьи
-
Порядок выполнения операций – подробная последовательность действий для каждой операции синхронизации и публикации
-
Часто задаваемые вопросы – распространенные вопросы об аутентификации, отладке и работе коннектора
-