与 Altium 本地部署企业服务器的 PLM 集成

Enterprise Server Workspace 可连接到一个或多个 PLM 实例，并可直接支持 Windchill^®、Arena^®、Oracle^® Agile™、Aras Innovator^® 以及 Siemens Teamcenter^®（需要额外的许可证和设置）。接口配置通过 Workspace 浏览器界面的 PLM Integration page 完成，该页面提供自动化界面，便于配置互连、映射参数数据并指定数据同步方向。接口设置并正常工作后，在以下不同领域工作时将提供相应特性与功能：

• 库（元器件）——支持在 Workspace 与 PLM 实例之间，对元器件、元器件参数以及部件选型进行单向或双向同步。配置界面允许你指定哪些参数由哪个系统作为主数据（master）。此外，参数映射允许你在 Workspace 侧更新属性（可按字段配置），而无需正式发布该 Component Item 的新修订版。还提供专用的 PLM Part Request workflow，支持在 PLM 实例中自动创建元器件，并将生成的 PLM 料号回传到 Workspace 中的元器件。
• 设计（项目）——提供专用的 PLM Project Creation workflow，支持在 PLM 实例中自动创建料号，并将其作为 Altium Designer 项目的参数回传。这些参数可用于特殊字符串（例如用于图纸边框标注）。你可以在 Altium Designer 中运行 Project Releaser 时，将 publish your design 发布到 PLM 实例。PLM 发布操作使用 publishing template（作为 PLM 实例集成配置的一部分定义）来控制数据应如何传递到 PLM。若为首次发布且项目尚未关联（PLM 侧的）料号，则会在 PLM 中创建这些料号，并在首次发布过程中将其与项目关联。你还可以在发布操作中（可选，取决于配置）为 Workspace 库元器件在 PLM 实例中定义元器件条目。并且你始终可以在 process workflow's history（History 选项卡）中准确查看已创建的内容，例如在 PLM 实例中创建的料号。

PLM 支持

Enterprise Server Workspace 可直接支持以下 PLM 系统：

• PTC Windchill^® PLM 版本 12、13，以及 PTC Windchill+（Windchill 的 SaaS variant）。

• Arena^® PLM。

  作为项目 BOM 发布的一部分，BOM 的替代料（BOM alternates）会发布到 Arena PLM。请注意，不会遵循 Alternate Groups，因此 BOM 中相同的部件将共享相同的替代件。

• Oracle^® Agile™ PLM。

• Aras Innovator^® Release 30。

  Additional Setup for Aras Innovator

  要实现与 Aras Innovator 的 PLM 集成，需要通过在其客户端注册表中添加新的节点段，将你的 Altium 服务器注册到 Aras Authentication setup。注册完成后，会为已连接的服务器授予唯一的 OAuth token，用于认证访问。

  对 Aras Innovator 配置所需的更改，是通过编辑其 OAuth 客户端注册表文件来完成的：

  • 在 Aras 主机上，打开 \OAuthServer\OAuth.config 文件进行编辑。
  • 找到并复制 IOMApp 段——从第 <clientRegistry id="IOMApp" enabled="true"> 行到第 </clientRegistry> 行。
  • 将复制的 IOMApp 段紧接着粘贴，以创建一个新的（重复的）段。
  • 在这个新节点段中，将 IOMApp 重命名为 NEXUS——结果为 <clientRegistry id="NEXUS" enabled="true">。View example。
  • 保存并重启 Aras 机器。

• Siemens Teamcenter^®，需要额外的 integration setup。

  • 请注意，当前对 Siemens Teamcenter PLM 的支持基于 Teamcenter EDA (Electronic Design Automation) Gateway 接口，并处于 Closed Beta。Teamcenter 旧版接口（使用基于 SOAP 的 API）将在新 Teamcenter 接口完成 Beta 测试之前保持可用。
  • 与 Siemens Teamcenter PLM 的集成需要安装并配置 Teamcenter EDA Gateway 软件。还需要 Workspace Teamcenter PLM Addon license 才能在 Workspace 中启用此能力。

  ► 详情请参见 Additional Installation and Setup for Teamcenter EDA Gateway。

•  Duro PLM，以第三方 PLM 实例形式实现——请参见下方 Third Party PLM Support。

PLM 设置界面的选择

