PLM Integration SDK
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.
-
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 Integration в 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 в Altium 365 – настройка и концепции на стороне Workspace
-
Документация SDK – справочник API и статьи
-
Поток операций – подробная последовательность для каждой операции синхронизации и публикации
-
FAQ – типовые вопросы об аутентификации, отладке и поведении коннектора
-