库迁移器改进

对库迁移器进行了实质更新，以便提供将基于文件的元件库转换为基于服务器的托管元件的高度自动化一键式解决方案。改进包括全面修订用户界面，并引入能够自动检测元件类型和参数内容的源库分析过程。

经过改进，传统的基于文件的元件库可以通过单个步骤迁移至托管服务器元件，而迁移器则会自动处理类型分类、目标源文件夹、参数包含和值类型以及所有相关数据的传输——参见下文的简易模式。另外，包含多种元件类型的库（整体库）也将得到自动检测和处理。

除了提供自动一键式方法外，经过修订的“库迁移器”还通过属性面板提供高级配置选项。通过这些选项，可以完全控制每个源库的迁移配置，从而允许调整或彻底改变流程来满足你的需要。

登录Altium服务器后，您将可以使用“库迁移器”，“库迁移器”可以通过以下方式访问：

• 在元件面板的类别列中选择一个基于文件的库，然后从 菜单中选择迁移库选项。
• 右键单击项目面板中的库文件，然后从弹出菜单中选择迁移库。
• 在原理图/PCB库编辑器中选择工具»迁移库。
• 将库文件从Windows文件夹拖放到Explorer面板上。
• 从主菜单中选择文件»库迁移器。

前四个选项将在简易模式下打开迁移器，用户可以选择立即迁移选定的库() 或在全图形用户界面模式下打开库迁移器()。

简易模式

“库迁移器”的简易模式将根据其对源库的分析预先选择迁移过程的所有方面，然后根据  命令通过单一步骤完成库迁移。

关于此过程，值得注意的几点是：

• 完全且即时可用的元件迁移取决于与源元件类型匹配的元件模板的可用性。如果在安装过程中选择了安装样本数据选项，则服务器中将有合适模板可用。
• 具有无法识别（未被检测）的元件类型的源库将在不解译的情况下，作为“元件/未分类”服务器文件夹中的未分配元件类型进行迁移。在运行迁移之前，可以通过在“高级”（全用户界面）模式下应用“位号标识符映射”或“参数分组”来解决这一问题。
• 整体库会自动分成多个子组，每个组代表该库内的一种元件类型。这些子组将作为单独的库处理。
  
• 任何触发验证错误的元件都将被跳过。
• 过程遇到的所有问题都可以在迁移报告中查看，该报告可以在迁移完成后，通过 按钮获得。

作为新创建的托管元件，库迁移的结果可以在Explorer面板和元件面板中查看。迁移元件包括所有模型、由应用的“元件模板”解译的参数、来自供应商源数据以及任何参考链接或文件的“元器件”选择信息。

高级模式

在高级模式下，将显示“库迁移器”的全图形用户界面，通过该界面，用户可以对库、元件类型和元件参数管理进行精细化控制。当与属性面板结合使用时，可以根据您的特定需求配置元件库到服务器的迁移。

  通过文件»库迁移器命令打开“库迁移器”时，或者在简易模式下选择 按钮时，高级模式将被启用。通过 按钮或者通过将库文件拖放到指定该区域，可以将库添加到迁移器的源库部分（尚无数据的情况下）。使用右键单击选项，可以将选定的库或提取的子库从迁移中排除。

迁移预览部分列出了从源库中识别的元件类型组——作为元件类型 () 或提出的文件夹结构 () – 并包括了这些元件的基于参数的栅格视图。栅格中的参数值可以在运行中编辑，从而避免了打开和编辑源库。下方的详细信息区域包含来自当前选定元件的其他信息——元器件选择、模型和数据表单。

不管界面中显示什么详细选项和数据，迁移器的高级视图都可以与简易视图一样的方式使用——只需单击 按钮，即可调用迁移过程而无需干预。与简易视图过程一样，迁移器分析库、推导其中包含的元件类型，并应用正确的“元件模板”。模板则反过来确定服务器目标文件夹、应用的“命名方案”和“生命周期定义”，以及参数映射/解译。

导出-导入配置

库迁移器具有导出记录当前配置设置（其中包括所有可配置迁移设置，例如目标路径、参数映射、命名方案、生命周期定义、目标元件类型等）的详细的基于文本的文件的功能。

  “迁移配置”文件从文件»导出»迁移配置命令中转存为*.lmcfg 文件类型，并且可以随时通过文件»导入»迁移菜单选项恢复。

