Search In: Doc:Documentation: Altium On-Prem Enterprise Server
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany DashboardAltium Developer Center
Ver: Version: 5.5
8.18.07.27.17.06.05.5
Close
搜索 Search on Documentation

PLM 集成

Updated: 一月 10, 2023 | Applies to version: 5.5
您正在阅读的是 5.5. 版本。关于最新版本，请前往 PLM 集成 阅读 8.1 版本
 

Enterprise Server Workspace 可以连接到一个或多个 PLM 实例，并直接支持 Windchill®、Arena®、Oracle® Agile™、Aras Innovator® 以及 Siemens Teamcenter®（需要额外设置）。接口配置通过 Workspace 的浏览器界面完成，大多数配置在基于 XML 的配置文件中定义（通过 Workspace 上传）。当接口搭建并正常工作后，在以下几个不同领域中工作时将提供相应的特性与功能：

  • 库（元器件）——用于在 Workspace 与 PLM 实例之间，对元器件、元器件参数以及器件选型进行单向或双向同步。配置允许你指定哪些参数由哪个系统作为主数据（master）。此外，条目参数（item parameters）使你能够在 Workspace 侧更新属性（可按字段配置），而无需正式发布该元器件条目的新修订版本。还提供专用的 Part Request 工作流，支持在你的 PLM 实例中自动创建元器件，并将生成的 PLM 物料编号回传并同步到 Workspace 中的元器件。
  • 设计（项目）——提供专用的 Project Creations 工作流，支持在你的 PLM 实例中自动创建物料编号，然后将其作为 Altium Designer 项目的参数进行回传。这些参数可用于特殊字符串（例如用于图纸边框标注）。你可以在 Altium Designer 中运行 Project Releaser 时，将设计发布到你的 PLM 实例。发布操作使用发布模板（作为 PLM 实例集成配置的一部分进行定义）来控制数据应如何传递到 PLM。并且如果你是首次发布，且（PLM 侧的）物料编号尚未与该项目关联，那么这些物料编号会在 PLM 中创建，并在首次发布过程中与项目建立关联。你还可以在发布操作中（可选，取决于配置）为 Workspace 库元器件在 PLM 实例中定义元器件条目。并且你始终可以在流程工作流的历史记录（History 选项卡）中清楚看到已创建的内容，例如在 PLM 实例中创建的物料编号等。

PLM 支持

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

  • PTC Windchill® PLM 版本 12
  • Arena® PLM
  • Oracle® Agile™ PLM
  • Aras Innovator® 12.0 SP18 版本

  • 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。

  • Workspace 还提供 Configuration Generator，它会通过分析当前 Workspace 的数据模型来创建 PLM 配置。生成的配置包含当前 Workspace 中可用的所有元素（元器件类型与参数等），并面向指定的（且受支持的）目标 PLM 系统。
在无法在 Enterprise Server Workspace 与公司企业系统之间建立连接的情况下，可以将从该系统导出的元器件数据使用随附的 CSV Import command line tool 导入到 Workspace 中。

连接到你的 PLM 实例

连接到你的 PLM 实例需要在 Workspace 浏览器界面的 Admin – PLM Integration 页面中完成。这包括上传适用的基于 XML 的配置文件和发布模板，并启用/配置 PLM 元器件与 Workspace 中元器件的同步。

要创建新的 PLM 接口实例，点击 按钮。可按需定义任意数量的实例，以便将 Workspace 对接到不同的 PLM 实例。例如，你的元器件可能位于一个 PLM 实例中，而已发布设计项目生成的输出位于另一个实例中；或者不同事业部在使用不同实例（同一 PLM 系统或不同 PLM 系统）。每个实例必须具有唯一名称，包含一个配置文件以及一个或多个已定义的发布模板。要测试某个已定义实例的连接，点击 按钮——参见下方的 Connection Validation。

安装包中提供了示例配置文件和发布模板——展开以下部分以获取更多信息：

通过 按钮添加新的 PLM 条目时，使用 按钮浏览并应用已适当保存/修改的 PLM 配置。

同样地，可通过 Publish Template 选项卡下的 按钮添加兼容的发布模板。在随后的 Publish Template 对话框中，使用 按钮浏览并选择正确的模板文件。

