Adobe Experience Manager 6.5.21.0 aem-service-pack-release-notes

支持 Oauth 凭据：提供一种全新且更易用的凭据，用于服务器间身份验证，以取代现有的服务帐户（JWT）凭据。（NPR-41994）

AEM Forms 中的规则编辑器增强功能：

• 支持使用 When-then-else 功能实现嵌套条件。
• 验证或重置面板和表单（包括字段）。
• 在自定义函数中支持现代 JavaScript 特性，如 let 和箭头函数（支持 ES10）。

适用于 PDF 辅助功能的 AutoTag API：OSGi 上的 AEM Forms 现已支持新的 AutoTag API，可通过添加段落和列表等标记来增强 PDF 的无障碍标准。此功能可让使用辅助技术的用户更方便地访问 PDF。

16 位 PNG 支持：PDF Generator 的 ImageToPdf 服务现已支持将具有 16 位色深的 PNG 转化为 PDF。

将工件应用于 XDP 中的单个文本块：Forms Designer 现在允许用户在 XDP 文件中的单个文本块上配置设置。通过此功能，您可以控制在生成的 PDF 中哪些元素会被视为工件。这些元素（如页眉和页脚）可供辅助技术访问，从而提升无障碍性。主要功能包括：可将文本块标记为工件，并将这些设置嵌入到 XDP 元数据中。表单输出服务会在生成 PDF 时应用这些设置，以确保正确的 PDF/UA 标记。

AEM Forms Designer 已通过 GB18030:2022 标准认证：凭借 GB18030:2022 认证，Forms Designer 现已支持中文 Unicode 字符集，允许您在所有可编辑字段和对话框中输入中文字符。

在 JEE 服务器中支持 WebToPDF 路由：PDF Generator 服务现已支持 WebToPDF 路由，可在 JEE 上将 HTML 文件转化为 PDF 文档，除此之外还支持现有的 Webkit 和 WebCapture（仅限 Windows）路由。此前 WebToPDF 路由已在 OSGi 上提供，并扩展到 JEE。现在，在 JEE 和 OSGi 平台上，PDF Generator 服务均支持以下跨不同操作系统的路由：

• Windows：Webkit、WebCapture、WebToPDF
• Linux®：Webkit、WebToPDF

在 AEM 6.5.18 中，编辑热点时不会显示已添加到资产的所有热点。但是，在已发布的资产中所有热点均可正常工作，但之后若需要则无法再次编辑这些热点。（ASSETS-33609）

最新上传的 EPS 文件在重新处理后未生成缩略图。（ASSETS-32617）

在“工具 > 资产 > Dynamic Media 发布设置 > 请求属性”选项卡中，输入项 Width(px) 和 Height(px) 在西班牙语、意大利语和葡萄牙语界面下显示不同。在这些语言环境中，它们彼此未对齐。（ASSETS-31896）

自 2024 年 5 月 1 日起，Adobe Dynamic Media 停止对以下功能提供支持：

• SSL（安全套接字层）2.0

• SSL 3.0

• TLS（传输层安全性）1.0 和 1.1

• TLS 1.2 中的以下弱密码：

  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
  • TLS_RSA_WITH_AES_256_GCM_SHA384
  • TLS_RSA_WITH_AES_256_CBC_SHA256
  • TLS_RSA_WITH_AES_256_CBC_SHA
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
  • TLS_RSA_WITH_AES_128_GCM_SHA256
  • TLS_RSA_WITH_AES_128_CBC_SHA256
  • TLS_RSA_WITH_AES_128_CBC_SHA
  • TLS_RSA_WITH_CAMELLIA_256_CBC_SHA
  • TLS_RSA_WITH_CAMELLIA_128_CBC_SHA
  • TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA
  • TLS_RSA_WITH_SDES_EDE_CBC_SHA

当从 Adobe Experience Manager 发布实例将自适应表单提交到 Adobe Experience Manager 工作流时，该工作流无法保存附件。（FORMS-14209）

在 OSGi 上的 AEM Forms 服务包 15（6.5.15.0）中，当用户点击​ 打印为 PDF ​时，客户端验证失败，开发者工具控制台窗口中会显示错误消息。（FORMS-14029）