恢复配置功能在基于文件的源库经过更新并需要将变化迁移至服务器时尤其有用。如果在第一次迁移库时导出了配置，则还原（导入）的配置将重建使用过的精确配置设置，从而保证为该库提供一致的数据传输方案。

整体库

包含多个元件的源库由迁移器的分析例程来检测，并分离到子库组中，在子库组中它们可以作为单独的类型库进行处理。元件类型检测建立在源元件位号标识符（R?、C?等）以及其他主要元件参数（“描述”、ID等）中包含的关键词（电阻器、电阻等）上。

在下面的示例中，源库（ProjectABC.IntLib）已根据检测到的元件类型（“电容器”、“电阻器”等）自动“拆分”，元件类型可以在元件类型列中选择，以便在元件栅格中预览其组成元件条目。

未分类元件

请注意，上图中的一个库子组条目被命名为未分类（并且元件类型条目也被命名为未分类），这说明迁移器无法检测到该组元件并为其分配一个类型——“元件类型”有效地设置为“无”。在此示例中，未检测到的元件（“反相器逻辑IC”）使用无法辨识的位号标识符前缀（U?），并且其参数不含检测到的关键词，例如IC、逻辑等。

这一问题可以通过在库拆分对话框中手动将用于这些元件的位号标识符映射到所需的元件类型加以解决，“库拆分”对话框可以通过 按钮，在选定的源库（ProjectABC.IntLib）可用时访问。

选中对话框的自定义位号标识符映射选项，单击 按钮创建新的映射条目，从位号标识符下拉列表（包括所有可用的位号标识符）中为未分类元件选择正确的位号标识符字符串选项，然后从元件类型下拉菜单中选择所需的元件类型选项。用 按钮确认完成的类型-位号标识符映射（U?位号标识符映射到“逻辑”元件类型）。请注意，如有需要，可以手动输入多个位号标识符类型并用逗号隔开。

通过应用的映射指定元件类型后，迁移器将使用匹配的“元件模板”（“逻辑”）来配置由模板设置（文件夹、命名等）定义的库迁移。

错误和警告

当运行库迁移器 () 或执行迁移验证 ()时，“高级用户界面”中的警告或错误标记会指示无法正确迁移或根本无法迁移到服务器的元件。

尝试执行迁移时，消息面板中将填充检测到的违规问题，并且将出现一个对话框，让用户选择放弃或继续当前迁移配置。在后一种情况下，则无效元件将不会被迁移，否则迁移过程将失败。

如果取消迁移或运行手动“验证”，则任何未通过迁移检查的元件都将与错误/警告图标以及下方详细信息区域内的进一步信息相关联。预览“状态”列中的图标表示违反迁移规则检查的具体元件条目。

解决错误和警告

参数错误，例如此处所示示例中的错误（在示例中，元件的“正向电压”值无法解译为有效电压），可以通过以下方法解决：

• 将元件从迁移过程中删除——右键单击其条目，然后选择从迁移中排除选项。
• 编辑有问题的参数“值”——定位其单元格并编辑成兼容的格式。
• 将映射的参数类型（由应用的“元件模板”确定）从“电压”改为未解译“文本”——在迁移器用户界面中选择“源库”，然后在属性面板参数映射列表（在常规选项卡下）中更改“正向电压类型”。

文件丢失错误，例如此处所示的无法定位“数据表单”文件，可以通过以下方法解决：

• 定位并将丢失文件恢复至预期位置的解决方案。
• 如上所述，将元件从库迁移过程中排除。
• 禁用数据表单文件的迁移——在属性面板“数据表单”部分（在高级选项卡下）中更改“迁移”选项。

如果要查找特定元件条目，使用搜索字段（右上方）。搜索将按当前选定元件类型的匹配参数值过滤条目列表——在元件类型下选择全部，以对可用源库内的所有元件进行搜索。

重复检测

“库迁移器”还包括避免在目标服务器中创建重复元件的机制。这是通过在验证过程中将源库的元件标识符参数和“元器件选择”与目标服务器中元件的参数进行比较实现的。

使用迁移器的默认设置，当在目标服务器中检测到相同元件“名称”或“元器件选择”条目（表明可能存在重复元件）时，验证步骤 () 将标记警告消息。显示的警告/错误消息包括重复违规的类型（参数或“元器件选择”）、违规的库元件名称和与之一起违规的服务器元件（按ID显示）。

