文档AEM GuidesAEM Guides 文档

升级AEM Guides as Cloud Service的其他配置

Last update: Tue Mar 17 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 用户
INFO
如果您已配置自定义文件夹配置文件设置(ui_config.json)，则本文适用。 在每次升级后，根据需要查看并修改设置，以确保与最新更改兼容。

根据您从中升级的版本，可能需要额外的配置步骤才能集成较新Cloud Service版本中引入的更改。

某些配置仅适用于特定版本。 请确保参阅以下配置部分，并应用适用于您的设置的所需配置。

对所有输出预设的DITAVAL文件应用搜索过滤器的步骤

要确保过滤器正常运行，请更新ui_config.json。 更改​browseFilters > 非DITA文件 > Ditaval文件​下列出的属性，如下所示：

{
  "title": "Ditaval Files",
  "property": "LOWER_NAME",
  "operation": "like",
  "value": ".ditaval"
}

为内容片段执行B树迁移的步骤

如果未显示内容片段的引用，您可以选择运行迁移作业：

发帖：

http://localhost:4503/bin/guides/script/start?jobType=cf-reference-store-btree-migration

响应：

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886",
"status": "SCHEDULED"
}

在上一个响应JSON中，键lockNodePath保存存储库中创建的节点的路径，该路径指向提交的作业。 作业完成后会自动将其删除。 您可以引用此节点来了解作业的状态。

请等待此作业完成，然后再继续后续步骤。

NOTE
您应该检查节点是否仍然存在，以及作业的状态。

GET：

http://<aem_domain>/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886.json

处理'fmdita rewriter'冲突的步骤

Experience Manager Guides有一个​ 自定义sling重写器 ​模块，用于处理在交叉映射（两个不同映射的主题之间的链接）情况下生成的链接。

如果您的代码库中有另一个自定义sling重写器，请使用大于50的'order'值，因为Experience Manager Guides sling重写器使用'order' 50。 要覆盖此值，您需要一个大于50的值。 有关详细信息，请查看输出重写管道。

在此升级过程中，由于'order'值从1000更改为50，因此您需要将现有的自定义重写器（如果有）与fmdita-rewriter合并。

适用于2023年6月之前版本的配置

仅当您使用在2023年6月之前发布的Experience Manager Guides as a Cloud Service版本时，才需要执行以下配置。 展开下面的相关部分以应用必要的设置并确保与必要的更新兼容。

为现有内容编制索引以使用“报表”选项卡下的新查找和替换以及主题列表的步骤

执行以下步骤来索引现有内容，并在报表选项卡下的映射级别和主题列表中使用新的查找和替换文本：

  1. 对服务器运行POST请求（使用正确的身份验证） — http://<server:port>/bin/guides/map-find/indexing。 （可选：您可以传递映射的特定路径来索引它们，默认情况下，所有映射都已索引||示例： https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>）

  2. 您还可以传递根文件夹来索引特定文件夹（及其子文件夹）的DITA映射。 例如，http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test。请注意，如果同时传递了路径参数和根参数，则只考虑路径参数。

  3. API返回jobId。 要检查作业的状态，可以将带有作业ID的GET请求发送到同一终结点 — http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}（例如： http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678）

  4. 作业完成后，先前的GET请求会做出成功响应，并提及是否有任何映射失败。 可以从服务器日志中确认已成功编制索引的映射。

后处理现有内容以使用断开链接报表的步骤

执行以下步骤对现有内容进行后处理，并使用新的断开链接报表：

  1. （可选）如果系统中有超过100,000个DITA文件，请将queryLimitReads下的queryLimitInMemory和org.apache.jackrabbit.oak.query.QueryEngineSettingsService更新为更大的值（任何大于现有资产数的值，例如200,000），然后重新部署。

    • 按照安装和配置Adobe Experience Manager Guides as a Cloud Service中的​ 配置覆盖 ​部分中提供的说明创建配置文件。

    • 在配置文件中，提供以下（属性）详细信息以配置queryLimitReads和queryLimitInMemory选项：

      table 0-row-3 1-row-3 2-row-3
      PID 属性键 属性值
      org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitRead 值：200000默认值：100000
      org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory 值：200000默认值：100000

  2. 对服务器运行POST请求（使用正确的身份验证） — http://<server>//bin/guides/reports/upgrade。

  3. API返回jobId。 要检查作业的状态，可以将带有作业ID的GET请求发送到同一端点 — http://<server>/bin/guides/reports/upgrade?jobId= {jobId}
    （例如： http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678）

  4. 作业完成后，上一个GET请求会做出成功响应。 如果作业由于某个原因失败，则可以从服务器日志中看到失败。

  5. 如果您在步骤1中更改了queryLimitReads的值，请恢复为默认或以前的现有值。

通过servlet启用脚本触发器的步骤

完成安装后，您可以选择启动翻译作业：

发帖：

code language-none 
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

响应：

code language-none 
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

在上一个响应JSON中，键lockNodePath保存指向在存储库中创建的指向已提交作业的节点的路径。 作业完成后会自动将其删除，然后您可以引用此节点来了解作业的状态。

请等待此作业完成，然后再继续后续步骤。

note note
NOTE
您应该检查节点是否仍然存在，以及作业的状态。
code language-none 
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178