了解并使用查找关系字段

我的服务模式是什么？

所有 Suite：

Team、Growth、Professional、Enterprise 或 Enterprise Plus

Support

Team、Professional 或 Enterprise

已验证人工智能概要 ◀▼

查找关系字段使您可在工单、用户、组织和自定义对象之间创建连接。您可以使用这些字段定义关系、筛选选项，以及查看相关记录。它们在触发器和视图中非常有用，允许您根据关系自动执行操作。自定义字段以满足您的需求，并使用 API 进行高级数据检索。

查找关系字段是一个自定义字段，可用于建立工单、用户、组织和自定义对象之间的关系。此外，查找关系字段可用于定义自定义对象与 Zendesk Knowledge 中的文章和品牌的关系。

本文章包含以下主题：

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

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

了解查找关系字段

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

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

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

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

本部分涵盖以下主题：

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

了解自定义字段

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

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

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

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

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

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

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

了解关系

查找关系可表示为：

源对象→相关对象

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

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

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

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

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

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

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

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

示例

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

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

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

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

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

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

添加查找关系字段

与其它自定义字段一样，查找关系字段显示在 Zendesk 界面中其对象页面上。每个对象可以创建的查找字段数量取决于您的服务模式：

• Suite Team 和 Growth 服务模式的每个对象最多可有 5 个查找关系字段。
• Suite Professional 及更高服务模式的每个对象最多可有 10 个查找关系字段。

您还可以使用 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 请求，例如将工单分配给查找字段中指定的用户，或通知查找字段中指定用户的管理者：需要其批准。

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

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