在 AEM 6.5 Forms 服务包 17（6.5.17.0）、服务包 18（6.5.18.0）或服务包 19（6.5.19.0）中，当用户提交表单时，“感谢”消息的翻译无法正常工作。但是，这些消息在字典中已被正确翻译。（FORMS-13846）

当用户预览包含日期选择器组件的表单时，日期选择器字段与其他表单字段未对齐。（FORMS-13763）

在 AEM Forms 服务包 19（6.5.19.0）环境中，当用户通过调用 API 来格式化数字时，格式化后的数字未与相应的区域设置对齐。因此，货币符号无法正确显示。无论区域设置参数设置为 "de_DE" 还是 "en_US"，此问题都会持续存在。（FORMS-13759）

在 AEM Forms 服务包 19（6.5.19.0）环境中，用户使用 Img2Pdf PDFG 服务将 16 位 PNG 转化为 PDF 时失败，且无法“使用 Acrobat 图像转化”服务。（FORMS-13754）

在 AEM Forms 服务包 19（6.5.19.1）中，当用户在 AEM Forms JEE 的 adminui 界面的 Services / PDF Generator / Adobe PDF Settings 部分上传现有的 JobOptions 文件时，上传失败。它还会显示以下错误消息（FORMS-13597）：
"An error has occurred while processing your request. Please use the breadcrumb links to navigate to another page."

当用户从 AEM Forms 服务包 15（6.5.15.0）迁移到 AEM Forms 服务包（6.5.17.0）或 AEM Forms 服务包（6.5.19.0）时，FD 键会出现重复，导致表单无法正确翻译。（FORMS-13461）

当用户在 AMS 部署拓扑支持的作者节点前放置 Dispatcher 时，分配任务的提交流程会卡住或失败。（FORMS-8010）

与辅助功能相关的修复：

• “formsanddocuments” 页面上的图标现已符合 ANDI 标准的无障碍要求。（FORMS-13094）
• 用户现在可以通过键盘访问工具栏，以在编辑页面上保存或编辑内容，工具栏已根据 ANDI 标准进行增强。（FORMS-13102）
• “必填”表单字段现已符合 ANDI 标准的无障碍要求。（FORMS-13097）

当用户在页面加载时尝试查看表单时，表单无法渲染。（FORMS-13594）

在 Microsoft Edge 的 Internet Explorer 兼容模式下，日期输入字段组件无法正常工作。（FORMS-13170）

当在服务器上对使用带附件电子邮件的附加步骤进行修复时，包含附件的电子邮件通知会停滞并无法发送。（FORMS-14227）

在服务包 18（6.5.18.0）的 AEM Forms 工作区中，当用户对任意已上传文档发表评论时，会导致该文档文件损坏。（FORMS-13735）

在 AEM Forms 服务包 18（6.5.18.0）、服务包 19（6.5.19.0）或服务包 20（6.5.20.0）中，当用户尝试从侧边面板搜索自适应表单时，搜索会失败。（FORMS-14117）

当用户编辑一份用德语创建并翻译为英语的表单时，会导致“预览”和“编辑”模式之间的语言显示不一致。在“编辑”模式下，单选按钮和复选框组件会显示为英文，而在“预览”模式下则正确显示为德文。（FORMS-13910）

流程清理工具执行失败，并报错 NoClassDefFoundError: org/omg/CORBA/UserException。（FORMS-13751）

当用户使用嵌入容器将自适应表单（AF）嵌入到网页（无论是外部网页还是 AEM Sites 页面）时，自适应表单引导容器会引入一个 ARIA LABEL。该标签为嵌入表单设置了 role="main"。根据 ARIA 指南，每个页面只能有一个 role="main"。因此，当用户为页面的主要内容添加另一个 role="main" 时，就会被标记为辅助功能问题。（FORMS-13538）

在 AEM Forms 服务包 19（6.5.19.0）中，当在自适应表单中使用下拉列表时，带有占位符文本的下拉列表会保留 id="emptyValue" 的值。因此，如果一个表单包含多个下拉组件，每个组件都会具有 id="emptyValue"，这不符合 ARIA 指南的要求。（FORMS-13370）

