如何在Adobe Experience Manager(AEM)6.5中重命名Experience Fragment根文件夹？

一、执行文件夹重命名 #

AEM编辑器默认不支持文件夹重命名操作，需通过CRXDE Lite完成：

• 登录AEM后台的CRXDE Lite（访问路径：/crx/de）
• 导航到目标文件夹路径：/content/experience-fragments/old_name/de
• 右键点击该文件夹，选择「Rename」，输入新名称new_name
• 保存所有变更，此时文件夹路径更新为/content/experience-fragments/new_name/de

二、批量更新所有旧路径引用 #

由于大量组件依赖旧路径，需覆盖所有引用场景，以下是三种可行方法：

方法1：使用AEM内置References工具 #

• 打开AEM的「References」控制台（访问路径：/libs/cq/content/references.html）
• 在搜索框输入旧路径/content/experience-fragments/old_name/de，选择搜索范围为/content（或按需缩小范围）
• 搜索完成后，勾选所有引用该路径的节点，点击「Replace」按钮
• 在替换框中输入新路径/content/experience-fragments/new_name/de，确认替换并保存变更

方法2：通过CRXDE Lite查询批量处理 #

如果References工具覆盖不全，可直接用SQL2查询定位引用节点：

• 在CRXDE Lite顶部的查询栏，执行以下SQL2语句：

  SELECT * FROM [nt:base] AS s WHERE ISDESCENDANTNODE(s, '/content') AND s.* LIKE '%/content/experience-fragments/old_name/de%'
  

• 查询结果会列出所有包含旧路径的节点，可直接在CRXDE Lite中逐个更新属性值，或导出结果批量替换后重新导入

方法3：使用Groovy Console脚本高效处理（需开发权限） #

编写Groovy脚本批量扫描并替换所有引用：

def oldPath = "/content/experience-fragments/old_name/de"
def newPath = "/content/experience-fragments/new_name/de"
def queryManager = session.workspace.queryManager
def statement = "SELECT * FROM [nt:base] AS s WHERE ISDESCENDANTNODE(s, '/content') AND s.* LIKE '%${oldPath}%'"
def query = queryManager.createQuery(statement, "JCR-SQL2")
def result = query.execute()
def nodes = result.nodes

nodes.each { node ->
    node.properties.each { prop ->
        if (prop.type.name() == "STRING" && prop.string.contains(oldPath)) {
            def newValue = prop.string.replace(oldPath, newPath)
            node.setProperty(prop.name, newValue)
        }
    }
}
session.save()
println "引用更新完成，共处理${nodes.size()}个节点"

注意：执行前务必备份AEM实例，先在测试环境验证脚本效果

三、同步发布与缓存清理 #

• 先发布重命名后的XF文件夹及其所有子内容
• 再发布所有更新了引用的页面、组件，确保线上环境同步
• 若有CDN或AEM Dispatcher缓存，操作完成后需清除对应缓存，避免用户看到旧内容

额外注意点 #

• 重命名前必须备份AEM实例，防止操作失误导致数据丢失
• 检查是否有第三方集成（如CRM、营销自动化工具）引用了旧XF路径，同步更新这些外部配置

内容的提问来源于stack exchange，提问作者scura s