添加并配置与公司 PLM 系统的接口。连接有效后，你就可以根据该实例的活动发布模板，使用已定义的流程定义将项目发布数据发布到 PLM 系统中，并且还可以计划在该 PLM 与 Workspace 之间进行元器件同步。添加并配置与公司 PLM 系统的接口。连接有效后，你就可以根据该实例的活动发布模板，使用已定义的流程定义将项目发布数据发布到 PLM 系统中，并且还可以计划在该 PLM 与 Workspace 之间进行元器件同步。

Windchill、Agile 和 Arena PLM 实例的设置文件也支持规范化的 Change Order（ECO）工作流；该工作流在 Publishing Template XML 文件中启用，并在 Configuration XML 文件的 altiumType="ProjectChangeOrder" 实体章节下定义——参见示例。

根据不同的 PLM 实例，配置定义包括：用于变更单（Change Order）识别的 schema（编号、位置、ID 等）、变更单的特定属性（如名称/标题、描述以及变更复杂度〔仅 Windchill〕），以及选项设置（如变更单创建策略：无、新建或复用现有；以及生命周期状态提升〔仅 Windchill 和 Agile〕）。在发布期间，通过在关联的 Publishing Template 中声明其 publishId 引用来启用所定义的变更单——参见示例。

一旦在服务器的 Configuration 与 Publishing Template XML 文件中完成定义，变更单即可在从 Altium Designer 或通过 Enterprise Server 界面触发的 项目创建 与 发布流程 PLM 工作流中使用。在流程中会显示相应的变更单表单，用于指定变更单的设置与选项。

►有关在 Windchill、Agile 和 Arena PLM 实例中使用 PLM 变更单（ECO）功能的信息，请参阅随 Enterprise Server 安装提供的示例 Configuration XML 文件 与 Publishing Template XML 文件中的注释说明。

与其使用随附的配置文件来创建新的企业系统实例，也可以使用 Workspace 的内部配置生成器来创建一个自适应配置，其结构源自 Workspace 的数据模型。生成器会请求连接信息（PLM 类型与 URL），然后查询 Workspace 中已注册的元件类型（电容、二极管等）及其匹配的 Component Templates，以构建基础配置文件——点击以下可展开章节了解更多信息：

当配置文件被编辑并重新上传到 PLM 实例后，请务必测试（验证）连接，以检测可能引入的问题——见下文。

连接验证

Workspace 提供全面的 PLM 实例连接验证检查，可在 Add/Edit Instance 页面中通过 按钮使用。该功能会执行一系列配置兼容性检查，并立即报告结果。

运行连接验证报告时，Workspace 会分析当前配置与发布模板设置，检查其与 Workspace 以及目标企业系统数据的兼容性。诸如路径错误、未匹配的元件类型定义与参数、无效的生命周期或修订版本设置等配置问题，会在以下 Configuration Validation Report 对话框中被检测并报告。

如果报告了配置错误——导致总体状态为 ERROR（Status）——则必须先解决这些问题，才能创建新实例。WARNING 状态表示存在诸如“Workspace 元件类型未包含在配置中”或“指定属性在企业系统侧不可用”等问题；在这种情况下，仍允许保存并使用已配置的实例。

随后可在所应用的配置/发布文件中修正已报告的错误与警告，和/或通过更改 Workspace 或企业系统的设置来解决。实例成功定义后，请务必点击  按钮。该实例将出现在已连接实例的当前列表中，位于界面主 PLM Integration 页面。

当配置文件被编辑并重新上传到新实例后，请再次使用  按钮，以检测可能引入的任何问题。

元件同步

Workspace 与已连接的企业系统实例之间的元件同步——更准确地说，是其参数化数据——基于 LibSync 流程工作流。LibSync 该流程在 Workspace 中预定义，且无法从 Workspace 的 Admin - Processes 页面访问（或编辑）。不过，作为基于工作流的流程，其同步动作的结果可以查看，并可处理任何错误。

使用同步流程包括以下内容：

  • 为每种元件类型配置同步设置，实际包括：
    • 确定同步方向（同步到 Workspace，或同步到 PLM）。
    • 确定涉及哪些元件类型，以及新元件应创建在何处。
    • 配置映射或参数属性。
  • 如适用，配置 Part Choices 数据映射。
  • 执行同步。