Altium Enterprise Server 与受支持 PLM 系统的连接，可通过下文所述的高级半自动化用户界面建立，或使用基于编辑 PLM 配置 XML 文件的手动流程。后者需要了解目标 PLM 系统的数据结构并熟悉 XML 格式；而下文所示的更新系统会自动从 PLM 与 Altium Workspace 拉取所需数据，以填充界面中的菜单选项。

你可以通过在 Workspace 界面的 Admin – Settings – PLM Integration 页面中取消勾选 Enable new PLM Configuration page 选项，将 Workplace 重新配置为显示先前的 PLM 界面（基于手动编辑 XML 文件）。请确保保存更改，然后退出并重新登录。

► 有关配置 PLM XML 文件以及使用旧版 PLM 界面的详细信息，请参见 previous version of this page。

连接到你的 PLM 实例

PLM 配置在 Workspace 浏览器界面的 Admin – PLM Integration 页面中创建和管理。

当你成功连接到 PLM 系统后，配置界面将基于从 Workspace 与已连接 PLM 中获取的数据，提供一系列集成选项。

使用 按钮开始连接流程，并按下方幻灯片中的说明继续。

❯ ❮ Javascript ID: PLM_AddNewConfiguration_AES7

点击 打开 Add Configuration 页面，以创建新的 PLM 配置实例，或添加另一个 PLM 配置实例。 为新配置输入唯一的 Name/Description，从 Driver 下拉菜单中选择正确的 PLM 类型，并且（以此 Aras 示例而言）如适用则选择特定的工作数据库。输入你的 PLM 系统 Username/Password 凭据，然后点击 继续。 在 Server Connection 标题下确认 PLM 连接成功后，Workspace 将使用来自 Workspace 元器件数据与 PLM 属性数据的参数化数据选项来填充界面。 加载完成后，界面会将导入的参数化数据与类型数据以可选菜单或字段选项的形式呈现。

在登录目标 PLM 系统时，任何连接错误都会以红色高亮显示。高亮框的下边框将包含错误详情——view example。

第三方 PLM 支持

Altium Enterprise Server 为第三方开发的“非原生”PLM 系统配置提供额外支持。此支持由 Altium 的 Generic Connector 启用，并且需要 Altium PLM Generic Connector Addon license。

当为此类系统添加一个 Workspace PLM 实例时，需要通过 PLM Integration interface 将第三方提供的预配置 XML 文件上传到该 PLM 实例的配置中。一个示例是 Enterprise Server 中对 Duro PLM 的支持。

配置设置

成功连接到某个 PLM 实例后，Workspace 的 PLM 界面会提供配置设置，用于定义组件同步的执行方式、组件参数的相互映射，以及 Part Choices 数据所采用的传输方式。这些同步选项可在界面的 Configuration 选项卡下找到。

您可用的配置设置选项（以及其标签/功能）取决于 PLM 系统类型，以及从 Workspace 与已连接 PLM 实例中获取的参数化数据。

同步参数

此 PLM 界面部分用于定义将同步哪些组件类型、新组件在何处以及如何创建/更新，以及基于参数条件的任何约束。

组件如何同步需要逐项指定：

1. 在参数列表中选择一个 Altium Component Type，并按需设置其 Sync Direction 选项（同步到 Altium/PLM 或两者）——组件类型选项来源于当前 Workspace 的组件数据。
2. 从 PLM Type 菜单中选择相关的 PLM 属性名称——可用选项来源于已连接的 PLM 实例。
3. 在 Altium Target Folder 字段（位于 Sync to Altium 下）中浏览并选择一个 Workspace 组件文件夹，作为该组件的同步位置。
4. 指定一个 Sync Mode，以确定同步时是创建新组件、仅更新现有组件，还是两者都执行。
5. 设置在同步该组件时用于定义组件参数类型的 Component Template。如果存在关联的 Workspace 模板，此设置将默认采用所选的 Altium Component Type（例如：Capacitors）。
6. 使用 Add Parameter Criteria 选项指定一个用于约束同步的参数值。除非组件满足该条件，否则不会被同步。可按需添加更多参数条件。

当连接到支持 Windchill PartsLInk system 的 PTC Windchill PLM 时，还会提供额外选项。PartsLink 系统允许将部件按组进行分类，以便更方便、更快速地定位目标，并且可包含关联的“属性/值”对，以在该分类中提供进一步定义。更多信息请参见下方可折叠部分。

