知识库：将现有受管元件更新为新的元件类型和模板

解决方案详情

现有元器件需要采用新结构

当组织将示例元器件类型和模板替换为自定义配置时，可能需要更新现有的受管元器件。随后，必须将元器件迁移到新的元器件类型、模板和文件夹结构。调整元器件结构时，务必考虑不同的需求和初始条件。因此，固定的分步流程并不总是适用。

元器件类型决定组织方式和模板

元器件类型通常与元器件模板和默认文件夹结构关联。元器件模板定义参数集、参数可见性、默认值以及必填参数设置。更新元器件类型时，通常还需要更新关联的模板和文件夹结构，以保持整个工作区的一致性。

调整元器件结构的可用方法

• 激活一个不含示例数据的新工作区，并创建自定义元器件类型、模板和文件夹结构。请注意，如果您已在当前工作区中创建了实际项目数据，则此选项不可行。
   
• 在创建元器件之前，更新现有的元器件模板和类型。 
  
• 创建新的元器件类型、模板和文件夹结构，然后通过批量编辑将现有元器件更新为新配置。

使用批量编辑更新元器件

1. 创建新的元器件类型、模板和文件夹结构。
   
2. 检查新旧模板，确保参数一致。保持参数名称和类型一致，有助于避免重复参数，并减少迁移后的清理工作。可以添加其他参数，但应尽可能保持关键参数一致。创建新的模板参数时，除非会手动输入相应数据，否则不要将其设为必填。 
    
3. 在更新较大的元器件库之前，先用一小批测试元器件验证此流程。
4. 在 Explorer 中，将现有元器件从旧文件夹结构移动到新文件夹结构。
    
5. 打开已迁移的元器件进行批量编辑
   
6. 在 Models and Parameters 部分中，点击 Add，然后选择 Template: None。这会将现有的模板参数转换为用户参数。
    
7. 再次点击 Add，然后选择新的元器件模板
8. 出现提示时，确认更新所有选定元器件的元器件类型。新模板会用模板参数名称替换用户参数，并添加所有新定义的参数。
    
9. 分批执行更新，先更新处于 Draft 生命周期状态的元器件，再更新处于其他生命周期状态的元器件。
10. 确认通过批量编辑器执行元器件发布操作时，生命周期状态得以保留。
11. 成功验证已迁移的元器件后，移除已弃用的元器件类型、模板和相关项，以免造成混淆。

补充说明

• 元器件移动和生命周期状态管理可以逐步完成。
• 新旧模板之间的参数不一致问题，可能需要使用批量编辑工具手动清理。 链接

参考资料

• 元器件批量编辑
• 元器件模板
• 元器件类型