SDK для интеграции с PLM
SDK для интеграции с PLM позволяет создать пользовательский коннектор между Workspace в Altium 365 и любой системой PLM, включая системы, которые не поддерживаются «из коробки», при этом он встраивается в тот же рабочий процесс PLM Integration, с которым пользователи Altium 365 уже знакомы.
SDK представляет собой C#-фреймворк, реализующий интерфейс Generic PLM Connector: gRPC-сервис, который Altium 365 вызывает для обмена данными с экземпляром PLM. Вы реализуете логику коннектора, а Altium 365 обрабатывает сторону интеграции, связанную с Workspace.
SDK repository and full documentation: AltiumDeveloper/plm-integration-sdk-cs
Когда использовать
Используйте SDK для интеграции с PLM, если применимо что-либо из следующего:
-
Your PLM is not natively supported – Altium 365 напрямую поддерживает несколько систем PLM. Для всех остальных модель Generic Connector позволяет создать полноценную интеграцию, которая с точки зрения Workspace работает точно так же.
-
You need custom integration logic – требуются правила сопоставления, сценарии жизненного цикла или особенности синхронизации, выходящие за рамки того, что можно выразить через стандартный интерфейс конфигурации или XML-based setup.
-
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 |
Создает или обновляет все компоненты проекта, загружает файловые вложения и устанавливает связи; при соответствующей настройке может переводить процесс на следующий этап workflow |
Подробное пошаговое описание каждого сценария см. в статье Operations Flow.
С чего начать
-
Клонируйте репозиторий или создайте форк AltiumDeveloper/plm-integration-sdk-cs. Репозиторий включает рабочий пример реализации на базе файлового хранилища — полезный ориентир для понимания того, как операции сопоставляются с вызовами PLM.
-
Ознакомьтесь с тем, как PLM Integration works in Altium 365 – в частности, с моделью Generic Connector, настройкой подключения и конфигурацией направления синхронизации.
-
Реализуйте интерфейсы коннектора для вашей системы PLM и разверните сервис там, где Altium 365 сможет к нему обращаться.
-
Зарегистрируйте коннектор в вашем Workspace в разделе Admin → PLM Integration.
Требования
Enterprise license – PLM Integration (включая драйвер Generic Connector) является функцией Enterprise Toolkit. Параметр Generic Connector не появится в конфигурации подключения PLM без соответствующей лицензии, назначенной вашему Workspace.
Дополнительные материалы
-
PLM Integration in Altium 365 – конфигурация и концепции на стороне Workspace
-
Документация SDK – справочник по API и статьи
-
Operations Flow – подробная последовательность для каждой операции синхронизации и публикации
-
FAQ – часто задаваемые вопросы по аутентификации, отладке и поведению коннектора
-
Локализовано с помощью ИИ