字段同步功能允许 Zendesk Support 和 Jira 之间近乎实时的数据同步。这样可以在两个系统之间共享信息,以便在支持和工程团队之间进行更好的协作。这是通过将 Jira 问题字段映射到 Zendesk Support 工单字段来完成的。
本文章包含以下主题:
相关文章:
要求和限制
- 支持的版本:Jira Cloud、Jira Data Center 和 Jira Server 7.0 及更高版本
- 字段同步功能区分大小写。Support 字段值必须与 Jira 字段值完全匹配。
- 数据一旦同步,就无法轻易移除。但是,您可以完全禁用字段同步,这将禁用所有字段链接。
- 同步方向可以根据每个字段设置,但每个字段只允许一个映射。
- 不支持相同字段的双向同步。
- 字段映射屏幕在单个列表中显示来自所有 Jira 项目的自定义字段类型。
- 特定问题或工单的所有映射字段都可通过一次 API 调用更新。如果映射字段配置错误,则不会更新所有字段。
- 不支持将一个字段从多个已链接工单同步到一个 Jira 问题字段,或从多个 Jira 问题同步到一张工单上的一个字段,这会导致特定工单或问题的同步停止。请参阅 多对一同步。
字段类型同步兼容性
与同步兼容的字段类型有一些限制。例如,带有数字显示的 Zendesk 小数字段无法与 Jira 多行文本字段同步。
下表列出了字段映射的兼容性。
字段标题/类型 | 显示类型 | 兼容的 Jira 问题字段类型 |
---|---|---|
优先级(默认) | 下拉列表
注意:您无法将 Zendesk 优先级字段同步到 Jira 优先级字段
|
文本字段(只读) 选择列表 文本字段(单行) 文本字段(多行) |
类型(默认) | 下拉列表 | 文本字段(只读) 选择列表 文本字段(单行) 文本字段(多行) |
日期(自定义) | 日期 | 日期选取器 Due date |
小数(自定义) | 编号 | 数字字段 |
数字(自定义) | 编号 | 数字字段 |
下拉列表(自定义) | 下拉列表 | 文本字段(只读) 选择列表 文本字段(单行) 文本字段(多行) |
文本(自定义) | 单行文本 | 描述 环境 文本字段(只读)选择列表 概要 文本字段(单行) 文本字段(多行) |
多行文本(自定义) | 多行文本 | 文本字段(多行) |
字段标题/类型 | 显示类型 | 兼容的 Zendesk 工单字段类型 |
---|---|---|
描述(默认) | 多行文本 | 多行文本 |
截止日期(默认) | 日期 | 日期 |
环境(默认) | 多行文本 | 多行文本 |
修复版本(默认) | 修复版本 | 短信 多行文本 |
优先级(默认) | 优先级
注意:仅从 Jira 同步到 Zendesk
|
短信 多行文本 下拉列表 |
Sprint(默认) | Sprint | 短信 多行文本 |
状态(默认) | 状态 | 短信 多行文本 下拉列表 |
摘要(默认) | 单行文本 | 短信 多行文本 |
日期(自定义) | 日期 | 短信 多行文本 日期 |
数字(自定义) | 编号 | 数字 小数 |
只读文本字段(自定义) | 只读文本字段 | 短信 多行文本 |
选择(自定义) | 下拉列表 | 短信 多行文本 下拉列表 Type 优先级 |
文本字段(自定义) | 单行文本 | 短信 多行文本 |
文本区域(自定义) | 多行文本 | 多行文本 |
设置字段同步
字段同步是使用映射界面设置的。
Zendesk Support 和 Jira 有不同的字段类型,这增加了同步过程的复杂性。在创建字段映射时需要遵循某些规则,以确保同步按预期工作。
支持系统(默认)和自定义字段。但是,仅支持所有可用字段类型的子集。此外,在哪些 Jira 字段类型可以同步到 Zendesk Support 字段类型方面也有限制,反之亦然。例如,文本字段无法同步到日期时间字段。为避免配置错误,用户界面将隐藏不受支持的字段类型,并将无效的映射选项显示为灰色。
由于数据已同步的字段无法取消同步,我们建议您在测试环境或沙盒环境中测试字段同步。如有必要,您可以通过移除所有字段映射来禁用字段同步功能。这将停止同步后续数据更改。
配置并激活字段同步
- 以管理员权限登录您的 Jira 帐户。
- 在顶部导航栏中,选择 应用 > 管理您的应用 > Zendesk Support for Jira > 配置 > 字段映射。
- 使用下拉菜单选择您要映射的 Jira 问题工单字段和 Zendesk Support 工单字段。
- 单击添加。已同步的字段将添加到“字段映射”列表。
- 对其他映射字段重复此操作。
- 完成字段映射后,单击 “保存并同步”。
多对一同步
您可以将单个 Jira 问题中的字段同步到多个 Zendesk Support 工单,或将单个 Support 工单中的字段同步到多个 Jira 问题。在这种情况下,同步仅发生在一个方向,从单个问题或工单到多个工单或问题。
但是,不支持将一个字段从多个已链接工单同步到一个 Jira 问题字段,或从多个 Jira 问题同步到一张工单上的一个字段。以这种方式配置字段同步会导致此特定工单或问题的同步停止。要将多张工单链接到一个 Jira 问题并使用同步,我们建议实施一个故障/事务概念,如 处理故障和事务工单中所述。
Jira 问题密钥是一个特例。如果多个问题链接到同一张工单,其所有密钥都将显示在工单上。
同步已关闭工单
与 Jira 不同,Zendesk 不允许更新已关闭的工单。这意味着当尝试将 Jira 问题同步到 Zendesk 工单时,如果工单已经关闭,则可能会失败。您将可以在 Zendesk Support for Jira 附加功能 错误报告 屏幕上看到此错误。
错误
由于同步是在后台进行的,因此错误会显示在专门的屏幕上。错误报告屏幕允许用户识别并解决无效的字段映射以及其它配置问题。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。