上述前两组事项在用于已连接企业系统实例（如 PLM）的配置文件中处理。同步本身可按需执行，可在 Workspace 界面的 PLM Integration 页面中触发，且/或可进行 计划——即按周期自动同步，该周期在配置与 PLM 实例的连接时定义。

配置同步

在配置文件中，企业系统实例的连接性在 Instance 标签之间定义为指定的 Driver 类型与目标 URL。当使用 Configuration Generator 创建配置文件时，其中包含的 Driver 与 URL 引用即为生成过程中在 Generate Configuration 对话框中输入的内容。 

<Instance>
    <Driver>[Driver Type]</Driver>
    <Url>[PLM API URL]</Url>  
</Instance>
  • 当在配置文件中指定 Arena® PLM driver 时，会提供一个额外条目，用于适配 Arena workspaces（Arena 用户账号可用的工作区）。可选的多位数字 ID 引用属性会添加到 Instance 章节中、位于 context 标签之间，如下例所示。 
    • <Instance>
    <Driver>Arena</Driver>
    <Url>https://api.arenasolutions.com/v1/</Url>
    <Context>12345678</Context>
    <!-- If a workspace ID is not defined, the PLM instance will work with Arena's default workspace for that account. -->
    <!-- The server will report an error if another PLM synchronization session is attempting to use a second workspace from the Arena user account. -->  
</Instance>
  • 当连接的系统为 PTC Windchill PLM 时，可能需要添加一行配置以启用对 Value 读数的计量单位（UOM）。 
    • <Instance>
    <Driver>Windchill</Driver>
    <Url>URL</Url>
    <EnableUOMRead>true</EnableUOMRead>  
</Instance>

在配置文件的后续 Schema 章节中，你需要为每一种专用的零件类型定义一个同步映射章节。在 Workspace 侧，这是类型为 altiumType 的元件——其值是类型参数选项之一，可在 Altium Designer 的 Preferences 对话框中的 Data Management - Component Types page 里看到。在 PLM 侧，会创建一个类型为 plmType 的零件，其类型由其在 PLM 空间中的取值决定。

该章节在文件中声明为一个 Entity ，例如对于电容，可能如下： 

<Entity altiumType="Capacitor" plmType="Capacitor">  
  .  
  .  
</Entity>
plmType 的取值可能会有所不同，取决于你所使用的具体 PLM 实例。

在 Entity 中，使用两个部分来控制并配置从 Workspace 到 PLM 实例、以及从 PLM 实例到 Workspace 的同步——从而支持单向或双向同步。请结合示例配置文件中的注释使用以下部分，以了解更多信息。最终，配置文件中定义的内容会因你的具体需求而异，同时也取决于已在所连接的企业系统实例中定义的（PLM）属性。

用于定义 Part Choices 数据映射的部分位于示例（或生成的）配置文件末尾。

  • 配置文件中包含的 Parameters、Attributes 和 Values 区分大小写。
  • 除常见的主同步键（例如 PlmPartNumber）之外，不建议在配置文件的 ToAltium 与 ToPlm 两个段中同时包含相同的组件 attribute/parameter。双向同步会按该顺序发生（先从 PLM 到 Altium），因此在这种情况下 PLM 数据将始终占主导。
  • 有关如何设置与企业系统的集成，请参阅 example configuration and publishing files。

在使用 Altium Project Releaser 和 Component Sync 流程时，Enterprise Server 支持更新现有的 Arena PLM 条目。这使得 Altium 端新发布的项目与组件数据可以推送到 Arena BOM 零部件条目的工作修订版（PCBA、FAB 和组件数据）。

将 Altium 项目发布到 Arena PLM 时——使用 Project Release with Publish to PLM 流程——先前发布的 Arena Project BOM 修订版将被更新，并将额外的子零部件更新链接到该父项。在这种情况下，PLM 日志将包含一条警告，指出已更新工作修订版，并已将生效修订版添加到 Arena 中对应的 BOM。

执行组件同步

组件（库）同步可作为手动或定时流程执行：分别可在 Workspace PLM Integration 页面上某个 PLM 实例条目的 Sync action 按钮触发，或作为在实例设置中指定的 automated cycle 运行。单击你希望同步的 PLM 实例对应的 控件。同步过程将按照关联配置文件中定义的设置，沿着 LibSync 工作流推进。

