将元件数据库与工作区数据同步

数据库元件库的元件参数来源于主数据库。当此类库迁移到 Altium 365 工作区或 Enterprise Server 工作区后，即可与该数据库进行同步。

使用下文介绍的 Altium Designer Components Synchronization功能，可根据主数据库中所选表的数据，创建一个完成配置和映射的同步配置文件，既可按需运行，也可定时执行。这样，主数据库中的数据更新就会传递到所连接工作区中相匹配的元件参数。

对于在企业系统数据库中集中管理元件数据的公司，此功能使其既能享受工作区的优势，又能与企业系统（PLM、PDM、ERP 等）保持同步，也可以仅与共享数据库或 CSV 文件保持同步。在自动同步模式下，Windows 计划任务将独立于 Altium Designer 设计客户端执行从数据库到工作区的数据更新。

有关将数据库库导入工作区的信息，请参阅将现有库导入所连接的工作区。

创建元件同步配置

在 Altium Designer 中，通过创建和设置 Components Synchronization Configuration文档（*.CmpSync），建立数据库到工作区的同步。连接到工作区后，通过 File » New » Components Synchronization Configuration菜单命令创建新文档。

通过 按钮，或将合适的文件拖放到界面的 Data Sources区域，将所需的主数据源添加到同步配置中。该配置支持以下元件参数数据源：

• 数据库库文件（*.dBLib）——链接到主数据库源。

• Access 数据库文件（*.mdb、*.accdb）

• Excel 电子表格（*.xlsx）

• CSV 文件（*.csv）

• 通过专用连接字符串连接的其他数据源，例如基于服务器且兼容 OLE DB 的接口（包括 PostgreSQL 数据库）。

在下面的示例中，已将一个用于 Zener二极管元件的数据库库添加到配置中。请注意，此 dBLib 先前已迁移到工作区。该库的源数据库（Semi_8.mdb）包含 DiodeGP和 Zeners表，其中后一个表已启用同步。

在属性面板中选择要同步的数据表（可选择多个），随后系统会将其作为参数化数据源访问，并将数据填充到 Components Preview列表中。系统会尝试根据参数数据识别元件类型（电阻、电容等），然后将该 Component Type及其匹配的 Component Template应用于配置。如有需要，也可手动选择这些设置。在 Data Sources下选择一个表条目，即可在 Properties面板中查看当前配置。

在此示例中，系统已识别元件类型（Zeners），并应用了对应的元件模板。随后，该模板会确定目标工作区文件夹、元件命名方案以及所应用的生命周期定义。元件条目通过唯一标识符与源数据库条目匹配，该标识符由 Properties面板中的 Key Parameter条目指定。在本例中使用的是 Part Number，但使用 Name甚至 Description也同样有效。

同步

确认同步设置无误后，保存配置文档，然后通过 按钮执行从数据库到工作区库元件的同步，或设置定时同步（）。

在下方所示的示例中，源数据库（主数据库）中两个元件条目的描述参数已更新。单击配置界面中的刷新按钮（）即可查看这些更改。此操作是可选的，不会影响更新数据的同步。

随后执行同步时，系统将使用当前数据库字段数据更新工作区元件参数。可在元件面板和资源管理器面板中查看此更改。分别使用 F5键或 按钮刷新这两个面板的视图。

如 Explorer面板所示，系统已为这两个更新后的元件创建了新的修订版。从主数据库更新哪些参数时会创建新的元件修订版，由同步配置中的 Parameter Mapping设置决定。

参数映射

您可以在 Properties 面板的 Parameter Mapping 区域中控制同步参数。该区域以表格形式列出目标工作区参数与源数据库参数（字段）之间的关系。此外，还可设置传输参数的类型（文本或带单位类型），并控制在参数更新时是否创建新的修订版。

在参数映射方面，表格中的列分别代表工作区目标参数（Parameter）和源/主数据库字段（Column），与主配置界面中 Components Review 表格所显示的列数据一致。可以将参数从同步中移除（跳过），或将其重新映射到其他可用参数。您可以编辑参数名称，以及添加、编辑和移除参数集。基本元件参数（ID、 Name、Description）可以重新映射，但除此之外均为只读。

上图展示了 Properties 面板中参数映射的三种状态。左图为未应用元件模板时的状态，中图为指定模板后的结果，右图则展示了修改后的参数映射和修订版控制。

• 左图：默认情况下，未应用模板时，主数据库与工作区元件之间的参数基本上是一一映射的。此处设置为 <Auto> 的 ID 参数表示自动创建（如有需要）工作区 Revision ID 参数，该参数与当前条目的 Revision Naming Scheme 设置相关，该设置位于面板的 Advanced 下方。另请注意，数据库的 Comment 字段会自动映射到工作区的 Name 参数。

• 中图：应用元件模板后（此处为 Zeners），数据库参数字段会映射到对应的模板参数。系统会自动识别常见的参数映射，例如本例中从 Pin Count 到 Pins（模板参数）的映射。模板中未定义的参数按一一对应的方式映射，即本例中列表底部的九个参数。

• 右图：通过将列模式设置为 <Skip>，已从同步配置中移除了一系列数据库参数。PackageReference 参数已映射到主数据库的 Footprint 字段。参数 VZ(Max)、VZ(Min) 和 ZZ(Max) 的 Revision 选项已取消勾选，这意味着同步时，这些参数在主数据库中的值发生更改不会导致创建新的工作区修订版，但更改后的值仍会正常传递到工作区元件。

器件选型映射

使用元件同步配置文档， 您可以定义并同步器件选型信息。您可以在 Properties 面板的 Part Choices Mapping 区域中控制同步参数。 使用该区域底部的按钮添加和移除器件选型参数对（Manufacturer / Part Number），并使用下拉菜单选项定义映射。定义映射后，相应参数将显示在文档表格区域的 Part Choice n 列下。

属性面板

当活动文档为元件同步配置文档（*.CmpSync）时， Properties 面板会显示配置选项。以下可折叠部分介绍了可用的选项和控件。

计划同步

通过 Auto Synchronization Schedule 对话框，可将已保存的同步配置设置为自动处理数据库到工作区的元件同步。该对话框可通过主界面中的 按钮打开。

根据当前配置文件，计划同步可设置为在每天的特定时间、每周指定日期的特定时间，或登录 Windows 时执行。您也可以禁用未登录时的同步。使用 按钮确认设置后，该配置将作为重复任务添加到 Windows Task Scheduler 中。设置为 No automatic synchronization 可删除现有的同步计划。

也可以使用软件安装目录下 \System 文件夹中的 ComponentSync.Executor.exe 应用程序，通过命令行执行数据库到元器件的同步。命令语法为 ComponentSync.Executor.exe [configuration file name]。典型示例如下：
C:\Program Files\Altium\AD<Solution/Version>\System\ComponentSync.Executor.exe C:\Users\Public\Documents\Altium\CmpSync\MySyncConfig.CmpSync