• 从 Filter Criteria 菜单中选择 Add Classification Name Criteria 以添加分类过滤器。使用名称菜单选择同步将按其过滤的分类组。
• 为实现更精细的控制，选择 Add Classification Attribute Criteria 选项并指定某个分类的 Attribute 及其关联的值。在此处所示示例中，仅会同步来自 102-Capcitors 类、且 Capacitance 值为 10uF 的电容器。

当 Sync Direction 设置为 To PLM 或进行双向同步（To PLM & To Altium）时，会在 Sync To PLM 下显示一个 Add Filter Criteria 选项。使用该选项可设置参数或文件夹条件，以控制哪些 Workspace 组件会被传播到 PLM 系统。

可添加多个参数条件，以严格约束 Workspace 组件向 PLM 的同步。可用条件还包括 OR 与 NOT 子句选项，用于更精确地控制同步到 PLM 时对可接受组件的过滤。

Sync to PLM 部分在面向 Arena PLM 系统时提供额外的部件编号以及前缀/后缀选项。这些预定义的 PLM 方案可在 Numbering Scheme 与 Code 菜单中选择，并将决定上传到 Arena 的部件 Item Number 格式。

组件参数映射

继续按上述相同流程，为您希望与 PLM 同步的所有组件指定同步参数配置。由于 Workspace 侧的组件参数不一定与 PLM 侧匹配，因此可使用 Component Parameter Mapping 界面部分在两者之间映射参数。请注意：当参数被映射后，其值将像同一参数一样在两者之间同步。

使用该部分的 Add Parameter 命令创建一个映射条目，用于映射适用于当前所选 Altium Component Type（在 Sync Parameters 下选择）的 Workspace/PLM 参数。PLM 与 Altium 的 Parameter Name 选项来自各自系统中可用的选项。Item/Revision 列中的 Revision 设置会在参数发生变化时创建新的组件修订版；而使用 Item 设置时，同步过程中只会更新组件参数。

使用关联的 图标可移除一个映射条目。

可以用这种方式映射任意数量的参数，但通常会有一组对所有组件都需要映射的常见 Workspace/PLM 参数。当 All Types 被选为 Altium Component Type 时，可使用这种全局映射方式。

创建适用于所有组件的映射条目（Add Parameter），方法是包含已知的常见参数匹配，并按需设置 Item/Revision 与 Sync Direction 选项。同样重要的是，需要将某个已映射的参数条目指定为 Primary Key——这是一对常见参数，用作两组参数化数据之间的参考索引。当其为 PLM Part Number（推荐）时，PLM 侧创建的编号会回传到 Altium 侧，从而在两组已同步的组件数据之间建立已知的参考链接。

PLM 分类属性

对于支持以分类方式对组件分组的已连接 PTC Windchill PLM，可在此部分将相关 PLM 属性和值映射到 Workspace 组件参数。

要从 Windchill 提取特定的分类属性值——例如 102-Capacitor 类中电容器的电容量值——请将该分类及其值（Capacitance）作为 PLM Parameter Name，并将目标 Altium 组件参数（Value）作为 Altium Parameter Name。可为所有组件类型添加定义，也可为同一组件类型添加多个定义。

► 有关 Windchill 分类的更多信息，请参见上方的 PartsLink information。

Part Choices

使用 Sync Direction 下拉菜单指定制造商 Part Choices 数据在 Workspace 与 PLM 系统之间的同步方向，或使用 OFF 选项禁用 Part Choices 同步。

根据所连接的 PLM 类型，Part Choice information 选项将提供以兼容 PLM 自身已批准制造部件（Native PLM Manufacturer Parts）的格式进行同步，或以常规组件参数数据（PLM Part Attributes）形式同步。后者可以是多组 Manufacturer:PartNumber 参数属性——例如 MFR1:MPN1、MFR2:MPN2。

原生 PLM Part Choice 数据

将 Part Choice Information 菜单设置为 Native PLM Manufacturer Parts 选项，以将 Altium Part Choice 信息与已连接 PLM 的“原生”（或内置）部件来源数据同步。此类关系的一个示例是 Windchill 中的 Manufacturer Parts。

Arena 中的部件来源信息主要以 Vendor 参数形式保存，并通过 Manufacturer 参数形成次级（间接）关系。Enterprise Server 的 PLM 界面通过提供与 Arena 以 direct 或 indirect 部件来源关系进行同步的选择来适配这一点。

