使用查找关系字段

What's my plan?

All Suites

Team, Growth, Professional, Enterprise, or Enterprise Plus

Support

Team, Professional, or Enterprise

查找关系字段是一个自定义字段，可用于建立工单、用户、组织和 自定义对象之间的关系。

本文章包含以下主题：

• 了解查找关系字段
• 添加查找关系字段
• 查看查找关系
• 在触发器和视图中使用查找关系字段

您可以使用 Zendesk API 检索查找关系数据。例如，您可以请求获得与特定支持管理者相关的所有工单的列表。要了解更多信息，请参阅开发者文档中的 使用 API 检索查找关系数据 。

了解查找关系字段

查找关系字段是一种可以添加到 Zendesk 中的用户、组织、工单和自定义对象中 的自定义字段 。添加查找关系字段后，团队成员可用它来建立与其他用户、组织、工单或自定义对象的关系。

您可以将查找关系字段添加到工单表格、用户个人资料、组织页面和自定义对象架构中。完成后，专员可使用此字段在您 Zendesk 帐户的用户、组织、工单或自定义对象记录列表中查找并选择。

您可以通过创造性的方式使用查找字段，以满足您的特定业务需求。例如，您可以创建一个名为管理者的查找字段，将该查找字段与您帐户的用户绑定，然后将该字段添加到工单表格。然后，您的专员可以使用工单上的此字段，从您组织的用户列表中选择管理者。

本部分涵盖以下主题：

• 了解自定义字段
• 了解关系
• 示例

了解自定义字段

查找关系字段是一个自定义字段，可用于在 Zendesk 帐户下的用户、组织、工单或自定义对象记录列表中查找并选择。以下示例显示了工单上的查找关系字段。当团队成员单击该字段时，您会在字段中输入内容，同时会看到一个自动填充的选项列表。尽管您可以在定义字段时 筛选 可用选项，但无需像其他下拉菜单自定义字段那样自己定义选项。

在工单查找关系中选择一条指向自定义对象的记录后，您可以 在工单中预览记录详情。

在用户、组织或自定义对象查找关系字段中选择记录后，您可以单击字段名称查看记录详情：

您可以将查找关系字段添加到 Zendesk 界面的以下页面：

• 帮助中心的工单或支持请求表格
• 用户个人资料页面
• 组织页面
• 自定义对象

这些页面表示关系的可能 来源对象 。例如，用户个人资料页面中显示的用户可以是与另一个用户、组织、工单或自定义对象的关系的源对象。查找关系字段使您可以选择关系中的其他对象，也称为 相关对象 。

您可以将查找关系字段设置为有条件的，使其仅在特定情况下对专员显示。请参阅 创建有条件的工单字段 和 配置专员对自定义对象记录的访问权限。

了解关系

查找关系可表示为：

源对象 → 相关对象

源对象是包含查找关系字段（以及其他字段）的 Zendesk 对象。可以是用户、组织、工单或自定义对象。相关对象是查找关系字段指定的对象。也可以是用户、组织、工单或自定义对象。不支持包含 旧版自定义对象 的查找关系。

查找关系可以是一个用户、组织、工单或自定义对象与另一个用户、组织、工单或自定义对象的任意组合。

如果您创建源工单和相关用户之间的关系，工单记录将有一个查找关系字段来标识用户。但是，相应的用户记录将没有可识别工单的字段。用户记录将有一个 相关 标签，而不是字段，其中列出了工单以及所有其他与之相关的源对象。

每个源对象只能与一个相关对象关联。但是，多个源对象可以与一个相关对象相关。例如，为用户添加组织查找关系字段后，您可以在用户和一个组织之间建立多个关系。例如：

• 用户 1 - 组织 A
• 用户 2 - 组织 A
• 用户 3 - 组织 A
• ...

重要提示：此示例不会将用户添加到组织。它只是在用户和组织之间建立关系。

您可以在工单表格、用户个人资料、组织页面和自定义对象记录详情中查看关系。

您还可以使用 Zendesk API 列出与特定相关对象相关的用户、组织、工单或自定义对象记录。例如，您可以请求获得与特定支持管理者相关的所有工单的列表。要了解更多信息，请参阅开发者文档中的 使用 API 检索查找关系数据 。

不支持按查找关系字段值搜索记录。

示例

您可以通过多种方式使用查找关系字段在Zendesk Support中构建复杂的关系生态系统。以下是一些示例，可帮助您思考如何使用这些自定义字段：

