问题

如何调试 Zendesk 应用框架 (ZAF)?

回答

Zendesk 应用框架允许您构建具有复杂功能和特性的应用。本文章提供了关于如何在最常见的场景中解决问题的指南。

免责声明:Zendesk 客户支持仅可协助演示 Zendesk 应用框架 (ZAF) 的功能和功能。任何关于自定义代码或实施的问题都必须与应用开发者讨论。

要解决这些问题,请按照以下步骤操作:

  • 捕获错误
  • 生成已安装应用的列表
  • 识别应用
  • 生成 HAR 文件
  • 使用应用 API

捕获错误

使用浏览器的开发者工具。如果应用出现意外行为,请使用浏览器开发者工具收集错误列表,以便进一步研究。

在不同的浏览器中访问开发者工具:

  • Chrome:打开 Chrome 开发者工具 
  • Firefox:Web 控制台 
  • Safari:在 Mac 上的 Safari 浏览器中使用“开发”菜单中的开发者工具 
  • Microsoft Edge:打开 Microsoft Edge 开发者工具

控制台将显示任何错误或警告消息。有关网络请求错误,请查看该工具的网络标签。

生成已安装应用的列表

生成帐户中已安装的所有应用的列表。

API 端点 List App Installations 生成已安装应用的 JSON 列表。包含的属性可用于 noapps 和 app_ids 稍后讨论的查询参数:

  • enabled:表示应用当前是否处于活跃的状态
  • app_id: 应用的 ID。当使用 app_ids参数。
  • 安装 ID:应用的安装 ID。这可以选择用于 noapps参数。如果应用允许,应用可以安装多次。每次安装都有不同的安装 ID,但应用 ID 相同。

要访问端点:

  • 使用 curl
    curl https://{subdomain}.zendesk.com/api/v2/apps/installations.json\
    -u{email_address}:{password}
  • 或附加 /api/v2/apps/installations.json 到帐户的子域名 URL:
    https://your_subdomain.zendesk.com/api/v2/apps/installations.json

您必须是 Zendesk 帐户中的专员

识别应用

有选择地取消激活应用以找出问题所在。取消激活应用:

  • 在 Support 中,按照这篇文章中的说明进行操作:管理您已安装的应用。
  • 或者,附加 ?noapps 工单 URL 后缀:
https://your_subdomain.zendesk.com/agent/tickets/123456?noapps

生成 HAR 文件

HAR 文件是用于跟踪浏览器和网站之间的信息和事件的标准格式。在 HAR 文件中记录网络事件,以解决性能或呈现问题。要生成 HAR 文件,请参阅文章:正在生成 HAR 文件以进行故障排除。

使用应用 API

利用 API 端点 List App Installations 生成已安装应用的列表,排除故障。在 JSON 响应中包含的属性中,使用 安装 ID 作为查询参数 noapps 同时禁用多个应用:

https://your_subdomain.zendesk.com/agent/tickets/123456?noapps=11111,22222,44444

如果您想了解如何从头开始构建 Support 应用,请参阅文章:构建您的首个 Support 应用——第 1 部分:奠定基础。如果您需要关于如何构建服务器端应用的信息,请参阅文章:构建服务器端应用——第 1 部分:核心概念。

翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性

如对翻译准确性有任何疑问,请以文章的英语版本为准。

由 Zendesk 提供技术支持