如何通过数据库脚本修改Kentico 10 Web Part内容及批量修正无效链接

作为长期处理Kentico数据库操作的开发者，我来一步步帮你解决批量修正Web Part中超链接的问题。Kentico的Web Part内容存储在特定的数据库表中，我们可以通过SQL查询定位目标内容，再批量替换。

第一步：查询所有已发布页面的Web Part内容 #

Kentico中，已发布页面的Web Part实例信息存储在CMS_WebPartInstance表，每个Web Part的配置和内容（比如富文本）以XML格式保存在WebPartProperties字段。我们需要关联页面表CMS_Document和模板实例表CMS_PageTemplateInstance来筛选已发布的内容：

SELECT
    d.DocumentID,
    d.DocumentName AS 页面名称,
    d.DocumentURLPath AS 页面URL路径,
    wpi.WebPartInstanceID,
    wpi.WebPartName AS WebPart名称,
    wpi.WebPartProperties AS WebPart配置XML
FROM
    CMS_Document d
JOIN
    CMS_PageTemplateInstance pti 
    ON d.DocumentPageTemplateInstanceID = pti.PageTemplateInstanceID
JOIN
    CMS_WebPartInstance wpi 
    ON pti.PageTemplateInstanceID = wpi.PageTemplateInstanceID
WHERE
    d.DocumentPublished = 1 -- 只筛选已发布页面
    -- 可选：如果只需要处理特定WebPart（比如富文本编辑器），添加以下条件
    AND wpi.WebPartName = 'EditableText'

补充说明： #

• WebPartProperties是XML类型，你可以先导出几条记录查看结构，确认内容字段的位置（比如EditableText的内容通常在<Content>节点下）。
• 如果要直接提取XML中的具体内容，可以用value()函数，比如：

  SELECT
      -- 提取EditableText的富文本内容
      wpi.WebPartProperties.value('(/properties/Content)[1]', 'NVARCHAR(MAX)') AS WebPart内容
  FROM CMS_WebPartInstance wpi
  WHERE wpi.WebPartName = 'EditableText'
  

第二步：批量替换Web Part中的无效链接 #

确认目标内容后，我们可以通过SQL的字符串替换+XML类型转换来批量修正链接。下面是一个示例脚本，假设要把所有EditableText WebPart中的/old-invalid-path/替换为/corrected-path/：

-- 第一步：先执行SELECT验证要更新的记录和替换效果
SELECT
    d.DocumentName,
    wpi.WebPartProperties.value('(/properties/Content)[1]', 'NVARCHAR(MAX)') AS 原内容,
    REPLACE(wpi.WebPartProperties.value('(/properties/Content)[1]', 'NVARCHAR(MAX)'), '/old-invalid-path/', '/corrected-path/') AS 替换后内容
FROM
    CMS_WebPartInstance wpi
JOIN
    CMS_PageTemplateInstance pti ON wpi.PageTemplateInstanceID = pti.PageTemplateInstanceID
JOIN
    CMS_Document d ON pti.PageTemplateInstanceID = d.DocumentPageTemplateInstanceID
WHERE
    d.DocumentPublished = 1
    AND wpi.WebPartName = 'EditableText'
    AND wpi.WebPartProperties.value('(/properties/Content)[1]', 'NVARCHAR(MAX)') LIKE '%/old-invalid-path/%'

-- 第二步：确认无误后执行更新（记得先备份数据库！）
UPDATE wpi
SET WebPartProperties = 
    CAST(
        REPLACE(
            CAST(wpi.WebPartProperties AS NVARCHAR(MAX)),
            '/old-invalid-path/',
            '/corrected-path/'
        ) AS XML
    )
FROM
    CMS_WebPartInstance wpi
JOIN
    CMS_PageTemplateInstance pti ON wpi.PageTemplateInstanceID = pti.PageTemplateInstanceID
JOIN
    CMS_Document d ON pti.PageTemplateInstanceID = d.DocumentPageTemplateInstanceID
WHERE
    d.DocumentPublished = 1
    AND wpi.WebPartName = 'EditableText'
    AND CAST(wpi.WebPartProperties AS NVARCHAR(MAX)) LIKE '%/old-invalid-path/%'

关键注意事项： #

• 备份优先：执行任何数据库更新前，一定要备份整个数据库，避免操作失误导致数据损坏。
• 验证先行：先运行SELECT语句确认要更新的记录和替换效果，没问题再执行UPDATE。
• XML结构适配：不同WebPart的XML结构可能不同，比如有些富文本WebPart的内容字段可能是HTMLContent而非Content，需要根据实际XML结构调整路径。
• 清除缓存：更新完成后，登录Kentico后台清除站点缓存（系统>缓存>清除缓存），否则页面可能还是显示旧内容。
• 特殊字符处理：如果要替换的字符包含SQL特殊符号，需要转义处理，避免语法错误。

内容的提问来源于stack exchange，提问作者Hugo Barona