使用 XML 文件配置 PLM 集成

配置文件中包含的参数、属性和值区分大小写。

除常见的主同步键（如 PlmPartNumber）外，不建议在配置文件的 ToAltium 和 ToPlm 部分同时包含相同的元器件属性/参数。双向同步按该顺序进行（即先从 PLM 到 Altium），因此在这种情况下 PLM 数据将始终占主导地位。

有关与企业系统集成的设置信息，请参阅 示例配置和发布文件。 Enterprise Server 支持在使用 Altium Project Releaser 和 Component Sync 流程时，更新现有的 Arena PLM 条目。这允许 Altium 端新发布的项目和元器件数据推送到 Arena BOM 零部件条目的工作版本（PCBA、FAB 和元器件数据）。 通过将 Altium 项目发布到 Arena PLM——使用 Project Release with Publish to PLM 流程——之前发布的 Arena 项目 BOM 版本将被更新，且与该父项关联的子项也会被更新。在这种情况下，PLM 日志会包含一条警告，提示已更新工作版本，并将生效版本添加到 Arena 中相应的 BOM。 执行元器件同步

元器件（库）同步可手动执行，也可按计划定时执行，可通过 Workspace PLM Integration 页面 PLM 实例条目的 Sync action 按钮手动启动，或在实例设置中指定 自动周期。点击你希望同步的 PLM 实例对应的  控件。同步过程将按照相关配置文件中定义的设置，依次执行 LibSync 工作流。

该控件会变为 。如需停止同步过程，请点击该控件。此时会弹出确认窗口，你可以点击  以取消同步——已同步的元器件将保持同步状态，但后续将不再继续同步。

Workspace 与指定 PLM 实例之间正在进行元器件同步。

当执行元器件同步时，LibSync 流程会按照预定义的工作流推进，直至完成或遇到错误。刷新浏览器（F5）以显示同步流程的当前状态。要监控或查看 LibSync 流程，请选择 Synchronization status 标签页并选择 Closed 列表选项——如果流程仍在运行，将显示在 Active 列表中。管理员可使用 按钮下载所有同步活动的详细记录，格式为逗号分隔的 CSV 文件（Synchronisation status.csv）。

该视图的子标签页提供以下信息：

• Diagram – 展示流程工作流的图示，并高亮显示当前步骤位置（已完成或错误/失败状态）。

• Data – 流程操作的信息摘要，包括各步骤的成功或失败情况，以及指向日志流程报告的链接——见下文。

• History – 主要 Workspace 同步事件的时间日志，按顺序列出。

LibSync 过程结果也可以在 Process Management 页面（Admin » Processes）的 Browser 标签下查看。

在 Data 子标签下显示的所选 LibSync 事件的详细信息中，包括指向该事件系统日志文件（PLM [date-number].log）的链接。

计划同步

您还可以设置自动同步的计划。要进行设置，请编辑 PLM 实例（在主 PLM Integration 页面点击其实例名称或相关控制项），选择 Component Synchronisation 标签并启用 Synchronize PLM Components with server on schedule 选项。使用 Synchronize every 控件根据需要设置自动同步计划。系统非常灵活，允许您：

• 设置每 15/30/45/60/75/90 分钟进行一次计划同步。
• 设置每 x 小时进行一次计划同步。
• 设置每日定时同步，在指定时间执行。

您定义的同步计划将在主 PLM Integration 页面上的 Sync scheduled 列中反映出来。

设置同步计划。

要设置计划同步，您需要提供有效的用户凭据（用于您的 PLM 系统）。这些凭据应在设置 PLM 实例时已注册，如果尚未注册，请点击  按钮，并在随后的 PLM Credentials 窗口中输入您的 User name 和 Password。没有有效凭据，计划同步将保持关闭状态。按需同步也无法进行。

您还可以按需运行同步过程。点击  按钮，并选择所需的同步模式：

• Incremental – 在此模式下，only 自上次同步后被修改过的组件（即其时间戳晚于上次同步日期），并且符合配置文件中同步条件的，将被包含在同步中，相应的更改会被同步传播。这是默认模式，也是点击主 PLM Integration 页面上 PLM 实例的 控件时运行的模式。
• Full – 此模式会强制进行全量同步。所有符合配置文件中同步条件的组件都将被包含在同步中，相应的更改会被同步传播。

流程工作流

以下流程定义（及其底层工作流）可通过 Workspace 获取，以支持 PLM 集成：

• Part Requests 流程主题：
  • Part Request with PLM Part Create – 支持在您的 PLM 实例中自动创建组件，并将生成的料号回传到 Workspace 组件中。工作流图如下所示。

