字段同步功能支持在 Zendesk Support 和 Jira 之间实现近乎实时的数据同步。这样两个系统之间可以共享信息，以便支持和工程团队之间更好地协作。具体方法是将 Jira 问题字段映射到 Zendesk Support 工单字段。
本文章包含以下主题：
相关文章：
要求和限制
- 支持的版本：Jira Cloud、Jira 数据中心和 Jira Server 7.0 及更高版本
- 字段同步功能区分大小写。Support 字段值必须与 Jira 字段值完全匹配。
- 数据同步后无法轻松移除。但是，您可以完全禁用字段同步，从而禁用所有字段链接。
- 同步方向可按字段设置，但每个字段只允许一个映射。
- 不支持相同字段的双向同步。
- 字段映射屏幕会在一个列表中显示来自所有 Jira 项目的自定义字段类型。
- 自定义工单状态字段不受支持，无法映射。
- 特定问题或工单的所有已映射字段均可通过一次 API 调用进行更新。如果映射字段配置错误，则所有字段都不会更新。
- 不支持将来自多个链接工单的字段同步到一个 Jira 问题字段，或来自多个 Jira 问题的字段同步到工单上的一个字段，否则会导致停止对特定工单或问题的同步。请参阅多对一同步。
字段类型同步兼容性
兼容同步的字段类型有一些限制。例如，显示数字的 Zendesk 小数字段无法与 Jira 多行文本字段同步。
下表列出了字段映射兼容性。
| 字段标题/类型 | 显示类型 | 兼容的 Jira 问题字段类型 |
|---|---|---|
| 优先级（默认） | 下拉列表
注意：无法将 Zendesk 优先级字段同步到 Jira 优先级字段
|
文本字段（只读） 选择列表 文本字段（单行） 文本字段（多行） |
| 类型（默认） | 下拉列表 | 文本字段（只读） 选择列表 文本字段（单行） 文本字段（多行） |
| 日期（自定义） | 日期 | 日期选取器 截止日期 |
| 小数（自定义） | 数字 | 数字字段 |
| 数字（自定义） | 数字 | 数字字段 |
| 下拉列表（自定义） | 下拉列表 | 文本字段（只读） 选择列表 文本字段（单行） 文本字段（多行） |
| 文本（自定义） | 单行文本 | 描述 环境 文本字段（只读）选择列表 概要 文本字段（单行） 文本字段（多行） |
| 多行文本（自定义） | 多行文本 | 文本字段（多行） |
| 字段标题/类型 | 显示类型 | 兼容的 Zendesk 工单字段类型 |
|---|---|---|
| 描述（默认） | 多行文本 | 多行文本 |
| 截止日期（默认） | 日期 | 日期 |
| 环境（默认） | 多行文本 | 多行文本 |
| 修复版本（默认） | 修复版本 | 文本 多行文本 |
| 优先级（默认） | 优先级
注意：仅从 Jira 同步到 Zendesk
|
文本 多行文本 下拉列表 |
| 冲刺（默认） | 冲刺 | 文本 多行文本 |
| 状态（默认） | 状态 | 文本 多行文本 下拉列表 |
| 概要（默认） | 单行文本 | 文本 多行文本 |
| 日期（自定义） | 日期 | 文本 多行文本 日期 |
| 数字（自定义） | 数字 | 数字 小数 |
| 只读文本字段（自定义） | 只读文本字段 | 文本 多行文本 |
| 选择（自定义） | 下拉列表 | 文本 多行文本 下拉列表 类型 优先级 |
| 文本字段（自定义） | 单行文本 | 文本 多行文本 |
| 文本区域（自定义） | 多行文本 | 多行文本 |
设置字段同步
字段同步采用映射界面进行设置。
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 附加功能的错误报告屏幕上查看此错误。
错误
由于同步在后台进行，因此错误将显示在专门的屏幕上。错误报告屏幕允许用户识别并解决无效的字段映射以及其他配置问题。
