使用查找关系字段

我的服务模式是什么？

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

本文章包含以下主题：

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

您可以使用 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更新。

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

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

查看查找关系

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

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

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

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

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

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

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

查看工单相关记录

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

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

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

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

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

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

以下示例显示了 项目 自定义对象的 256 号记录详情。除了关于项目 256 的特定详情之外，您还可以通过工单上的查找关系字段看到此项目与 3 张工单相关 (）名为 项目代码 ，它指向 项目 对象。

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

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

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

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

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

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

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

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