“验证”过程检测到两个潜在的重复项，即源库中的元件“名称”（顶图像）或其“元器件选择”（下方图像）已经存在于服务器元件中。

用于检测重复违规的参数名称-值对在“属性”面板“高级”选项卡下的“重复检测”区域中指定。使用“唯一字段”下拉菜单（默认设置为“名称”）从源库中的可用“参数”中进行选择。对于使用绑定到范围更广的企业系统的专有标识符字段的公司库配置，此项选择尤其有用。

检测到本地库元件和服务器元件的指定参数（ERP-REF）值相同的重复违规。

通过在属性面板“常规”选项卡下的迁移检查区域中选择备用报告模式，可以为重复违规设置不同的状态标志类型。

单一模型库

自动重复检测还被用于处理对所有元件使用通用符号模型的源库。此类源库通常由具有不同样式和值的单一元件类型组成，例如特定封装格式的电阻器，其中每个元件的符号均为标准模型图形。

“库迁移器”检测到这种单一通用模型时，会将迁移配置成转移一个适用于所有迁移元件的符号模型——而不是为每个元件转移一个对应的、单独命名的符号。要迁移的符号采用通用“符号”名称，并且所有元件参数均保持不变。

  迁移库符号（具有名称“符号”和空白“描述”字段）可以根据您的需要进行编辑。在Explorer面板中，使用右键单击编辑选项调用该操作。在此过程中，在为条目创建修订版本对话框中选择与<符号ID>有关的更新条目，以确保迁移元件使用新的符号修订版本。

仅限模型迁移

“库迁移器”可以切换到特殊的仅限模型迁移模式，该模式可以检测和处理源库中的可用元件模型。如需改为此迁移器模式，请在“优选设置”的系统-常规页面的高级设置对话框中勾选LibraryMigrator.ModelsOnlyMode选项。

在“仅限模型”模式中，迁移器的分析过程将检测源库中可用的所有“符号”、“封装”和“仿真”模型（IntLib、SchLib、PcbLib等），然后使用系统的默认位置、命名方案和生命周期定义将这些模型迁移至服务器。

当“库迁移器”切换到其“高级”模式 () 或在其“高级”模式下打开（文件»库迁移器）时，将提供模型迁移的完整详细信息。迁移预览区域显示将在目标服务器中使用的文件夹结构，该结构可以从属性面板中各个模型类型的“文件夹”字段中的默认设置进行修改。针对每个模型应用的命名方案和“生命周期”定义可以从可用系统类型进行选择（参见下方“属性”面板）。

如有需要，可以使用关联 按钮禁用（或启用）属性面板中的具体模型类型，通过类型限制元件模型到服务器的迁移。

一旦完成“库迁移器”的配置，即可选择 按钮完成所列元件模型的迁移。结果可以在库迁移器进程对话框 ()提供的迁移日志文件中查阅，或者通过在Explorer面板中查看迁移模型进行查阅。

合并元件类型

在系统中（或实际上在连接的服务器中）注册的“元件类型”范围可以在优选设置对话框的数据管理—元件类型页面中查看和管理。类型与关联元件模板和服务器文件夹一起列出，并且将包括“库迁移器”将库文件迁移至服务器后创建的新类型。

当“库迁移器”配置使用“参数分组”（指定元件参数值）确定各个迁移元件的“类型”时，通常会创建新的“元件类型”。例如，一些迁移元件的“类别”参数可能是“电阻-0608”，而另一些迁移元件的“类别”参数可能是“电阻-0402”，诸如此类。为了方便未来使用，最好的做法是在单一“电阻元件类型”下分组。

在这种情况下，不是手动更改所有元件类型，而是“首选项”中的元件类型页面允许将选定的“类型”条目合并到指定的单个条目中。如需这样做，请选择要合并的所有“类型”条目，包括目标“类型”，右键单击突出显示的条目，然后从上下文菜单中选择合并选项。在之后出现的“合并”对话框中，从“合并至”下拉菜单中选择目标“元件类型”，然后单击对话框的 按钮进行确认。下图说明了一系列迁移“电阻器”元件类型的合并操作。

