SDK для интеграции с PLM
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 и статьи
-
Последовательность выполнения операций – подробная последовательность действий для каждой операции синхронизации и публикации
-
Часто задаваемые вопросы – распространенные вопросы об аутентификации, отладке и работе коннектора
-
Локализовано с помощью ИИ