同步 Zendesk 和Jira字段

What's my plan?

All Suites

Team, Growth, Professional, Enterprise, or Enterprise Plus

Support

Team, Professional, or Enterprise

已验证人工智能概要 ◀▼

字段同步功能Support和Jira之间进行实时数据同步，从而增强支持团队和工程团队之间的协作。通过映射Jira问题字段到工单字段，您可以有效地共享信息。请注意，同步是单向的，不支持Jira Data Center 或 Server。在沙盒环境中测试配置，并使用整合日志排除错误。

字段同步功能支持在 Zendesk Support 和 Jira 之间实现近乎实时的数据同步。这样两个系统之间可以共享信息，以便支持和工程团队之间更好地协作。具体方法是将 Jira 问题字段映射到 Zendesk Support 工单字段。

注意：此整合不支持Jira Data Center 和Jira Server，因为 Atlassian 计划停用这些平台。请参阅 Atlassian 关于 Jira数据中心 和 Jira服务器 的公告。

本文章包含以下主题：

• 要求和限制
• 设置字段同步
• 关闭字段同步

相关文章：

• 配置适用于Zendesk Support的Jira应用
• 设置适用于Jira的 Zendesk 工单视图

要求和限制

• 数据同步后无法轻松移除。但是，您可以完全关闭字段同步，从而禁用所有字段链接。
• 不支持相同字段的双向同步。
• 字段映射屏幕会在一个列表中显示来自所有 Jira 项目的自定义字段类型。
• 自定义工单状态字段不受支持，无法映射。
• 特定问题或工单的所有已映射字段均可通过一次 API 调用进行更新。如果映射字段配置错误，则所有字段都不会更新。

字段类型同步兼容性

兼容同步的字段类型有一些限制。例如，显示数字的 Zendesk 小数字段无法与 Jira 多行文本字段同步。

下表列出了字段映射兼容性。

表 1.Zendesk 工单字段和兼容的 Jira 问题字段

字段标题/类型	显示类型	兼容的 Jira 问题字段类型
优先级（默认）	下拉列表 注意：无法将 Zendesk 优先级字段同步到 Jira 优先级字段	文本字段（只读） 选择列表 文本字段（单行） 文本字段（多行）
类型（默认）	下拉列表	文本字段（只读） 选择列表 文本字段（单行） 文本字段（多行）
日期（自定义）	日期	日期选取器 截止日期
小数（自定义）	数字	数字字段
数字（自定义）	数字	数字字段
下拉列表（自定义）	下拉列表	文本字段（只读） 选择列表 文本字段（单行） 文本字段（多行）
文本（自定义）	单行文本	描述 环境 文本字段（只读） 选择列表 概要 文本字段（单行） 文本字段（多行）
多行文本（自定义）	多行文本	文本字段（多行）

表格 2.Jira 问题字段和兼容的 Zendesk 工单字段

字段标题/类型	显示类型	兼容的 Zendesk 工单字段类型
描述（默认）	多行文本	多行文本
截止日期（默认）	日期	日期
环境（默认）	多行文本	多行文本
修复版本（默认）	修复版本	文本 多行文本
优先级（默认）	优先级 注意：仅从 Jira 同步到 Zendesk	文本 多行文本 下拉列表
冲刺（默认）	冲刺	文本 多行文本
状态（默认）	状态	文本 多行文本 下拉列表
概要（默认）	单行文本	文本 多行文本
日期（自定义）	日期	文本 多行文本 日期
数字（自定义）	数字	数字 小数
只读文本字段（自定义）	只读文本字段	文本 多行文本
选择（自定义）	下拉列表	文本 多行文本 下拉列表 类型 优先级
文本字段（自定义）	单行文本	文本 多行文本
文本区域（自定义）	多行文本	多行文本

设置字段同步

字段同步采用映射界面进行设置。

注意：字段同步仅影响在设置同步功能之后创建的工单和问题。而不会更新以前创建的工单和问题。但是，在编辑或更新之前创建的工单或问题时，将应用字段同步。

Zendesk Support 和 Jira 具有不同的字段类型，这增加了同步过程的复杂性。创建字段映射时需要遵循某些规则，以确保同步按预期进行。

系统（默认）字段和自定义字段均受支持。但是，仅支持所有可用字段类型的子集。此外，哪些Jira字段类型可以同步到Zendesk Support字段类型（反之亦然）。例如，文本字段无法同步到日期时间字段。为避免配置错误，用户界面会隐藏不受支持的字段类型，并使无效的映射选项呈灰色显示。

由于已同步数据的字段无法取消同步，建议您在测试环境或沙盒环境中对字段同步进行测试。如有必要，您可以 关闭字段同步。

打开和配置字段同步

1. 在管理中心中，单击侧栏中的应用和整合 ()，然后选择整合 > 整合。
2. 单击 Jira 链接。
3. 如果您有多个连接，单击您正在设置的连接的名称。
4. 单击 字段映射 标签。
5. 要打开从 Zendesk 到Jira 的字段同步，选择 打开 Zendesk 到Jira 的同步，然后映射您要同步的字段：
   1. 单击 添加映射。

      

   2. 使用下拉菜单选择您要映射的 Jira 问题工单字段和 Zendesk Support 工单字段。
   3. 对其他已映射字段重复此操作。
6. 要打开从Jira到 Zendesk 的字段同步，选择 打开Jira到 Zendesk 的同步。
7. 在Jira中创建一个 Webhook，并从 Webhook 复制生成的密钥。然后将其粘贴到 密钥 字段，并单击 保存密钥。
8. 映射您要同步的字段：
   1. 单击 添加映射。
   2. 使用下拉菜单选择您要映射的Jira问题字段和Zendesk Support工单字段。
   3. 对其他已映射字段重复此操作。
9. 完成字段映射后，单击 保存。

多对一同步

要将多个工单链接到一个 Jira 问题并使用同步，我们建议实施一个故障/事务概念，详见处理故障和事务工单中的说明。

同步已关闭的工单

与Jira不同，Zendesk 不允许更新已关闭的工单。这意味着当尝试将 Jira 问题同步到 Zendesk 工单时，如果工单已经关闭，则同步可能会失败。您可以在 Zendesk Support for Jira 附加功能的错误报告屏幕上查看此错误。

错误

整合日志使您可以识别并解决无效的字段映射以及其他配置问题。请参阅 查看整合日志。

关闭字段同步

关闭字段同步将停止同步后续数据更改。

关闭字段同步

1. 在管理中心中，单击侧栏中的应用和整合 ()，然后选择整合 > 整合。
2. 单击 Jira 链接。
3. 如果您有多个连接，单击您正在设置的连接的名称。
4. 单击 字段映射 标签。
5. 取消 选择打开 Zendesk 到Jira同步 和 打开Jira到 Zendesk 同步 复选框。
6. 单击保存。

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

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