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

What's my plan?

Suite

Team, Growth, Professional, Enterprise, or Enterprise Plus

Support

Enterprise

位置：管理中心 > 对象和规则 > 自定义对象 > 对象

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

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

本文章包含以下主题：

• 创建自定义对象
• 使用自定义字段定义自定义对象的架构
• 配置自定义对象记录的命名方式
• 了解自定义对象记录的权限
• 添加对象关系。

相关文章：

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

创建自定义对象

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

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

创建自定义对象

1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择自定义对象 > 对象。
2. 单击创建对象。
3. 输入以下信息：
   • 名称：将向专员显示的对象名称。
   • 复数昵称：用于导航和列表的对象名称的复数版本。
   • 对象密钥：对象的唯一标识符。
   • （可选）描述：帮助其他管理员了解对象用途的描述。如果超过 92 个字符，对象页面列表中的描述将被截断。
   • （可选）为各条记录添加图像图标：允许管理员和有权限的专员添加和管理此对象记录的图标。在选中后取消选择的情况下，现有图标会继续可见（除非被移除），但无法添加新的记录图标。

   

4. 单击创建对象。
5. 打开自定义对象的名称字段（字段键 Standard::name），指定对象记录的命名方式：
   • 手动命名记录：默认情况下，专员必须为其添加的每条记录手动输入名称。如果您想使用记录名称作为唯一标识符，可以选择需要唯一的记录名称。
   • 带自动编号的名称记录：如果您希望根据配置的结构使用唯一、自动生成的值来命名记录，请选择自动编号。
   注意：如果自定义对象存在记录，则无法更改记录命名设置。
6. 单击字段标签，添加自定义字段到对象。这将创建对象的架构或属性。
7. 将自定义对象连接到相关对象。这可视为定义此对象与 Zendesk 中其他对象和数据关系的数据模型。
   注意：并非所有与自定义对象的关系都应在对象上定义。您可能需要在其他自定义对象上创建自定义工单字段、用户字段、组织字段或查找字段。请参阅定义关系。
8. （可选）单击编辑顺序，拖放字段，使其在记录预览中按所需的顺序向专员显示，等完成后单击保存。
9. 单击权限标签，查看专员访问对象记录的权限。在 Enterprise 服务模式中，您可以配置对象记录的权限。在 Team、Growth 和 Professional 服务模式中，专员权限是预定义的。

配置自定义对象记录的命名方式

自定义对象始终有两个字段：名称和外部 ID。通常，姓名字段是一个文本字段，供专员用于为其创建的记录手动输入值。但是，即使进行了出色的训练，这仍然可能导致数据和记录名称格式不一致。

管理员有两个选项可确保记录名称的唯一性和可识别性：一是需要唯一的记录名称，二是自动编号。需要唯一性会阻止专员添加记录，直到他们输入唯一的记录名称，而自动编号则提供自动生成的唯一记录名称。

打开自动编号后，您可以配置前缀和起始号码来建立对象记录的命名模式。每创建一条新记录，自动编号值就会加一。如果创建的记录超过指定的数字格式，将根据需要使用额外的位数对记录自动编号。

注意：只有当自定义对象不存在记录时，您才能修改记录名称设置。

配置记录命名

1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择自定义对象 > 对象。
2. 单击要编辑的自定义对象的名称。
3. 单击字段标签。
4. 单击字段键为 Standard::name 的字段的显示名称。

   显示名称默认为名称，但该值可以更改。字段键无法更改，是可靠的标识符。

5. 在记录名称类型下，根据需要配置对象记录命名方式：
   • 手动命名记录：需要专员手动输入名称。
     • 如果您要强制唯一性，请选择需要唯一的记录名称。
   • 带自动编号的名称记录：自动生成唯一的记录名称。为自动生成的名称结构注明以下详细信息：
     • 输入前缀（1-30 个字符），作为每个记录名称的开头。

       前缀默认为自定义对象名称的前两个字母。

     • 输入初始记录的起始号码，包括前导零，以定义用于初始记录自动编号的总位数。最多 9 位数字。起始数字默认为 0001。

     使用右侧预览窗格查看自动编号格式。

   

6. 单击保存。

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

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

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

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. 单击保存或保存并添加另一个。