• 您是一家货运公司的管理员，希望将托运人、司机和收件人与工单关联起来。您在工单中添加了三个已筛选查找关系字段：一个名为 驱动器的用户字段、一个名为 发件人的组织字段，以及另一个名为 收件人的组织字段。

• 您的公司是企业对企业 (B2B) 领域的公司，与许多其他公司有往来。您要跟踪这些公司之间的关系。您决定使用组织查找关系字段来创建和跟踪这些关系。例如，您可以有一个名为 “合作伙伴”的字段，一个名为 “子公司”的第二个字段，以及一个名为 “竞争对手”的第三个字段。

• 在另一个企业对企业的场景中，您的每个客户经理都与您的每个客户公司的一个关键利益干系人合作。您可创建一个名为 “客户经理” 的用户查找关系字段，以便在利益相关者和您的客户经理之间建立关系。

• 您希望为团队成员指定紧急联系人，以防某个成员没空。您决定使用名为 紧急联系人 的用户查找字段来创建这些用户到用户的关系。在更复杂的用例中，您可以添加其他用户字段，例如 备份 1 和 备份 2，以便为每个人建立备份优先级。

• 您经营着一个 IT 服务台，希望用户在工单表格中选择他们要提交工单的资产。为此，您需要定义一个名为 相关资产 的 工单查找关系字段，该字段指向一个名为 资产的自定义对象。查找字段配置为筛选结果，以便仅与用户相关的记录可供选择，并在 IT 工单表格中标为必填。
  注意：只有指向自定义对象的查找字段对终端用户可见。此外，终端用户必须登录才能在工单表格中查看查找字段。

添加查找关系字段

工单、用户和组织都可以有最多十个活跃的查找关系字段。自定义对象对每个自定义对象的查找关系有 基于服务模式的限制 。这些字段显示在 Zendesk 界面的页面上。

您还可以使用 Zendesk API 创建查找关系字段。请参阅 API 参考文档中的 查找关系 。

如果您删除查找关系字段，则该字段中的数据不会保留。要保留数据，取消激活字段而不是删除它。

创建查找关系字段

1. 首先为您的用户、组织、工单或自定义对象添加一个自定义字段，并选择 查找关系 作为自定义字段类型。如需更多信息，请参阅：
   • 将自定义字段添加到工单 和 工单表格
   • 为用户添加自定义字段
   • 为组织添加自定义字段
   • 使用自定义字段定义自定义对象的架构

   例如：

   

2. 按照第 1 步中链接文章的说明，设置 显示名称、 字段密钥和 描述 。
3. 选择要在查找关系字段中列出的相关对象。

   可以是工单、用户、组织或自定义对象的名称。例如，如果您选择 用户 作为相关对象，查找关系字段将显示 Zendesk 用户列表。

4. 单击添加筛选，定义一个或多个筛选，以减少字段可显示的选项数量。

   您可以根据任意数量的工单标签或自定义字段筛选对象。有关更多信息，请参阅 筛选字段的选项。

5. 单击保存。

筛选字段的选项

您的帐户可能有数千甚至数百万条工单、用户、组织和自定义对象记录。在大多数情况下，您需要为查找关系字段中的选项定义一个已定义的记录子集。例如，您可能希望仅列出身为客户经理的用户。

所有以标准对象为目标的查找关系字段都可以按工单标签筛选相关对象的记录。例如，要仅列出帐户管理者用户，您可以在帐户管理者的用户个人资料中添加“account_manager”标签，然后为查找关系字段定义以下筛选条件： Tags | Contain at least one of the following | account_manager.这不适用于以自定义对象为目标的查找字段。

根据定义查找字段的对象及其定位的对象，有不同的筛选器可帮助管理员限制在字段中可选择的记录。

• 以工单为目标的查找字段具有以下额外默认筛选可用：状态、类型、优先级、受托人、请求者、表格、组织和渠道。
• 以用户为目标的查找字段可提供额外的“用户角色”筛选。
• 以其他对象为目标的工单查找关系字段可以根据工单的当前用户、受托人、请求者和组织使用其他筛选，动态限制查找字段中可供选择的对象记录。

查找关系字段还支持按已添加到相关对象的其他自定义字段筛选。例如，如果您将一个 安全许可 自定义复选框字段添加到用户个人资料，则当您添加查找关系字段时，该 安全许可 字段将显示为筛选选项。然后您可以为该字段定义以下筛选条件： Security Clearance | Is | Checked.

