创建自定义对象以与自定义数据整合

我的服务模式是什么？

快速查看：管理中心 > 对象和规则 > 自定义对象 > 对象

Zendesk 提供了多种类型的原生数据对象，用于存储和管理您的客户数据，包括工单、用户、组织等。我们将这些称为标准对象。但是，标准对象无法提供您的组织可能需要的所有数据对象类型。使用自定义对象，管理员可以创建自定义对象，以捕获不属于这些标准对象的数据。通过自定义对象扩展 Zendesk 数据模型，将自定义数据与工单、触发器和 Explore 分析无缝整合。

创建自定义对象包括创建实际对象、使用自定义字段定义架构、将对象连接到相关对象，以及授权专员访问自定义对象记录。为满足工作流程要求，您可能还需要在触发器中引用自定义对象。

本文章包含以下主题：

• 创建自定义对象
• 使用自定义字段定义自定义对象的架构
• 了解对自定义对象记录的访问权限
• 添加对象关系。

相关文章：

• 管理自定义对象
• 添加自定义对象记录以捕获自定义数据
• 在触发器中使用自定义对象

创建自定义对象

在技术级别，自定义对象由名称、密钥和字段组成。名称和密钥用于识别对象，字段用于创建对象属性的架构。请注意，架构不包含关于对象特定实例的任何信息，而描述了可以为此类对象收集的信息。自定义对象的创建记录在审核日志中。

开始创建自定义对象之前，建议规划自定义对象工作流程。

创建自定义对象

1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择自定义对象 > 对象。
2. 单击创建对象。
3. 输入以下信息：
   • 名称：将向专员显示的对象名称。
   • 复数昵称：用于导航和列表的对象名称的复数版本。
   • 对象密钥：对象的唯一标识符。
   • （可选）描述：帮助其他管理员了解对象用途的描述。如果超过 92 个字符，对象页面列表中的描述将被截断。

   

4. 单击创建对象。
5. 单击字段标签，添加自定义字段到对象。这将创建对象的架构或属性。
6. 将自定义对象连接到相关对象。这可视为定义此对象与 Zendesk 中其他对象和数据关系的数据模型。
   注意：并非所有与自定义对象的关系都应在对象上定义。您可能需要在其他自定义对象上创建自定义工单字段、用户字段、组织字段或查找字段。请参阅定义关系。
7. （可选）单击编辑顺序，拖放字段，使其在记录预览中按所需的顺序向专员显示，等完成后单击保存。
8. 单击权限标签，查看专员访问对象记录的权限。在 Enterprise 服务模式中，您可以配置专员对对象记录的访问权限。在 Team、Growth 和 Professional 服务模式中，专员权限是预定义的。

使用自定义字段定义自定义对象的架构

使用已创建的自定义对象之前，必须添加自定义字段。这些字段定义了自定义对象的属性或架构，将由专员在创建记录时使用。字段列表按名称的字母顺序排序。

添加自定义字段到自定义对象

1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择自定义对象 > 对象。
2. 单击要添加字段的自定义对象名称。
3. 单击字段标签，然后单击添加字段。

   

4. 选择字段类型，然后输入昵称。
5. 验证字段键值是否是您所需的值。

   字段键值允许在 API 中引用自定义字段。您输入字段名称后，字段键值将自动填充。如果您希望名称和键值不同，则必须编辑字段键值。创建自定义对象字段后，您将无法更改字段密钥。

6. 为字段设置其它属性。选项根据您要添加的字段类型而有所不同。
7. 单击保存或保存并添加另一个。
8. 根据需要重复步骤 4-7。

排序对象字段以打造便捷的专员体验

处理工单时，专员可预览与工单相关的自定义对象记录详情。对象的所有字段都将显示在记录预览面板中，但您可能需要将最重要的字段置顶，以便专员使用。

对自定义对象的字段重新排序

1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择自定义对象 > 对象。
2. 单击要添加字段的自定义对象名称。
3. 单击字段标签，然后单击编辑顺序。
4. 拖放字段，使其按所需的顺序显示。
5. 单击保存。

了解对自定义对象记录的访问权限

创建自定义对象时，您还需要了解专员和客户如何访问对象及其记录。专员有两个访问级别：在专员工作区的“自定义对象记录”页面上的可见性，以及专员如何与自定义对象记录交互。客户（也称为终端用户）也可以被授权查看、编辑、添加和删除自定义对象记录。

专员权限：

在所有服务模式中，您可以决定对象在“自定义对象记录”页面上是对所有专员和管理员均可见，还是仅对管理员可见。

然后，您可以使用基于用户角色的权限来决定专员可与对象记录交互的程度。在所有服务模式中，与自定义对象记录交互的功能已针对每个系统专员用户角色进行了预定义。在 Enterprise 服务模式中，您可以使用管理中心的用户角色页面配置每个自定义用户角色对每个对象的访问权限。要查看专员对特定对象记录的访问权限概要，请使用自定义对象中的“权限”标签。

客户权限 (EAP)

客户（也称为终端用户）可以被授权查看、添加、编辑和删除自定义对象记录。授权客户查看自定义对象记录或与之交互，这样他们可以在提交工单时直接引用相关自定义对象记录，而不用在评论中提供详细信息，然后让专员自行识别和选择相关自定义对象记录。在 Zendesk 用户界面中，可以应用筛选来查找关系字段，使显示的记录仅包含与当前用户相关的记录。但是，权限是在对象级别授予的，因此从技术上讲，客户将被授权访问对象所有记录，而不仅是与其自己相关的记录。

有关更多信息，请参阅配置对自定义对象记录的访问权限。

添加对象关系。

创建自定义对象并定义其自定义字段架构后，必须将其连接到其他标准或自定义对象。查找关系字段提供了一种方法来定义自定义对象与标准 Zendesk 对象（用户、组织和工单）以及其他自定义对象的关系。查找关系可描述为源对象 → 相关对象。源对象是包含查找关系字段（以及其他字段）的 Zendesk 对象。相关对象是查找关系字段指定的对象。

添加相关对象不会自动在两条特定记录之间创建关联，而会描述可能的关系，并允许专员以这种方式关联记录。

您可以将自定义对象的关系添加到：

• 其他自定义对象
• 标准对象

要想让自定义对象包含查找关系字段，请按照以下说明操作。或者，要想让其他对象包含该自定义对象作为查找关系字段，请参阅为工单添加自定义字段、为用户添加自定义字段或为组织添加自定义字段。

添加关系到自定义对象

1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择自定义对象 > 对象。
2. 将鼠标悬停在您要添加字段的自定义对象上，然后单击选项菜单图标 ()，然后选择编辑。
3. 单击字段标签，然后单击添加字段。
4. 设置昵称、字段密钥和描述。
5. 选择要在查找关系字段中列出的相关对象。

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

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

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

7. 单击保存或保存并添加另一个。