父页面： PLM 集成
混合集成适用于以下情况：一家公司使用 Altium 365 并希望将其工作区与托管在公司网络内部、没有公共 IP 地址的 PLM 系统集成在一起——即它没有暴露在互联网上。
为了实现这一点，公司网络内部会运行一个名为混合代理的小程序。该程序与 Altium 365 通信，在 Altium 365 工作区和封闭网络内的 PLM 系统之间传递信息。与混合代理的通信通过 HTTPS 进行，不需要为来自互联网的入站流量打开任何网络端口。只需要标准 HTTPS 端口 443 用于出站流量。
设置混合集成
混合代理安装包可以从Altium 365 Workspace的混合代理页面获取，该页面可以通过（新的）PLM管理页面顶部的混合代理标签选项打开（管理员 – PLM集成）。
下载代理存档（
）并将其内容解压到一个已知位置。它包含一个Java应用程序（hybrid-agent.jar），需要在公司网络内部的一台机器上运行，从该机器可以访问本地PLM系统和Altium 365。
该机器不需要能够从互联网公开访问，但需要能够连接到贵公司使用的Altium 365环境。
- 请注意，Hybrid Agent 不需要在托管PLM系统的机器上运行，尽管这样的设置不应该引起问题。
- Hybrid Agent应用程序包括了等效的shell脚本文件（例如
agent.sh）用于基于Linux的系统 - 在下面的代理设置说明中，使用这些脚本文件代替Windows的*.bat文件。
混合代理需要Java开发工具包（JDK）版本11或更高。
[折叠 class=" collapse-text-transparent" title="安装JDK" id="installing_jdk"]
可以使用Oracle JDK或OpenJDK。使用Oracle JDK时，请确保您有有效的许可证。
如果是从普通存档（而不是安装程序可执行文件）安装JDK，需要添加其路径环境变量。对于Windows机器/虚拟机，这些通常是：
PATH – 指向安装的bin文件夹。JAVA_HOME – 指向安装文件夹本身。
通过运行Java -version命令测试对Java可执行文件的访问。
一旦 Hybrid Agent 应用就位：
- 在 Altium 365 工作区的 Hybrid Agent 页面生成 API 密钥 (
)。
- 使用该 API 密钥作为其值创建一个
HYBRID_AGENT_API_KEY 环境变量。
-
使用以下命令上下文运行 agent.bat，其中 URL 参数应为您的 Altium 365 工作区的 URL：
agent.bat https://acme.365.altium.com
当激活时，混合代理将在应用程序的 hybrid-agent\logs 文件夹中生成一个日志文件。
请注意，工作区在任何时候只有一个有效的 API 密钥，并且只能运行一个混合代理实例。如果两个 PLM 系统都托管在同一个封闭网络内，则代理将支持多个 PLM 配置实例。
强烈推荐在生产环境中将混合代理作为 Windows 服务运行，而不是直接在终端中运行，尽管后者可用于测试。
使用 NSSM 服务管理器将混合代理作为 Windows 服务运行的一个示例方法：
- 运行命令：
nssm install HybridAgent。
- 在 NSSM 对话窗口中（在应用程序标签下），在路径字段中输入
agent.bat文件路径，在参数字段中输入您的工作区 URL，然后点击安装服务。
- 您可以在 NSSM 对话框的详细信息标签下使用启动类型选项设置服务启动行为。如有需要，运行
nssm edit HybridAgent进行此类更改。
- 作为为 Java 创建标准
PATH和JAVA_HOME环境变量的替代方法，它们可以添加到 NSSM 的环境标签下。采用这种方法时，变量仅在HybridAgent服务运行时激活。
-
与上面类似，HYBRID_AGENT_API_KEY变量也可以移动到 NSSM 环境设置中，以便在服务运行时激活。
- 使用 Windows 服务管理工具或 NSSM 命令：
nssm start HybridAgent启动HybridAgent服务。如果服务设置为自动启动，则在 PC 重启后不需要这样做。
- 确保在 Windows 服务管理工具中或使用 NSSM 命令：
nssm status HybridAgent检查HybridAgent服务正在运行。
一旦Hybrid Agent连接到您的Altium 365工作区（刷新浏览器窗口以检查其状态），您就可以继续在Altium 365工作区中配置PLM集成。在添加配置页面，启用Hybrid Agent连接选项，并在URL字段中输入您在封闭网络内看到的本地PLM的URL。
当前的 API 密钥可以使用其关联的
撤销命令取消。在那种情况下，需要生成一个新的 API 密钥，并用新的密钥值更新
HYBRID_AGENT_API_KEY环境变量。
重启 Hybrid Agent 以使用新的密钥 - 使用 NSSM 的话，使用
nssm restart HybridAgent命令，或者在 Windows
服务中停止/启动
HybridAgent服务。