当用户在通过 XML 提交数据后重新加载交互式通信时，生成的 PDF 内的文本块之间会出现空白。（FORMS-13481）

在运行 ConfigurationManager 时，“准备 DSC 部署步骤”界面缺少 IPH。（FORMS-10699）

当用户在已有字典的基础上添加新字典以翻译表单时，旧的翻译会失效。出现以下问题：（FORMS-13576）

• 部分字段未能填充翻译后的数据。
• 部分字段未被翻译为新语言，尽管数据已成功保存到字典中。

当用户在 AEM Forms 服务包 19（6.5.19.0）环境中使用 AEM Forms Designer 向现有表单添加新表格时，系统会崩溃。（LC-3921978）

当用户在 Linux® 环境中渲染自适应表单时，字段组件之间会出现额外空白。（LC-3921957）

当用户使用输出服务将 XTG 文件转化为 PostScript 格式时，操作失败并出现以下错误： (AEM_OUT_001_003:Unexpected Exception: PAExecute Failure: XFA_RENDER_FAILURE)。（LC-3921720）

解决此问题的方法：
请检查数据中是否包含特殊字符，如零宽空格（0x200b）。如果存在，请在 XCI 文件中添加以下标记以启用该标志：<behaviorOverride>patch-LC3921720:1</behaviorOverride>。示例可参考 custom_xfa.xci 文件。

在 Linux® 环境中使用 AEM Forms 服务包 18（6.5.18.0）时，如果 AMD® 处理器的 CPU 不支持 AVX / AVX2 指令，XMLFM 会发生崩溃。（LC-3921718）

当用户使用表单输出服务从 XDP 生成 PDF 时，无法在 XDP 中针对“单个文本块”配置“设置”，以控制哪些内容被标记为“工件”。（LC-3921954）

AEM 6.5 服务包 15 会持续生成包含大量条目的错误日志。报告的问题如下：

• 在路径 /libs/granite/ui/content/shell/start.html 处缺少资源，导致出现 404 INFO 错误
• 错误日志中记录了一条未捕获的 SlingException，原因是 CampaignsDataSourceServlet.java:147 处发生 NullPointerException

错误日志不应充斥频繁且大量的错误条目；AEM 实例应能正常运行，不应出现与资源缺失或异常相关的问题。（CQ-4357064）

AEM 6.5.21-6.5.23 和 AEM 6.5 LTS GA 中的 JSP 脚本包问题
AEM 6.5.21、6.5.22、6.5.23 和 AEM 6.5 LTS GA 随附的 org.apache.sling.scripting.jsp:2.6.0 捆绑包存在已知问题。该问题通常在高负载情况下出现，即当 AEM 实例处理大量并发请求时发生。

当出现此问题时，错误日志中可能会出现以下异常之一，并会引用 org.apache.sling.scripting.jsp:2.6.0：

• java.io.IOException: classFile.delete() failed
• java.io.IOException: tmpFile.renameTo(classFile) failed
• java.lang.ArrayIndexOutOfBoundsException: Index 0 out of bounds for length 0
• java.io.FileNotFoundException

出现该错误后，唯一的恢复方法是重启 AEM 实例。

请联系 Adobe 客户支持，并引用本发行说明以获取解决方案。

与 Oak 相关
自服务包 13 起及更高版本中，开始出现以下错误日志，从而影响持久化缓存：

org.h2.mvstore.MVStoreException: The write format 1 is smaller than the supported format 2 [2.0.202/5]
at org.h2.mvstore.DataUtils.newMVStoreException(DataUtils.java:1004)
    at org.h2.mvstore.MVStore.getUnsupportedWriteFormatException(MVStore.java:1059)
    at org.h2.mvstore.MVStore.readStoreHeader(MVStore.java:878)
    at org.h2.mvstore.MVStore.<init>(MVStore.java:455)
    at org.h2.mvstore.MVStore$Builder.open(MVStore.java:4052)
    at org.h2.mvstore.db.Store.<init>(Store.java:129)

或者

org.h2.mvstore.MVStoreException: The write format 1 is smaller than the supported format 2 [2.1.214/5].

