宣布推出帮助中心无障碍功能更新和模板化 API v4

宣布日期	开始推行	结束推行
2024 年 7 月 2 日	2024 年 7 月 2 日	待定

Zendesk 很高兴地宣布，我们即将发布模板化 API v4，并推出 Copenhagen 主题的相应更新。这些更新针对 Zendesk 帮助中心开箱即用的终端用户体验进行了超过 100 项无障碍功能改进，同时还改进了开发者体验和安全性。

此公告包括以下主题：

有什么变化？

自从发布模板化 API v3 以来，我们已对模板化 API 和 Copenhagen 主题进行了超过 100 项无障碍功能改进，共同打造了开箱即用的帮助中心终端用户体验。

其中一个原因是，我们现在在更多的 Copenhagen 主题中使用了 Zendesk Garden Designer System 组件库。最值得注意的是，我们已使用 Garden 完全重新实施了帮助中心的请求表格。

Garden 是一个基于 React 的 UI 组件库，已针对可用性和无障碍功能进行了优化，并由用户体验和无障碍功能方面的 Garden 专业团队不断进行更新和维护。这样，终端用户就可以充分利用 Zendesk Garden 的所有可用性和无障碍功能优势。

一个值得注意的变化是，请求表格 HTML 已从服务器端呈现更改客户端呈现（使用 Zendesk Garden 组件作为主题的一部分）。这意味着您现在可以直接从主题代码自定义请求表格的 UI，甚至可以根据需要使用 Garden 以外的 UI 组件库。

对开发者而言另一项显著改进是 JSON 序列化助手，它更便于通过 JavaScript 在前端使用来自模板化 API 的服务器端呈现数据。

新请求表格更新了 Copenhagen 主题，这还意味着请求表格中的信用卡字段默认仅接受信用卡的后四位数。这样做是为了确保请求表格在使用信用卡字段时满足 PCI 合规。

这项措施可以防止终端用户的信用卡信息被盗，例如在使用可侦听击键的恶意浏览器插件时。

从模板化 API v4 开始，原生请求表格将遵守“需要身份验证以请求和上传 API”安全设置。换言之，如果您使用模板化 API V4 的主题，并启用了“需要身份验证以请求和上传 API”设置，则匿名终端用户（未登录用户）将无法附加文件到请求表格。

如果您已启用此设置，并使用 Copenhagen 标准主题，则此更改将在推行过程中自动升级您的主题时实施。如果您不喜欢此更改，可以将您的主题转换为自定义主题并继续使用模板化 API v3，或取消激活“需要身份验证以请求和上传 API”设置。

我们作出此项更改的目的是：

如果您使用的是标准 Copenhagen 主题，则无需进行任何操作。您的主题将自动升级以使用模板化 API v4。

如果您使用的是自定义主题，则需要在主题清单文件中将您正在使用的模板化 API 升级到 v4。请参阅升级模板化 API v3。

升级之前，请检查主题中是否有已弃用的助手或助手标记，不同版本中的助手或助手标记可能已经发生变化。

您可在以下位置找到不同版本的模板化 API 的变化：

多个高级模板助手在 v4 中的输出略有不同。您可以切换版本标签，查看 v2 和 v4 输出之间的区别。有关更多信息，请参阅开发者文档中的模板化 API。

为确保您的自定义功能在升级时不会中断，建议您在升级到 v4 之前，先对所有使用已更新的助手或目标模式对话框的主题自定义进行测试。

如果您使用的是标准许可证的 Zendesk 主题市场主题，请询问该主题的开发者是否计划更新到 v4。如果是，您可以在发布更新后更新主题。

如果您使用的是使用代码自定义的市场主题，您可以按照自定义主题的说明进行操作，也可以联系主题开发者，询问他们是否有任何特定的更新说明。

如果您对此公告有任何反馈或疑问，请访问我们的社区论坛，我们将在这里收集和管理客户对产品的反馈。如需获取关于 Zendesk 产品的常规帮助，请联系 Zendesk 客户支持。