如果您使用的是旧版自定义对象，您将继续可以访问您的对象、记录和关系。所有有助于您继续使用旧版自定义对象的资源都已标为“旧版”。不带“旧版”标签的自定义对象文档仅适用于新版自定义对象体验。
Zendesk 提供了多种类型的原生数据对象，用于存储和管理您的客户数据，包括工单、用户、组织等。但是，它无法提供您的组织可能需要的所有数据对象类型。例如，您可能希望将每张新建工单与目录中的一个产品关联起来，以便更好地了解客户在使用不同产品时的体验。通过旧版自定义对象，您可以为 Zendesk 中的新对象类型创建蓝图，然后根据该蓝图创建对象记录。
本文章包含以下部分：
关于旧版自定义对象
旧版自定义对象可以是任何内容，包括产品、服务合同或客户访问。您可以在 Zendesk管理中心中或使用 API创建旧版自定义对象，然后使用旧版自定义对象来定制 Zendesk 帐户，以满足您的业务需求。您可以通过指定应用于每个对象的权限，控制对旧版自定义对象的访问。
本指南介绍了如何在管理中心定义旧版自定义对象。以度假租赁业务为例。客户可通过拨打电话或与企业的支持团队在线交谈来报告与租赁资产相关的问题，后者会为其创建工单。该企业希望在Support中将每张工单与一个租赁资产相关联，以帮助专员提供更好的客户服务。企业还希望利用这些信息更好地了解每个营业点的客户体验，以便规划酒店改进。
以下视频概述了管理中心中的旧版自定义对象，但请注意，该界面现已焕然一新：
旧版自定义对象增强功能 (6:02)
旧版自定义对象的限制
以下限制适用于旧版自定义对象和记录。
- 每个帐户最多可有 50 个旧版自定义对象。
- Support Enterprise、Suite Team 和 Growth：100,000 条自定义对象记录
- Suite Professional：250,000 条自定义对象记录
- Suite Enterprise：1,000,000 条自定义对象记录
- Suite Enterprise Plus：25,000,000 条自定义对象记录
启用旧版自定义对象
旧版自定义对象仅供在 2023 年 9 月之前启用此功能的帐户使用。如果您刚开始使用 Zendesk 的自定义数据，请查看 新的自定义对象体验。
定义旧版自定义自定义对象类型
对于度假租赁业务，您希望每个租赁资产在 Zendesk 中由一个旧版自定义对象记录表示。如果公司购买了另一个休假资产，您只需添加一个对象记录来表示它。
租赁属性具有某些共同属性。例如，每个属性有一个地址，一个周租金，几个房间，以及更多。属性值因租赁资产而异。一种可能是在里斯本的两居室公寓，每周 600 美元，而另一种可能是在阿斯本的三居室房屋，每周 1100 美元。
同样，相同类型（例如“租赁属性”类型）的Sunshine自定义对象都共享相同的属性。旧版自定义对象的属性在称为 对象类型 的蓝图中定义。
在技术级别，对象类型由 密钥 和描述属性的 架构 组成。密钥是您要用于识别对象类型的名称。您可以在创建对象类型时在对象名称字段中输入密钥。例如：“ental_property”。
您可以为租赁资产定义各种属性。为简单起见，我们决定对一个键为“ental_property”的新自定义对象使用以下属性：
| 名称 | 类型 | 必填 | 评论 |
|---|---|---|---|
| id | 字符串 | 是 | 企业分配给租赁资产的唯一标识符 |
| 间卧室 | 号码 | no | 卧室数量 |
| 地址 | 字符串 | no | 租赁产业的街道地址 |
| 国家 | 字符串 | no | 租赁住宿所在的国家 |
| 清洁服务 | 字符串 | no | 本地清洁服务 |
| 日常清洁服务电话 | 字符串 | no | 本地清洁服务公司的电话号码 |
| Pets_allowed | 布尔值 | 是 | 酒店是否允许携带宠物 |
这就是您的架构。请注意，该架构不包含任何特定租赁属性的信息。它仅描述了该信息。要了解更多信息，请参阅 为旧版自定义对象创建架构。
创建旧版自定义对象类型
- 在 管理中心，单击
侧栏中的 对象和规则 ，然后选择 自定义对象 > 旧对象。 - 单击 添加对象。
- 对于 对象名称，输入对象的键值“ental_property”。
您的密钥必须满足以下要求：
- 保持独特
- 仅包含字母数字字符（az、0-9）、下划线（_）和短划线（-）
- 最少为 2 个字符，最多为 32 个字符
- 单击 添加属性 以定义新的属性。
- 在右侧面板的添加属性表格中输入以下值：
- 名称 - ID
- 类型 - 字符串
- 描述 - 企业分配给租赁资产的唯一标识符
- 必填 - 已勾选
- 如果您要继续构建架构，请单击 添加属性 。
- 在添加属性表格中输入第二个属性的值。
- 继续单击 添加属性 以在架构表格中添加其它属性。
- 单击保存。
重新打开后，旧版对象类型应如下所示：
保存对象后，您可以设置基于用户角色的访问权限，以定义专员和终端用户对对象或关系记录的权限。请参阅 设置对象的用户角色和权限。
添加旧版对象记录
在管理中心创建租赁属性对象类型后，您组织中的开发者即可使用Sunshine API 为企业的每个租赁属性 创建旧版自定义对象记录 。他们还可以使用 API 来读取、更新和删除记录。旧版对象记录只不过是具有已定义属性的数据库记录。
开发者在创建租赁属性记录的 API 请求中包含的数据由您定义的对象类型定义，对于“Rental_Property”类型，由名为“id”、“bedrooms”、“address”、“country”的属性组成。 ”、“清洁服务”和“清洁服务电话”。例如：
{
"data": {
"type": "rental_property",
"attributes": {
"id": "fr-021",
"bedrooms": 2,
"address": "11 rue Laurier, Saint-Tropez",
"country": "France"
"cleaning_service": "tropez-nettoyage"
"cleaning_service_phone": "011.33.06.55.47.54.74 "
}
}
}如果您想稍后取回记录，开发者可以使用多个不同的端点来取回。请参阅 API 文档中的 旧版对象记录 。
如果企业对租赁资产进行了更改，例如聘用了新的清洁服务商，则开发者可使用 更新旧版对象记录 端点来更新该租赁资产的对象记录。
如果企业出售租赁资产，开发者可以使用 删除旧对象记录 端点。
如果企业购买了另一个租赁资产，开发者可以使用 创建旧版对象记录 端点。
使用旧版自定义对象为数据建模
要以更有意义的方式使用租赁属性数据，您可以在您的“租用属性”类型和 Zendesk 中的其他对象类型之间建立关系。例如，关于一个特定的租赁资产的信息对资产经理来说没有多大用处，除非它与来客提交的关于该资产的工单相关联。请注意，工单是 Zendesk 中的另一种对象类型。
自定义对象支持多种对象类型之间的关系：
-
一对一 ：两种对象类型在关系的两端都只能有一条记录。例如，一张工单只能与一个租赁资产关联，而一个租赁资产也只能与一张工单关联。在度假租赁示例中，这不是一个可行的选项。一个租赁资产可以有多张与之关联的工单。
-
一对多 ——第一对象类型的每个对象都与第二对象类型的一个或多个对象不相关，或与多个对象相关。例如，租赁资产可以不关联、与一张或多张工单关联。
-
多对多 - 第一个对象类型的每个对象都与第二个对象类型的所有对象、一个或多个对象不关联，并且第二对象类型的每个对象都与第一个对象类型的所有对象、一个或多个对象关联.您可以用两个一对多关系类型定义一个多对多关系类型。
关系可以是：
- 两个旧版自定义对象类型（例如，“租车_属性”和“来宾_合同”对象类型）
- 一个旧版自定义对象类型以及以下任意 Zendesk 对象类型：工单、用户、文章、组织、组或在线交谈
- 两个标准 Zendesk 对象类型
定义旧版关系类型
正如对象类型是创建对象记录的蓝图一样，关系类型是创建两个特定对象类型之间关系记录的蓝图。以度假租赁为例，您要在自定义“ental_property”对象类型和标准 Zendesk 工单对象类型之间定义“租赁属性有许多工单”关系类型。
定义关系类型不会在两条特定记录之间创建关联，它只是描述了关系。定义关系类型后，您可以创建一条关系记录，将特定工单与特定租赁资产相关联。随着这些关系记录的累积，每条记录都将一张工单与一个租赁酒店相关联，您将开始更清楚地了解每个租赁酒店的问题。Sunshine可根据您定义的关系类型，按租赁资产对工单进行分组：一个租赁资产有多张工单。
创建旧版关系类型的步骤
- 在 管理中心，单击 侧栏中的 对象和规则 ，然后选择 自定义对象 > 关系。
- 单击 添加关系类型。
- 对于 关系名称，输入“restal_prop_has_many_tickets”。
您的密钥必须满足以下要求：
- 保持独特
- 仅包含字母数字字符（az、0-9）、下划线（_）和短划线（-）
- 最少为 2 个字符，最多为 32 个字符
- 从菜单中选择以下值：
- 来源 -租车_属性
- 类型 - 1:Many
- 目标 - zen:ticket
页面应如下所示：
- 单击保存。
关联旧版自定义对象的相关记录
定义关系类型后，您可以开始根据关系类型将相关记录关联起来。
您可以通过创建 关系记录 （不要与关系类型混淆）将一种对象类型的记录关联到另一种对象类型的记录。对于您的度假租赁业务，您可以在特定工单和特定租赁资产之间创建一条关系记录。
关系记录由两条相关对象记录的 ID 及其关系类型组成。关系记录不包含任何关于承租人问题或租赁资产的实际信息。它仅包含工单记录的 ID 和租赁资产记录的 ID。Sunshine使用这些 ID 来检索相关记录。
关系记录由您创建的关系类型（名为“Rental_Property_has_many_tickets”的一对多类型）控制，其中每张工单只能与一个租赁资产关联，但每个租赁资产可以与多个工单关联。
要创建关系记录，您团队中的开发者可以向 “创建关系记录” 端点发出 POST 请求。开发者在请求中包含的 JSON 对象必须指定关系类型以及“源”和“目标”对象的 ID。例如：
{
"data": {
"relationship_type": "rental_property_has_many_tickets",
"source": "1c771ee0-2c3f-11e7-bf60-e5c3f630b5aa",
"target": "zen:ticket:35437746"
}
}检索相关记录
您团队中的开发者可使用 按对象记录列出关系记录 端点检索关系记录。例如，开发者可获取记录 ID 为“5d0daa84-aec0-11e7-9a70-416881d66b6d”的租赁资产所有相关工单。
响应示例：
{
"data": [
{
"id": "c5477230-2e98-11e7-acd9-9dbd5d6450d8",
"target": "zen:ticket:35438118",
"ref": "/api/v2/tickets/35438118"
},
{
"id": "5d3484b5-aec6-11e7-9a70-a12d6a7d800c",
"target": "zen:ticket:35437746",
"ref": "/api/v2/tickets/35437746"
}
],
"links": {
"previous":null,
"next":null
}
}在此示例中，租赁属性有两张关联的工单：35438118 和 35437746。您可以使用该信息查看工单。
总结
您可以使用自定义对象和关系记录来解决实际问题，改进现有流程，或只是为了更好地了解您的客户。例如，您团队中的开发者可以使用您的租赁媒体资源自定义对象构建一个 Zendesk 应用，向处理工单的专员显示关于租赁媒体资源的详情。
当专员将工单状态从 “新建” 更改为“已 开启”时，该应用还可能在工单和租赁资产之间 创建一条关系记录 。然后，您可以使用Sunshine API 生成报告，列出每个租赁资产的所有工单，并使用这些信息来规划资产的改进。
设置旧对象的用户角色和权限
创建旧版自定义对象时，您可以在保存对象架构后设置权限。保存对象架构后，您可以在权限标签中看到一组默认权限。旧版对象的默认权限是向专员提供完全的权限（创建、读取、更新或删除），但向终端用户提供没有权限。
设置旧版自定义自定义对象角色和权限
- 在 管理中心，单击 侧栏中的 对象和规则 ，然后选择 自定义对象 > 旧对象。
- 单击 添加对象类型 ，或选择一个现有对象进行编辑。
- 单击 权限 标签。
- 选择 专员 或 终端用户 角色以定义权限。
- 在 专员 或 终端用户 面板中，选择您要为专员或终端用户启用的权限。
选项有：创建、读取、更新和删除。
- 单击保存。
您将收到一条消息，说明旧版对象已保存，并可在表格中查看更新后的权限。
删除自定义对象类型和关系类型
您可以在管理中心删除一个自定义对象类型或关系类型，但无法删除自定义对象记录或关系记录。本节描述了如何在管理中心删除自定义对象类型或关系类型。如果对象类型/关系已有关联的关系或记录，则您无法删除该对象类型/关系。要 删除自定义对象记录 或 关系记录，请使用Sunshine API。
删除自定义对象类型
- 在管理中心，单击侧栏中的对象和规则 ()，然后选择自定义对象 > 对象。
- 将鼠标悬停在您要删除的自定义对象类型上，然后单击该类型旁边的垃圾桶图标。
- 当出现确认消息时，单击 删除 以确认删除。
删除关系类型
- 在 管理中心，单击 侧栏中的 对象和规则 ，然后选择 自定义对象 > 关系。
- 将鼠标悬停在您要删除的关系类型上，然后单击该类型旁边的垃圾桶图标。
- 当出现确认消息时，单击 删除 以确认删除。
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。