此外，您可以根据查找关系字段是否匹配源对象中的字段值进行筛选。例如，如果工单有一个名为 产品类别 的查找关系字段，指向名为 产品的自定义对象，您可以筛选结果，仅返回 类别字段 值与工单的 产品类别 字段匹配的 产品 记录。在筛选查找关系字段以查找源对象字段中的匹配值时，将比较下拉字段的标签（而不是值）。如果比较查找字段，则它们必须具有相同的目标对象。

注意：当使用 match 和 does not match 运算符以筛选查找字段值，但只能比较相同类型字段中的值。例如，可以比较两个下拉字段的值，但不能比较下拉字段的值和多选字段的值。因此，这些运算符仅在匹配的字段类型存在时可用。

您可以随时修改筛选。这不会影响之前在查找关系字段中选择的值。

如需了解更多信息，请参阅 关于自定义字段 和 创建触发器条件语句。

查看查找关系

建立记录之间的关系对于构建复杂的数据模型非常重要。但是，在 Zendesk 中查看这些关系并与之互动也很重要。每个用户个人资料、组织和自定义对象记录都会显示一个相关记录列表。对于工单，任何相关记录都将显示为工单字段中的值。

单击查找关系字段可在Support的新标签中打开相关记录的详情。

注意：已存档工单 不包含在相关记录列表中。

查看与用户和组织相关的记录

团队成员、 终端用户或 组织 的每个Zendesk Support个人资料都包含一个 相关 标签，其中列出了所有相关的源对象。信息按源对象类型（工单、 组织、 用户或 自定义对象）和特定查找字段进行分组。

在以下团队成员个人资料示例中，工单有一个名为 司机的查找关系字段。如果在 推动因素 字段中选择了 Anie Porter，该工单将显示在她的团队成员个人资料的 相关 标签下。它按源对象类型 （工单）和查找字段名称（ 驱动因素）分组。

相关 标签不会显示在 帮助中心的用户个人资料上。

查看与工单相关的记录

在工单中，查找关系字段的显示方式与工单字段面板中的任何其它字段一样。

对于指向组织、用户或其他工单的查找字段，单击字段将在Support的新标签中打开记录。如果查找字段指向自定义对象，您可以在背景信息面板中查看记录的详情，而无需离开正在处理的工单。请参阅与工单中的相关对象记录交互。

查看与自定义对象相关的记录

与用户和组织类似，当您查看自定义对象记录的详情时，您将在左侧看到对象所有字段的所有值，在右侧看到按源对象类型分组的相关记录列表。

查看相关记录列表时，源对象的类型将通过以下图标之一表示：源对象的名称，查找关系字段的名称以粗体和括号表示。

图标	源对象
	自定义对象
	组织
	用户
	工单

以下示例显示了 项目 自定义对象的记录 256 的详情。除了关于项目 256 的特定详情之外，您还可以通过工单 (）名为 项目代码 ，它指向 项目 对象。

在触发器和视图中使用查找关系字段

您可以使用查找关系字段来帮助定义 触发器 和 视图。

在触发器或视图中添加条件时，任何查找关系字段也会显示在选项列表中。在以下示例中，触发器的第一个条件是名为 Support Manager 的用户查找关系字段。该触发器仅会在与名为 Jennifer Hanson 的支持管理者关联的工单时触发。

您还可以在触发器操作中使用查找关系字段。在以下示例中，当触发器触发时， 操作会将名为 “公司组织”的 组织查找关系字段的值设置为“西北区域”。

除了在触发器条件和操作中使用在查找字段中指定的记录名称之外，您还可以在条件和操作中引用相关记录的字段。例如，如果您有一个名为 软件请求的 工单查找关系字段，它指向名为 软件的自定义对象，那么您可以使用软件请求的查找字段围绕查找字段中选定的记录创建条件和操作，因为在记录中，或 不存在，或者记录的名称设置为或未设置为特定值，或者您可以引用记录中的其他字段，例如在与工单相关的记录中是否选中了 需要批准 复选框。有关在触发器中使用定位自定义对象的查找关系字段的更多信息，请参阅 在触发器中使用自定义对象。

您还可以使用 占位符 在查找关系字段中检索关于目标记录的信息。这适用于指向其他工单、用户（请求者）和组织的查找字段。然后该 ID 可用于 API 请求，例如将工单分配给查找字段中指定的用户，或通知查找字段中指定用户的管理者：需要其批准。

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

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