在 Arena 配置中指定 Part Choices 选项时，Part Choice Information 下拉菜单选项为：

• Native PLM Manufacturer Parts: Direct Source Relationship – 选择此选项可将 Altium Part Choice 数据指向 Arena 的 Vendor 来源关系数据。这是之前的默认状态，因此任何现有的 ToPLM 同步事件都会以 Vendor 关系为目标。
• Native PLM Manufacturer Parts: Indirect Source Relationship – 选择此选项可将 Altium Part Choice 数据指向 Arena 的 Manufacturer 来源关系数据。随后，Altium Part 的制造商数据将与 PLM 侧的制造商数据条目相关联。
• PLM Part Attributes – 如上所述，选择此选项可基于由多组 Manufacturer:PartNumber 属性构成的常规组件参数数据来设置“非原生”的 Part Choice 同步，这些属性通过关联的 Attribute Definitions 进行选择。

Teamcenter PLM 集成本质上支持 Enterprise Server 与 Teamcenter PLM 实例之间对制造商 Part Choices 的双向同步。Altium 侧的组件 Part Choice 数据（Manufacturer Part Number 和 Manufacturer）可直接与 Teamcenter 侧的“原生” Manufacturer Part 和 Vendor 参数同步，这些参数在启用 Teamcenter 的 Vendor Management 功能后可用。

Project Configuration XML

本节列出了用于定义所连接 PLM 系统初始 PLM 配置的基础 XML 配置。下载的该基础设置 XML 版本（Download Sample Configuration）包含详细注释，用于说明大多数 Entity 与 Attribute 部分的功能。

最终，你在 PLM Integration 界面中定义的配置设置会以系统 XML 文件的形式存储，并可通过配置页面顶部与 Server Connection详细信息相关联的 Export Configuration 命令保存到本地。

同时还提供了一个 Import Configuration 选项，可将现有的配置 XML 文件应用到新的（或已编辑的）PLM 配置中，从而复制该 PLM 设置。此外，当需要对现有 PLM 配置进行特定修改时，可先导出其 XML 文件进行手动编辑，然后再将其导入回配置中。

Publish Template Addition

PLM 配置需要添加一个基于 XML 的 Publishing Template，以支持 Workspace 流程在一次“发布（publish）”操作中将完整项目数据——设计文件、元器件与制造输出数据——发送到 PLM 系统。这些流程包括 Publish to PLM（用户指定要发送的输出数据）以及 Project Releaser with Publish（在 Altium Designer 的 Project Release process 最后一步将生成的数据发送到 PLM）。

在创建或编辑 PLM 配置时，请在 Publish Template 选项卡下添加合适的 Publishing Template XML 文件。使用 Sample Project Configurations 链接可下载受支持 PLM 系统的模板归档集合。

Publishing Template 包含对项目详情、元器件数据传输、数据源位置以及设计、装配与制造数据文件分发的引用。下载的示例包含所有受支持 PLM 的模板；每个模板都会包含适用于该特定 PLM 类型的附加 Publishing Rules，并带有详细注释，帮助你了解需要配置什么以及如何配置。

  
<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

根据需要修改示例 XLM 模板，并通过 Add Publish Template 窗口将文件上传到你的 PLM 配置中；该窗口可通过 按钮打开。请注意，一个 PLM 配置支持多个 Publish Templates。

Component Synchronization

Altium 365 Workspace 与所连接 PLM 系统之间的元器件数据同步由上文所述启用的参数映射与方向决定，并会在手动触发或按计划自动触发同步流程时执行。同步流程本身由内置的 LibSync 流程 Workflow 驱动。

在某个 PLM 配置实例中，可在 Component Synchronization 选项卡下访问相关同步选项；你可以手动触发流程，或将其设置为计划任务。若为后者，请启用 Synchronize on a schedule 选项，并从关联的下拉菜单中选择时间间隔。

你可以使用 菜单选项，将 LibSync 流程手动触发为 Incremental 或 Full 同步事件：

• Incremental – 仅应用自上次同步运行以来已修改的元器件（即其时间戳晚于上次同步日期），并且这些元器件需满足配置中的同步条件。请注意：当从主 PLM Integration 页面上的 控件触发同步事件时，使用的就是该模式——见下文。
• Full – 该模式会强制执行全量同步。所有满足配置中同步条件的元器件都会被包含在内。

Performing Component Synchronization

