PLM 集成 SDK
PLM 集成 SDK 可让您在 Altium 365 工作区与任意 PLM 系统之间构建自定义连接器(包括未获开箱即用支持的系统),同时融入 Altium 365 用户已经熟悉的 PLM 集成工作流程。
该 SDK 是一个 C# 框架,实现了 PLM 连接器接口,即 Altium 365 用于与 PLM 实例通信的 gRPC 服务。您负责实现连接器逻辑;Altium 365 则负责集成中工作区一侧的处理。
SDK repository and full documentation: AltiumDeveloper/plm-integration-sdk-cs
适用场景
存在以下任一情况时,可使用 PLM 集成 SDK:
-
Your PLM is not natively supported – Altium 365 直接支持多种 PLM 系统。对于其他系统,通用连接器模型可让您构建具有同等支持地位的集成,从工作区角度来看,其行为与原生支持的集成一致。
-
You need custom integration logic – 映射规则、生命周期行为或同步细节超出了标准配置界面或基于 XML 的设置所能表达的范围。
-
Enterprise deployment constraints – 本地部署网关、受控打包或部署模式要求您将连接器作为可部署服务进行自主掌控。
工作原理
Altium 365 通过 gRPC 与连接器通信。连接器作为服务运行,接收来自平台的调用,并将其转换为对 PLM 系统的操作。
每次操作之前,Altium 365 都会调用 Auth endpoint,以验证用户配置的凭据是否允许访问 PLM。随后,包含这些凭据的 IContext 会通过依赖注入在整个调用链中可用,无需您在各项操作之间手动传递凭据。
操作
PLM 集成 SDK 实现了以下操作:
操作 |
说明 |
Sync to PLM |
从 Altium 365 读取元器件,并在 PLM 中创建或更新相应条目 |
Sync to Altium |
在 PLM 中查询条目,并将数据存回 Altium 365 |
Publish BOM |
在项目发布期间运行;创建项目与其 PLM 条目之间的关系定义 |
Publish Project |
创建或更新所有项目元器件、上传文件附件并建立关系;如果已配置,还可推进工作流程状态 |
有关各流程的详细说明,请参阅操作流程一文。
入门指南
-
克隆或派生 AltiumDeveloper/plm-integration-sdk-cs。该代码仓库包含一个基于文件系统存储的可运行示例实现,可作为了解各项操作如何映射到 PLM 调用的实用参考。
-
熟悉 Altium 365 中 PLM 集成的工作方式 – 尤其是通用连接器模型、连接设置和同步方向配置。
-
为您的 PLM 系统实现连接器接口,并将服务部署到 Altium 365 可以访问的位置。
-
在工作区的 Admin → PLM Integration 下注册连接器。
要求
Enterprise license – PLM 集成(包括通用连接器驱动程序)是 Enterprise Toolkit 的一项功能。如果未向工作区分配相应的许可证,PLM 连接配置中将不会显示通用连接器选项。
延伸阅读
-
Altium 365 中的 PLM 集成 – 工作区端的配置和概念
-
SDK 文档 – API 参考和文章