需要注意的重要一点是，当您修改此示例定义以创建自己的流程时，必须指定要在哪个 PLM 实例中创建零件。在工作流图中选择 Create Part in PLM 实体，并在 PLM Instance 字段关联的下拉菜单中选择 PLM 实例。该菜单会列出当前已定义的所有 PLM 实例（如在界面的 PLM Integration 页面中定义）。

► 有关流程工作流的更多信息，请参见 创建和管理流程。

• Project Activities 流程主题：

• Publish to PLM (User selects) – 将已发布的受管项目输出发布到集成的 PLM 实例，用户可以精确选择要发布的输出。工作流图如下所示。

• Project Releaser with Publish – 作为 Project Releaser 的附加阶段，发布到集成的 PLM 实例。工作流图如下所示。

• Project Creations 流程主题：
  • Project with initialise in PLM – 支持在您的 PLM 实例中自动创建料号，并将这些料号作为参数传递到 Workspace 设计项目中。工作流图如下所示。

访问 PLM 相关流程

以下部分介绍如何访问已激活的 PLM 相关流程。由于示例流程无法直接使用，以下流程均为演示目的由示例流程创建：

• PR with PLM Part Create – 由示例流程定义 Part Request with PLM Part Create 创建。
• Publish to Company PLM – Choose Data – 由示例流程定义 Publish to PLM (User selects) 创建。
• Project Releaser with Publish to Company PLM – 由示例流程定义 Project Releaser with Publish 创建。
• Create Project with PLM Initialise – 由示例流程定义 Project with Initialise in PLM 创建。

请注意，Workspace 管理员可以在 Workspace 界面的 Processes 区域内相应流程主题标签页，直接点击  控件，启动任何已激活流程定义的新实例。

零件申请

可在 Altium Designer 内的 Explorer 面板，完成搜索后，在 Details 面板的 Manufacturer Part Search 面板的 Details 区域，或在 Components 面板组件列表底部的链接中访问。

在 Workspace 界面中，可通过 Part Requests 页面右上角的 按钮访问已激活的流程定义。

零件申请示例

以下示例简要展示了在 Workspace 中创建新零件的过程，随后在 PLM 实例中自动创建对应零件。生成的料号会从 PLM 实例回传到 Workspace 组件，作为 Item 参数——这意味着无需发布 Workspace 组件的新修订版。此示例所用的流程定义为 Part Request with PLM Part Create，源自示例定义 Part Request with PLM Part Create。

这里提供的信息对于不同支持的 PLM 系统大致相同。不同之处在于您可以根据公司需求更改的配置文件，以及如果您修改了用于创建零件的流程定义的工作流。

1. 启动零件申请流程，并按要求填写后续表单，详细说明初始申请。在下图中，申请通过 Workspace 界面的 Part Requests 页面提交，并申请了一个零件。

2. 新的零件申请将在 Part Requests 页面显示为一个活动流程，其当前状态会在主条目和其底层工作流图中反映出来。

3. 当所需用户接手（或被分配）处理该申请的任务后，最终会创建所需的零件。为满足申请而创建（和/或选择）的每个组件都会被添加到任务的 Components 字段。所添加的组件会自动在 PLM 中创建。下图中，已创建并添加了一个组件——CMP-007-00004。请确保 Next step 字段设置为 Completed，然后点击  按钮。

您可能会被要求在元器件申请流程中，提供指定PLM系统的登录凭据。

4. 流程将继续进行，所指定的元器件会在PLM实例中创建。流程完成后，您可以在流程的Data 标签页中查看生成的PLM料号。请确保将左上角的筛选器切换为Closed流程视图。

管理员可以使用按钮，将所有列出的元器件申请详细记录以逗号分隔的CSV格式下载。

5. 回到Altium Designer，在Explorer面板中浏览已创建的元器件，并切换到其Preview 标签页。在参数区域，您会注意到新增了一个参数——PlmPartNumber，其值为PLM中对应已创建元器件的编号。

请注意，该参数已添加到元器件中，但其版本未发生变化——元器件并未重新发布。这是因为该参数为项目级参数——直接添加到元器件项目本身，并适用于其所有版本。

项目活动

从Altium Designer发布到Workspace的项目设计数据，可以通过Workspace的“发布到PLM”流程以受控方式同步到PLM。Workspace流程定义了发布操作的接口和方法，指定的XML发布模板则定义了文件数据如何传递到目标PLM系统。

<pt:EntityRule id="FAB">
  <pt:FileDistributions>
    <pt:FileDistribution archiveName="PCB.zip">
      <pt:Folder>PRODUCT/Projects/${project.name}/FAB data</pt:Folder>

PRODUCT
  Projects
    MyProject
      FAB data