Home > PCB_Drc > renameRuleConfiguration

PCB_Drc.renameRuleConfiguration() method

此 API 当前处于 BETA 预览状态，希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改，请不要将它用于任何正式环境。

重命名设计规则配置

签名

function renameRuleConfiguration(
	originalConfigurationName: string,
	configurationName: string,
): Promise<boolean>;

参数名

参数	类型	描述
originalConfigurationName	string	原设计规则配置名称
configurationName	string	新设计规则配置名称

返回值

Promise<boolean>

重命名是否成功

备注

只有自定义配置可以重命名，系统配置不允许重命名

示例

// 1. 读取当前配置并保存为待改名的自定义配置（allowOverwrite=true 重复运行安全）
const current = await eda.pcb_Drc.getCurrentRuleConfiguration();
await eda.pcb_Drc.saveRuleConfiguration(current.config, '嘉立创示例_待改配置', true);

// 2. 静默清掉上次运行保留的目标名（首次运行时目标不存在，删除返回 false 属正常）
await eda.pcb_Drc.deleteRuleConfiguration('嘉立创示例_改名后配置');

// 3. 重命名（保留现场供观察）
const result = await eda.pcb_Drc.renameRuleConfiguration('嘉立创示例_待改配置', '嘉立创示例_改名后配置');

console.log('result:', result);