要解决此异常，请执行以下操作：

1. 从 crx-quickstart/repository/ 中删除以下两个文件夹

   • cache
   • diff-cache

2. 安装服务包，或重新启动 Experience Manager as a Cloud Service。
   新的 cache 和 diff-cache 文件夹会自动创建，并且不会再在 error.log 中遇到与 mvstore 相关的异常。

请将可能使用了自定义 API 名称的 GraphQL 查询更新为使用内容模型的默认名称。

GraphQL 查询可能会使用 damAssetLucene 索引，而不是 fragments 索引。此操作可能导致 GraphQL 查询失败或运行时间过长。

要解决该问题，必须在 /indexRules/dam:Asset/properties 下配置 damAssetLucene，以添加以下两个属性：

• contentFragment

  • jcr:primaryType="nt:unstructured"
  • name="jcr:content/contentFragment"
  • propertyIndex="{Boolean}true"
  • type="Boolean"

• model

  • jcr:primaryType="nt:unstructured"
  • name="jcr:content/data/cq:model"
  • ordered="{Boolean}true"
  • propertyIndex="{Boolean}true"
  • type="String"

在修改索引定义后，需要重新索引（reindex = true）。

完成以上步骤后，GraphQL 查询的性能应会提升。

在尝试移动、删除或发布内容片段、网站或页面时，获取内容片段引用时会出现问题。后台查询失败。也就是说，该功能无法正常工作。
为确保该功能正常运行，必须将以下属性添加到索引定义节点 /oak:index/damAssetLucene（无需重新索引）：

"tags": [
    "visualSimilaritySearch"
  ]
"refresh": true

如果您在 Java™ 11 上将 Experience Manager 实例从 6.5.0–6.5.4 升级到最新的服务包，可能会在 error.log 文件中看到 RRD4JReporter 异常。要停止这些异常，请重新启动 Experience Manager 实例。

用户可以在 Assets 的层级结构中重命名文件夹，并将嵌套文件夹发布到 Brand Portal。但是，在 Brand Portal 中，文件夹标题不会更新，直到重新发布根文件夹。

在安装 Experience Manager 6.5.x.x 期间，可能会显示以下错误和警告消息：

• 当在 Experience Manager 中使用 Target Standard API（IMS 身份验证）配置 Adobe Target 集成时，将体验片段导出到 Target 会导致创建错误的产品建议类型。在 Target 中，系统不会创建类型为“Experience Fragment”/来源为“Adobe Experience Manager”的产品建议，而是会创建多个类型为“HTML”/来源为“Adobe Target Classic”的产品建议。
• com.adobe.granite.maintenance.impl.TaskScheduler：未在 granite/operations/maintenance 找到维护窗口。
• 当在自适应表单中使用 SUM、MAX 和 MIN 等聚合函数时，服务器端验证失败（CQ-4274424）。
• com.adobe.granite.maintenance.impl.TaskScheduler：未在 granite/operations/maintenance 找到维护窗口。
• 通过 Shoppable Banner 查看器预览资产时，Dynamic Media 交互式图像中的热点不可见。
• com.adobe.cq.social.cq-social-jcr-provider bundle com.adobe.cq.social.cq-social-jcr-provider:1.3.5 (395)[com.adobe.cq.social.provider.jcr.impl.SpiSocialJcrResourceProviderImpl(2302)]：等待完成取消注册的注册变更时超时。

从 AEM 6.5.15 开始，由 org.apache.servicemix.bundles.rhino 捆绑包提供的 Rhino JavaScript 引擎引入了新的提升行为。使用严格模式（use strict;）的脚本必须声明正确的变量。否则脚本将无法运行，并会抛出运行时错误。

通过官方更新包安装与标记相关的开箱即用内容时，/content/cq:tags 节点的语言属性会被重置为默认值。此操作适用于服务包、安全服务包、扩展功能包、累积功能包、补丁等。因此，在安装之前必须从属性中手动添加该项。

在安装 AEM Forms JEE 服务包 21（6.5.21.0）后，如果您在 <AEM_Forms_Installation>/lib/caching/lib 文件夹下发现 Geode jar 的重复条目 (geode-*-1.15.1.jar and geode-*-1.15.1.2.jar)（FORMS-14926），请执行以下步骤以解决该问题：