该控件会变为 。如果你想停止同步过程，请单击该控件。将出现确认窗口，你可以单击 以取消同步——所有已同步的组件将保持同步状态，但在该点之后将不再继续同步。

Workspace 与所示 PLM 实例之间的组件同步正在进行。Workspace 与所示 PLM 实例之间的组件同步正在进行。

同步将涉及 only 自上次运行同步以来已被修改的组件（即其时间戳晚于上次同步日期），并且这些组件需满足配置文件中的同步条件。这称为 Incremental Synchronization。

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

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

  • Diagram – 表示流程工作流的图形，并高亮显示其当前步骤位置（已完成或错误/失败状态）。
  • Data– 该流程操作的信息摘要，包括各步骤的成功或失败情况，以及指向已记录流程报告的链接——见下文。
  • History – 按顺序列出的主要 Workspace 同步事件的时间日志。

The LibSync process results are also available in the Process Management page (Admin » Processes) under the Browser tab.

在 Data 子选项卡下显示的所选 LibSync 事件详情中，包含指向该事件系统日志文件（PLM [date-number].log）的链接。

如果某个 LibSync 流程失败，会创建一个 Handle errors 任务，并附带相关错误数据，包括摘要信息和流程图。当前操作任务可在 Tasks Management 页面中查看，该页面可通过主菜单中的 Tasks 选项进入。

计划同步

你还可以安排自动化同步。为此，请编辑 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。如果没有有效凭据，计划同步将保持为 OFF 状态；按需同步也将无法进行。

你也可以按需运行同步流程。点击  按钮，并选择所需的同步模式：

  • Incremental – 在此模式下，only 自上次运行同步以来已被修改的那些元件（即其时间戳晚于上次同步日期），并且满足配置文件中同步条件的元件，将被纳入同步，并相应传播变更。这是默认模式，也是在主 PLM Integration 页面中点击某个 PLM 实例的  控件时运行的模式。
  • Full – 此模式会强制执行全量同步。所有满足配置文件中同步条件的元件都会被纳入同步，并相应传播变更。

流程工作流

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

这些流程定义不能按原样直接激活并使用。因此，每个定义更像是一个“模板”——请根据你公司的需求进行编辑、命名，并另存为新的流程定义，然后你 can 再激活并使用它，同时也可与相应流程主题中的其他所有定义一起使用。
  • 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 设计项目的参数回传。工作流图如下所示。

访问与 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 panel 访问（在完成搜索后），也可从 Manufacturer Part Search panel 的 Details 窗格中访问，或通过 Components panel 中元件列表底部的链接访问。

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

项目活动

从 Altium Designer 发布到 Enterprise Server Workspace 的项目设计数据，可以通过 Workspace 的 Publish to PLM 流程以受控方式传播到 PLM。Workspace 流程定义了发布活动的界面与方法，而指定的 XML Publishing Template 则定义了文件数据如何传播到目标 PLM 系统。

有关发布过程的更详细信息，请参阅 Publishing to a PLM。

标准发布流程

在设计端，可在 Altium Designer 中通过活动项目的 Project » Project Activities 子菜单访问标准的发布到 PLM 流程。

与项目相关的流程也可通过 Project Activities 上下文子菜单访问：在 Projects panel 中右键单击设计项目条目即可打开。

在 Workspace 界面中，可在 Project Management 视图里点击  按钮来访问已启用的流程定义。

使用 Project Releaser 发布

作为 Project Releaser 的一部分，发布到 PLM 实例的流程可在 Altium Designer 中通过活动项目的 Project » Project Releaser 子菜单访问。

与发布相关的流程也可通过 Project Releaser 上下文子菜单访问：在 Projects panel 中右键单击设计项目条目即可打开。

将出现 Project Releaser，并新增一个阶段——7: Publish to PLM。此外，在与  按钮关联的菜单中还提供了一个命令——Prepare & Release & Publish to PLM——如果你希望运行 Project Releaser 时不停下来查看生成的数据和执行报告，可使用该命令。