元器件（库）同步可在 Workspace 的 PLM Integration 页面中，从某个 PLM 实例条目手动执行；也可按实例设置中指定的自动周期执行——见上文。点击与该 PLM 实例关联的 控件可手动调用同步流程；该流程将通过 LibSync 工作流执行，并使用关联 PLM 配置中定义的设置。

Actions 控件将变为 ，以便在需要时停止同步流程，同时 Sync Status 条目会指示流程正在进行中。同步流程完成后，Status 将变为 Completed。

当元器件同步运行（无论手动还是定时事件）时，LibSync 流程会按其预定义的 Workflow 推进，直到完成或遇到错误。你可以刷新浏览器（F5）以显示同步流程的当前状态。

要查看已完成同步事件的详细信息，请点击 Last Sync 列中的 图标下载相关日志文件（view example），或选择对应日期以在 Synchronization Status 选项卡中打开该事件条目。请注意：在该视图中，当选择 Closed 选项时会列出已完成的同步事件；当选择 Active 视图模式时，会显示正在运行或已挂起的事件。

Status 视图的子选项卡提供以下信息：

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

• Data – 流程操作的信息摘要，包括各步骤的成功或失败情况，以及指向已记录流程报告的链接——view example。

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

任何提前停止的同步事件（例如遇到错误时）会在视图处于 Active 模式时列出。这些条目可通过 Terminate 控件（）从列表中移除；或者更恰当地，应在 Workspace 的 Tasks view 中由创建的相关 Task 磁贴进行评估与解决。请注意：已终止/已解决的同步事件会被移动到 Synchronization Status 视图的 Closed 列表中，并带有指示性的 Status，例如 Failed。

❯ ❮ Javascript ID: PLM_SyncEventError_AES7_2

Accessing PLM-related Processes

与已连接的 PLM 系统相关的示例流程工作流，可在 Workspace Processes page 上的各个流程主题选项卡下找到。通常，这些示例不能直接使用，必须以不同名称重新保存后才会变为激活状态。

► 有关更多信息，请参阅 Processes & Workflow 文档。

Workspace 管理员可以在 Processes 页面上的流程列表中，点击 控件，直接启动任意已激活的流程定义的新实例。非管理员的 Workspace 用户也可以从 Workspace 发起已激活的流程，例如：

• 从 Part Request page 上的 按钮发起一个 Part Request with PLM 流程。
• 在打开的项目中，从 Tasks 和 Activities 页面上的 按钮发起一个 Publish to PLM 流程。
• 从主 Projects page 上的 按钮发起一个 Publish to PLM 流程。 
• 从主 Projects page 上的 按钮发起一个 Project with Initialize in PLM 流程，或在 按钮菜单中进行 Cloning a project 时发起。

但在实际使用中，与 PLM 相关的流程通常是在项目设计与开发期间从 Altium Designer 中调用。可通过以下方式在 Altium Designer 中访问与 PLM 相关的流程：

• Part Request with PLM Part Create – 通过 Altium Designer 的 Explorer、Manufacturer Part Search 和 Components 面板访问。
  ► 详细信息请参阅 Process-based Part Requests。
• Publish to PLM (User selects) – 通过当前 Altium Designer 项目的 Project » Project Activities 子菜单访问。
  ► 详细信息请参阅 Publishing to a PLM – user-selects。
• Project Releaser with Publish – 作为最终的 Project Releaser 阶段，通过当前 Altium Designer 项目的 Project » Project Releaser 子菜单访问。
  ► 详细信息请参阅 Design Project Release – publishing to PLM。
• Project with initialise in PLM – 在通过 File » New » Project in <Workspace> 子菜单创建新的 Altium Designer 项目时访问，或在 Cloning a project 时访问。
  ► 详细信息请参阅 Publishing to a PLM – initialize in PLM。

流程工作流

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

• Part Requests 流程主题：

  • Part Request with PLM Part Create – 支持在你的 PLM 实例中自动创建 Component，然后将生成的物料编号回传并同步到 Workspace 中的该组件。工作流图如下所示。

    

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

    

    ► 有关流程工作流的更多操作信息，请参阅 Creating and Managing Processes。

• Project Activities 流程主题：

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

    

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

    

• Project Creations 流程主题：

  • Project with initialise in PLM – 支持在你的 PLM 实例中自动创建物料编号，并将其作为 Workspace 设计项目的参数进行回传与同步。工作流图如下所示。