1. 如果定位器正在运行，请先停止定位器。
2. 停止 AEM 服务器。
3. 进入 <AEM_Forms_Installation>/lib/caching/lib。
4. 移除所有 Geode 补丁文件，仅保留 geode-*-1.15.1.2.jar。确认仅存在 version 1.15.1.2 的 Geode jar。
5. 以管理员模式打开命令提示符。
6. 使用 geode-*-1.15.1.2.jar 文件安装 Geode 补丁。

如果用户尝试使用已保存的 XML 数据预览草稿信件，某些特定信件会卡在 Loading 状态。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 修补程序文章。（FORMS-14521）

在升级到 AEM Forms 服务包 6.5.21.0 后，PaperCapture 服务无法对 PDF 执行 OCR（光学字符识别）操作。该服务不会生成 PDF 输出文件或日志文件。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 热修复补丁文章。（CQDOC-21680）

当用户从 AEM 6.5 Forms 服务包 18（6.5.18.0）或 AEM 6.5 Forms 服务包 19（6.5.19.0）升级到 AEM 6.5 Forms 服务包 20（6.5.20.0）或 AEM 6.5 Forms 服务包 21（6.5.21.0）时，会遇到 JSP 编译错误。该错误会阻止用户打开或创建自适应表单，并导致其他 AEM 界面（如页面编辑器、AEM Forms UI、AEM 工作流编辑器和 AEM 系统概览 UI）出现错误。（FORMS-15256）

如果遇到此类问题，请执行以下步骤进行解决：

1. 进入 CRXDE 中的目录 /libs/fd/aemforms/install/。
2. 删除名为 com.adobe.granite.ui.commons-5.10.26.jar 的捆绑包。
3. 重新启动 AEM 服务器。

当用户更新至安装了 Forms 附加组件的 AEM Forms 服务包 20（6.5.20.0）时，使用基于用户凭据身份验证的 Adobe Analytics 旧版云服务的配置将无法正常工作，导致分析规则执行失败。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 热修复补丁文章。（FORMS-15428）

当用户在 JEE 服务器上更新至 AEM Forms 服务包 20（6.5.20.0），并使用输出服务生成 PDF 时，生成的 PDF 会出现可访问性问题。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 热修复补丁文章。（LC-3922112）

当用户在 JEE 上使用输出服务生成带标记的 PDF 时，会显示“结构不当警告”。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 热修复补丁文章。（LC-3922038）

当在 AEM Forms JEE 上提交表单时，数据中的重复 XML 元素实例会被移除。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 热修复补丁文章。（LC-3922017）

当用户在 Linux® 环境中以 HTML 形式渲染自适应表单（运行于 JEE）时，表单无法正常渲染。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 热修复补丁文章。（LC-3921957）

当用户在 AEM Forms JEE 上使用输出服务将 XTG 文件转化为 PostScript 格式时，转化失败并出现以下错误：AEM_OUT_001_003: Unexpected Exception: PAExecute Failure: XFA_RENDER_FAILURE。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 热修复补丁文章。（LC-3921720）

在 JEE 服务器上升级到 AEM Forms 服务包 18（6.5.18.0）后，当用户提交表单时，无法渲染 HTML5 或 PDF Forms，并且 XMLFM 会崩溃。要下载并安装热修复补丁，请参阅 Adobe Experience Manager Forms 热修复补丁文章。（LC-3921718）

在交互式通信代理 UI 的打印预览中，货币符号（如美元符号 $）在各字段值中的显示不一致。对于不超过 999 的数值会显示符号，但对于 1000 及以上的数值则缺少符号。（FORMS-16557）

在交互式通信中，对嵌套布局片段的 XDP 所做的任何修改都不会反映在 IC 编辑器中。（FORMS-16575）

在交互式通信代理 UI 的打印预览中，部分计算值未正确显示。（FORMS-16603）

在打印预览中查看信件时，内容会发生变化。部分空格会消失，某些字母会被替换为 “x”。（FORMS-15681）