如果你使用标准 Prepare command 运行 Project Releaser，在审阅并发布数据后，  按钮会在 Execution Report 阶段出现。点击该按钮可继续执行该流程的底层工作流，以发布到 PLM。随后将出现 Login Credentials 对话框。输入你的 PLM 实例的 Username 和 Password ，并选择要使用的 PLM Template（以 <PLMInstance>:<PublishingTemplate> 的形式显示）。

如果你选择使用 Prepare & Release & Publish to PLM 命令，最终将直接显示 Login Credentials 对话框。Project Releaser 不会在 Execution Report 阶段暂停，也不会显示  按钮。
请注意，PLM 实例的登录凭据只在首次发布到该实例时需要提供。之后这些凭据会与 Workspace 一起存储。此后，将该项目发布到同一 PLM 实例时会直接按已定义的工作流和所选发布模板继续执行。

点击 Diagram 选项卡可查看该流程的底层工作流。

点击  按钮即可按该工作流继续发布流程。

如果你是首次发布，并且（在 PLM 端）尚未将料号与 Workspace 项目关联，那么这些料号会在 PLM 中创建，并在首次发布过程中与项目关联。你还可以在发布操作中为 Workspace 库元件在 PLM 实例中定义元件条目——以便在 PLM 中获得元件 BOM（可选，取决于发布到 PLM 实例时所定义并使用的发布模板）。

可通过 Workspace 界面检查发布到 PLM 流程的状态：当项目从 Projects 视图打开后，在该项目的详细视图中选择 Activities 视图。流程运行时选择 Opened 视图选项查看状态；流程完成后选择 Closed activities 选项访问状态信息。

你可以在流程工作流的 Data 选项卡下查看具体创建了哪些内容，例如在 PLM 实例中创建的料号。

项目创建

在设计端，可在 Altium Designer 的主 File » New » Project in <Workspace> 子菜单中访问。

在 Workspace 界面中，可在 Projects 视图里点击  按钮来访问已启用的流程定义。

此外，在克隆项目时也可访问：在 Projects 视图中通过  菜单按钮进入。

流程工作流将继续，并弹出对话框以便你定义项目的名称、描述、类型，以及创建时应使用的任何 Project Template Item。点击 Start 后，将出现 Login Credentials 对话框。输入你的 PLM 实例的 Username 和 Password ，并选择要使用的 PLM Template（以 <PLMInstance>:<PublishingTemplate> 的形式显示）。然后点击 Submit 以继续执行工作流。

相关料号将会在你的 PLM 实例中为该项目自动创建，然后回传到 Workspace，作为 Workspace 项目参数。这些参数可作为特殊字符串使用——在设计编辑器中选中已放置的文本字符串后，可从 Properties 面板访问。为项目定义的 Workspace 参数也可在 Project Options 对话框（Project » Project Options）的 Parameters tab 中查看。
请注意，Data 选项卡会提供相关数据，包括为各个项目实体创建的部件编号。PLM 部件编号对应于在 PLM 中创建的 Item；当项目发布到 PLM 时（例如运行 Project Releaser with Publish（to PLM）流程时），这些 Item 将被填充发布数据。

已完成的流程及其相关信息也可以在 Workspace 界面中查看：当项目从 Projects 视图打开后，在该项目的详细视图中选择 Activities 视图即可查看。选择 Closed activities 选项（右上角）以访问已完成流程的状态信息。

  1. 在 Altium Designer 中，新项目会显示在 Projects 面板中，并计划提交到 Workspace 中基于 Git 的 Versioned Storage 设计仓库——在项目条目上右键并使用 Save to server 命令即可完成提交。之后你就可以添加源文档并开始设计。当你准备发布时，该项目已经与 PLM 实例中的相关部件建立了链接。

在 Project Options 对话框的 Parameters 选项卡中，或在 Explorer 面板的项目 Parameters 列表下，你可以看到在 PLM 实例中分配的部件编号，这些编号与可释放/发布的相关项目实体相对应。

PLM 参数名称与项目发布包之间的对应关系在 PLM 配置文件中指定，而该配置文件又由 PLM 系统所需的名称与编号属性决定。

当你放置一个原理图文本字符串时，与项目关联的 PLM 参数将作为特殊字符串可用：

AI-LocalizedAI 翻译
如您发现任何问题，请选中相关文本/图片，并按 Ctrl + Enter 键向我们提交反馈。
Content