在此示例中，操作过程将元件的“元件类型”从合并类型（例如“电阻-0402”、“电阻-0603”等）改为合并目标“类型-电阻”。这一变化的实际结果之一是，当在元件面板类别下选择某个特定类型，则该类型的所有元件将都可用。请注意，元件条目不会受到任何其他影响。它们仍然保留在与迁移过程中创建的“元件模板”相关联的现有文件夹中，并且模板本身也依然可用。

合并之后，数据管理-元件类型页面显示“电阻”元件类型是多个模板的默认设置——即“电阻模板”和与新合并的元件类型（“电阻_0402模板”，以此类推）相关联的所有模板。“电阻”元件类型的文件夹条目与这些模板的目标文件夹对应。

此类合并的结果是，当在“库迁移器”中将“电阻”选择作为迁移元件类型时，如果您选择任何合并模板（“电阻_0402”等）作为替代模板，则“电阻”将得到应用。当创建一个新元件（文件»新建»元件）时，这些“模板”将在创建新元件对话框中，作为“电阻元件类型”的子条目提供。

模板分配

通过 按钮访问编辑模板对话框，可以从数据管理–元件类型页面中指示的模板更新模板到元件类型的映射。 如对话框的列条目中所示，该映射表示使用关联的模板时将应用哪个元件类型，或者相反，表示选择了元件类型（例如，创建新元件时）时将使用哪个模板。

对于对话框中选定的“模板”条目，可通过从条目的下拉菜单中选择备用“元件类型”来更改关联。对话框和页面关闭后，模板的ComponentType参数值及其“默认文件夹”设置将更改，以便对应新指定的类型。这与手动编辑“模板”具有同等效果。

  更新后的模板类型映射结果显示在数据管理-元件类型页面上，该页面上有一个按“名称”导向的列表——在该列表中，“名称”代表“元件类型”。这表明许多不同模板（“电阻_0402”、“电阻_0603”等）已关联并将应用“Resistor_LibMigrate元件类型”。

属性面板

通过“库迁移器”的关联属性面板设置，可以对选定库（或子库组）的迁移配置实施高级控制。面板的选项设置由默认系统设置或者应用的元件模板规定设置定义，这些设置又由检测到的库的元件类型（此处所示示例中的LED）设置。这些设置亦可由用户编辑，从而允许您根据需要调整迁移过程，并且可以通过“重置为默认值”链接（右上角）恢复。

面板的常规选项卡部分如下：

• 常规——迁移器为选定库检测到的元件类型（元件类型），以及通过关联检测到的应用模板（元件模板）。通过编辑字段（将创建新的元件类型）或通过 按钮选择备用类型或模板，可以否决这些设置——这是解决未分类元件问题的另一种方法。将元件模板选项设置为“新建”，以自动创建衍生自源库参数和“库迁移器”当前设置的模板。
• 参数映射——库参数与应用的元件模板中的参数，以及每个参数的值“类型”（“文本”或单位识别类型）之间的参数匹配。使用源库参数列下拉菜单选项更改映射，并使用“类型”列菜单选项否决由模板确定的现有设置。“参数”名称可以编辑，“参数”集可以添加、编辑和删除。
• 元器件选择映射——迁移器识别的元器件选择（或供应商链接）参数的列表。使用下拉菜单选项重新定义映射，或添加和删除映射集。
• 迁移检查——查看或设置迁移器对违反迁移规则的错误/警告响应。使用“报告模式”下拉菜单，更改响应和“违规类型”条目的图标。请注意，如果选择了“致命错误”报告模式，则如果检测到违规，迁移过程将被阻止。

面板的高级选项卡为所有迁移数据对象条目提供了设置，由系统默认值或应用的“元件模板”设置。其中包括元件“模型”，“数据表单”文件和创建的任何“元件模板”。除数据表单选项（启用/禁用切换）外，每个迁移对象的设置包括：

• 文件夹——迁移对象的目标服务器文件夹，可以通过浏览按钮 () 进行手动编辑或选择。
• 命名方案——由“元件模板”定义的对象服务器命名规范；在没有活动模板的情况下，指的是为目标文件夹设置的命名方案（或手动输入的命名方案）。
• 修订命名方案——用于对象服务器修订的命名安排，由应用模板设置或从条目的下拉菜单选项中选择。只有系统启用的方案才是可选选项。
• 生命周期定义——用于对象的生命周期系统，由应用模板设置或从条目的下拉菜单选项中选择。只有系统启用的定义才是可选选项。