i18n - docs translations (#17434)

Created by Github action

Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
2026-01-26 09:06:17 +01:00
committed by GitHub
parent 2353bc62cc
commit e0d4492013
651 changed files with 37463 additions and 32557 deletions
@@ -1,122 +1,122 @@
---
title: Fields
description: Understand the role of fields and how to manage them.
title: 字段
description: 了解字段的作用以及如何管理它们。
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## About Fields
## 关于字段
Fields are like columns in a spreadsheet. They store different types of data like text, numbers, or dates. Fields can be standard (built-in) or custom (the ones you create).
字段就像电子表格中的列。 它们存储不同类型的数据,如文本、数字或日期。 字段可以是标准的(内置的)或自定义的(您创建的)。
### Standard Fields
### 标准字段
Standard fields come built-in with Twenty to handle common business needs.
标准字段是内置在Twenty中,用于处理常见的业务需求。
For example, `First Name` and `Last Name` are standard fields in the `People` object. They store text data for individual names.
例如,`姓`和`名`是`人`对象中的标准字段。 它们用于存储个人姓名的文本数据。
You cannot delete standard fields, but you can deactivate them if you don't need them.
您无法删除标准字段,但如果不需要,您可以停用它们。
You can also customize the options of the standard `SELECT` type fields, for example the options for the `Stage` on Opportunities.
您还可以自定义标准`SELECT`类型字段的选项,例如机会中的`阶段`选项。
<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
### Custom Fields
### 自定义字段
Custom fields can be added to any object. You can store text, numbers, dates, dropdown selections, and more. Use custom fields to track information that's specific to your business.
可以将自定义字段添加到任何对象。 您可以存储文本、数字、日期、下拉选择等。 使用自定义字段来跟踪特定于您业务的信息。
For instance, a custom field for SpaceX could be `Rocket Active Status`, indicating if a rocket is operational.
例如,SpaceX的自定义字段可以是`火箭活动状态`,指示火箭是否在运作。
<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
## Field Types
## 字段类型
Twenty supports various field types:
Twenty 支持多种字段类型:
| Type | Description | Example |
| ------------ | ----------------------------------------------------------------- | ------------------ |
| Address | Structured address with street, city, state, country, postal code | Office Address |
| Array | List of text values | Tags |
| Boolean | True/false checkbox | Is Active |
| Currency | Monetary value with currency code | Deal Amount (USD) |
| Date | Date values | Close Date |
| Date & Time | Date with time | Meeting Time |
| Domain | Website domain (used for Companies) | acme.com |
| Email | Email addresses (with primary + additional) | Contact Email |
| JSON | Structured JSON data | Custom metadata |
| Links | URLs with labels (primary + secondary) | Website, LinkedIn |
| Long Text | Multi-line text | Description, Notes |
| Multi-Select | Multiple choices from a predefined list | Tags, Categories |
| Number | Numeric values (integers or decimals) | Quantity, Score |
| Phone | Phone numbers with country code | Work Phone |
| Rating | Star rating (1-5) | Priority, Score |
| Relation | Links to records in other objects | Company → People |
| Select | Single choice from a predefined list | Stage, Status |
| Text | Single line of text | Name, Title |
| 类型 | 描述 | 示例 |
| ----- | ------------------------- | ----------- |
| 地址 | 包含街道、城市、州/省、国家、邮政编码的结构化地址 | 办公地址 |
| 数组 | 文本值列表 | 标签 |
| 布尔值 | 真/假复选框 | 是否活跃 |
| 货币 | 带有货币代码的金额 | 交易金额(USD |
| 日期 | 日期值 | 关闭日期 |
| 日期和时间 | 带时间的日期 | 会议时间 |
| 域 | 网站域名(用于公司) | acme.com |
| 电子邮件 | 电子邮件地址(含主要 + 附加) | 联系人的电子邮件 |
| JSON | 结构化 JSON 数据 | 自定义元数据 |
| 链接 | 带标签的 URL(主要 + 次要) | 网站、LinkedIn |
| 长文本 | 多行文本 | 描述、备注 |
| 多选 | 从预定义列表中选择多个选项 | 标签、类别 |
| 数字 | 数值(整数或小数) | 数量、分数 |
| 电话 | 带国家代码的电话号码 | 工作电话 |
| 评分 | 星级评分(1-5 | 优先级、分数 |
| 关系 | 链接到其他对象中的记录 | 公司 → 人员 |
| 选择 | 从预定义列表中选择单个选项 | 阶段、状态 |
| 文本 | 单行文本 | 名称、标题 |
## Create a Custom Field
## 创建自定义字段
To add a custom field to any object, follow these steps:
要将自定义字段添加到任何对象,请按照以下步骤操作:
1. Go to `Settings` in the left sidebar.
2. Go to `Data Model`, then select the object you wish to customize.
3. Proceed by clicking on `Add Field`.
4. Choose a field name and type that suits your requirements. Consider adding a field description for better understanding.
1. 转到左侧栏的`设置`。
2. 转到`数据模型`,然后选择您想要自定义的对象。
3. 继续点击`添加字段`。
4. 选择适合您要求的字段名称和类型。 考虑添加字段描述以便更好地理解。
Your newly created field is now available within the application's fields. To display it on a specific view, click on the options menu, then select `Fields`.
您新创建的字段现在可以在应用程序的字段中使用。 要将其显示在特定视图中,请单击选项菜单,然后选择`字段`。
<VimeoEmbed videoId="927628219" title="Video demonstration" />
<VimeoEmbed videoId="927628219" title="视频演示" />
**Quick way:** Click the **+** button at the top right of any object table, then select `Customize fields`. This takes you directly to the Data Model settings.
**快速方法:** 点击任何对象表右上的 **+** 按钮,然后选择`自定义字段`。 这将直接带您进入数据模型设置。
<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
## Deactivate a Field
## 停用字段
You can deactivate a field to hide it from the app without losing your data. Think of it as hiding the field rather than deleting it.
您可以停用字段以从应用程序中隐藏它,而不会丢失您的数据。 这更像是隐藏字段而不是删除它。
Here's how you can do it:
您可以这样做:
1. Find the field you want to deactivate in your object settings.
1. 在对象设置中找到您想停用的字段。
2. Click the three dots `⋮` next to the field to open the menu.
2. 点击字段旁边的三点`⋮`打开菜单。
3. Select `Deactivate` from the dropdown.
3. 从下拉菜单选择`停用`。
<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
What happens when you deactivate a field?
停用字段会发生什么?
1. **In the app:** The field disappears and you can't add new values to it.
1. **在应用程序中:** 字段消失,您不能向其中添加新值。
2. **Existing relationships:** If it's a relation field, existing connections stay but you can't create new ones.
2. **现有关系:** 如果它是一个关系字段,现有连接将保留,但不能创建新连接。
3. **API access:** You can still access the field and its data through the API.
3. **通过API访问:** 您仍然可以通过API访问字段及其数据。
You can reactivate Standard and Custom Fields or have the option to permanently delete them.
您可以重新激活标准字段和自定义字段,或有选择地将其永久删除。
## Make Fields Unique
## 使字段唯一
Make a field unique to ensure distinct records cannot have the same value. For example, email addresses are unique for each person.
使字段唯一以确保不同记录无法拥有相同的值。 例如,电子邮件地址对每个人都是唯一的。
If you get an error when setting uniqueness, check for duplicate values in your data (including deleted records).
如果在设置唯一性时出现错误,请检查数据中是否有重复值(包括删除的记录)。
## Field Configuration Best Practices
## 字段配置最佳实践
### Naming Conventions and Limitations
### 命名约定和限制
* **Singular and plural named must be distinct**: Our GraphQL API needs distinct names for mutations
* **Protected field names**: some names are reserved for system usage (e.g., `Type`, `Application`)
* **单数和复数名称必须不同:** 我们的GraphQL API需要为变更提供不同的名称
* **受保护的字段名称**:某些名称保留供系统使用(例如,`Type``Application`
### Currency and Phone Fields
### 货币和电话号码字段
* **Default currency**: can be configured via the data model
* **Default country codes**: can be configured for phone fields via the data model
* **默认货币:** 可以通过数据模型进行配置
* **默认国家代码:** 可以通过数据模型为电话号码字段进行配置
### Select Fields
### 选择字段
* **A default option can be selected** for each Select field
* **可以为每个选择字段选择默认选项**
### Record Text Fields
### 记录文本字段
* **Each object has one main display field**: This field appears in the leftmost column and represents the record when linked to other objects. It must be a text field. For example, People uses `Name` as the main field, so when you link a person to a company, you'll see their name in the company's view.
* **每个对象都有一个主要显示字段:** 此字段出现在最左列,并在与其他对象关联时代表记录。 它必须是文本字段。 例如,`人`使用`姓名`作为主要字段,因此当您将某人关联到公司时,您将在公司的视图中看到他们的姓名。
@@ -1,91 +1,91 @@
---
title: Objects
description: Learn about standard and custom objects in Twenty.
title: 对象
description: 了解 Twenty 中的标准对象和自定义对象。
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Standard Objects
## 标准对象
Standard objects are predefined entities in your workspace to help you get started. They're part of a shared data model accessible to all users of Twenty. You can use them as-is, customize them or deactivate them.
标准对象是工作区中预定义的实体,帮助您入门。 它们是共享数据模型的一部分,所有Twenty用户均可访问。 您可以直接使用、进行自定义或将其停用。
<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
### People
### 人员
The `People` object stores your contacts. It includes contact details and interaction history, so you can see all your customer interactions in one place.
`People`对象存储您的联系人。 它包含联系信息和交互历史记录,因此您可以在一个地方查看所有客户互动。
### Company
### 公司
The `Companies` object stores your business accounts. It includes details like industry, size and location. Companies connect to both `People` and `Opportunities` objects.
`Companies`对象存储您的业务帐户。 它包括行业、规模和位置等详细信息。 公司连接到`People``Opportunities`对象。
### Opportunities
### 机会
The `Opportunities` object stores deal-related data. It tracks the progression of potential sales, from prospecting to closure, recording stages, deal sizes, associated account, and expected close date. You can view your sales pipeline in a kanban layout.
`Opportunities`对象存储与交易相关的数据。 它用于跟踪潜在销售从开发到成交的全过程,记录阶段、交易规模、关联公司以及预计成交日期。 您可以在看板布局中查看您的销售流程。
### Notes
### 备注
The `Notes` object stores free-form notes that can be attached to People, Companies, Opportunities, and other records. Use notes to capture meeting summaries, important details, or any contextual information.
`Notes` 对象存储自由格式笔记,可附加到联系人、公司、商机及其他记录。 使用笔记记录会议摘要、重要细节或任何上下文信息。
### Tasks
### 任务
The `Tasks` object stores to-dos and action items. Tasks can be linked to People, Companies, Opportunities, and other records. Track due dates, assignees, and completion status to stay on top of your follow-ups.
`Tasks` 对象存储待办事项和行动项。 任务可以关联到联系人、公司、商机及其他记录。 跟踪到期日期、负责人和完成状态,以便掌控后续跟进。
## Custom Objects
## 自定义对象
Custom objects let you store information that's unique to your organization and that standard objects can't handle. For example, if you're SpaceX, you may want to create a custom object for Rockets and Launches.
自定义对象可以存储标准对象无法处理的、组织特有的信息。 例如,如果您是SpaceX,您可能想为火箭和发射创建自定义对象。
<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
### Creating a New Custom Object
### 创建新的自定义对象
To create a new custom object:
要创建新的自定义对象:
1. Go to Settings in the sidebar on the left.
2. Under Workspace, go to Data model. Here you'll be able to see an overview of all your existing Standard and Custom objects (both active and disabled).
1. 转到左侧边栏中的设置。
2. 在工作区下,转到数据模型。 在这里,您将能够查看所有现有的标准和自定义对象(包括活动和禁用)。
<VimeoEmbed videoId="926288174" title="Video demonstration" />
<VimeoEmbed videoId="926288174" title="视频演示" />
3. Click on `+ New object` at the top. Enter the name (both singular and plural), choose an icon, and add a description for your custom object and hit Save (at the top right). Using Listing as an example of custom object, the singular would be "listing" and the plural would be "listings" along with a description like "Listings that hosts created to showcase their property."
3. 点击顶部的`+ 新对象`。 输入名称(单数和复数),选择图标,添加自定义对象的描述,然后点击保存(在右上角)。 以Listing作为自定义对象的示例,单数为"listing",复数为"listings",以及像“房东创建的用于展示其物业的列表”这样的描述。
4. Your custom object is now created and will appear in your sidebar. You can start adding records to it right away.
4. 您的自定义对象已创建,并会显示在侧边栏中。 您可以立即开始向其中添加记录。
## Managing Objects
## 管理对象
### Deactivating Objects
### 停用对象
If you don't need a standard or custom object:
如果您不再需要某个标准对象或自定义对象:
1. Go to Settings → Data Model
2. Find the object you want to deactivate
3. Click the toggle to deactivate it
4. The object will be hidden from your workspace but data is preserved
1. 进入 设置 → 数据模型
2. 找到您要停用的对象
3. 点击切换开关将其停用
4. 该对象将在您的工作区中隐藏,但数据会被保留
### Reactivating Objects
### 重新启用对象
To bring back a deactivated object:
要恢复已停用的对象:
1. Go to Settings → Data Model
2. Look for deactivated objects (they'll be grayed out)
3. Click the toggle to reactivate it
4. The object and all its data will be restored
1. 进入 设置 → 数据模型
2. 查找已停用的对象(它们会显示为灰色)
3. 点击切换开关将其重新启用
4. 该对象及其所有数据将被恢复
## Best Practices
## 最佳实践
### When to Create Custom Objects
### 何时创建自定义对象
* **Unique business entities**: Things specific to your industry or process
* **Complex relationships**: When you need to track connections between multiple entities
* **Scalable data**: When you might have many instances of something
* **独特的业务实体**:特定于您的行业或流程的事物
* **复杂关系**:当您需要跟踪多个实体之间的关联时
* **可扩展的数据**:当某类事物可能有大量实例时
### When to Use Fields Instead
### 何时改用字段
* **Simple attributes**: Properties that describe existing objects
* **Categories or labels**: Ways to classify existing records
* **Single values**: Information that doesn't need its own lifecycle
* **简单属性**:用于描述现有对象的属性
* **类别或标签**:对现有记录进行分类的方式
* **单一值**:不需要独立生命周期的信息
### Object Naming
### 对象命名
* **Use clear, descriptive names**: Make it obvious what the object represents
* **Follow conventions**: Use singular for the object name, plural for the collection
* **Consider your team**: Choose names everyone will understand
* **使用清晰、具有描述性的名称**:让对象所代表的内容一目了然
* **遵循约定**:对象名称使用单数形式,集合使用复数形式
* **考虑您的团队**:选择人人都能理解的名称
@@ -1,92 +1,96 @@
---
title: Relation Fields
description: Connect records across different objects using relation fields.
title: 关系字段
description: 使用关系字段在不同对象之间关联记录。
---
## Types of Relations
## 关系类型
### One-to-Many
### 一对多
One record in Object A can be linked to many records in Object B.
对象 A 中的一条记录可以关联到对象 B 中的多条记录。
**Example:** One Company can have many People (employees).
**示例:** 一个公司可以拥有许多人员(员工)。
### Many-to-One
### 多对一
Many records in Object A can be linked to one record in Object B.
对象 A 中的多条记录可以关联到对象 B 中的一条记录。
**Example:** Many People can belong to one Company.
**示例:** 许多人员可以隶属于一个公司。
### Relations to Multiple Object Types
### 可指向多种对象类型的关系
Some objects can link to multiple object types on one side of the relation.
某些对象在关系的一侧可以关联到多种对象类型。
**Example:** A Note can be attached to one Person AND one Company AND one Opportunity simultaneously. The Note is on the "many" side, connecting to multiple "one" sides.
**示例:** 一条备注可以同时附加到一个人员、一个公司和一个商机。 该备注位于 "多" 侧,连接到多个 "一" 侧。
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
Similarly, a Project (on the "one" side) could receive links from multiple People, multiple Companies, and multiple Notes.
类似地,一个项目(位于 "一" 侧)可以接收来自多个人员、多个公司和多条备注的关联。
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
**Import/Export limitation**: Relations pointing to multiple object types are not yet supported for CSV import/export. This is on our roadmap.
**导入/导出限制**:指向多个对象类型的关系目前尚不支持 CSV 导入/导出。 此功能已在我们的路线图中。
</Warning>
### Many-to-Many
### 多对多
Many records in Object A can be linked to many records in Object B.
对象 A 中的多条记录可以关联到对象 B 中的多条记录。
**Example:** Many People can be linked to many Projects, and vice versa.
**示例:** 许多人员可以关联到许多项目,反之亦然。
多对多关系采用**连接对象**模式:一个连接双方的中间对象。 借助连接关系功能,Twenty 会直接显示最终关联的记录,并在界面中隐藏该中间对象。
<img src="/images/user-guide/fields/junction-relation-diagram.png" style={{width:'100%'}} />
<Warning>
**Many-to-Many is not yet supported.**
This relation type is planned for H1 2026. As a workaround, create an intermediate "junction" object (e.g., "Project Assignments") that has Many-to-One relations to both objects.
**实验功能**:使用前必须在 **Settings → Updates → Lab** 中启用连接关系。
</Warning>
## Creating a Relation Field
请参阅 [如何创建多对多关系](/l/zh/user-guide/data-model/how-tos/create-many-to-many-relations) 以获取完整的分步指南。
1. Go to **Settings → Data Model**
2. Select the object where you want to add the relation
3. Click **+ Add Field**
4. Select **Relation** as the field type
5. Choose the target object(s) to relate to
6. Configure the relation settings:
* **Field name on source object**: The name of the relation field on the object you're editing
* **Field name on destination object**: The name of the relation field that will appear on the target object
* Relation type (one-to-many, many-to-one)
7. Click **Save**
## 创建关系字段
## Standard Relations
1. 进入 **设置 → 数据模型**
2. 选择要添加关系的对象
3. 点击 **+ 添加字段**
4. 将字段类型选择为 **关系**
5. 选择要关联到的目标对象
6. 配置关系设置:
* **源对象上的字段名称**:你正在编辑的对象上的关系字段名称
* **目标对象上的字段名称**:将显示在目标对象上的关系字段名称
* 关系类型(一对多、多对一)
7. 单击 **保存**
Twenty comes with pre-built relations between standard objects:
## 标准关系
| From Object | To Object | Relation Type |
| ------------- | --------- | ------------- |
| People | Companies | Many-to-One |
| Opportunities | Companies | Many-to-One |
| Opportunities | People | Many-to-One |
Twenty 内置了标准对象之间的预设关系:
## Best Practices
| 来源对象 | 目标对象 | 关系类型 |
| ---- | ---- | ---- |
| 人员 | 公司 | 多对一 |
| 机会 | 公司 | 多对一 |
| 机会 | 人员 | 多对一 |
### Planning Relations
## 最佳实践
* **Map your data model**: Plan relations before creating them
* **Consider direction**: Think about which object "owns" the relationship
* **Avoid circular dependencies**: Keep your data model clean
### 规划关系
### Naming Relations
* **梳理你的数据模型**:在创建关系之前先进行规划
* **考虑方向**:思考由哪个对象 "拥有" 该关系
* **避免循环依赖**:保持数据模型简洁清晰
* **Use clear names**: Make it obvious what the relation represents
* **Be consistent**: Use similar naming patterns across relations
* **Consider both sides**: Name both sides of the relation appropriately
### 关系命名
### Performance
* **使用清晰的名称**:使关系所代表的含义一目了然
* **保持一致**:在各个关系中使用类似的命名模式
* **兼顾两端**:为关系的两端分别起合适的名称
* **Don't over-relate**: Too many relations can slow down your workspace
### 性能
## Limitations
* **不要过度关联**:过多的关系会拖慢你的工作区
* **Deleting relations** removes the link but not the related records
* **Circular relations** should be avoided for data integrity
## 限制
* **删除关系**会移除链接,但不会删除相关记录
* **循环关系**应当避免,以确保数据完整性
@@ -1,72 +1,72 @@
---
title: Create Custom Fields
description: Step-by-step guide to adding custom fields to any object.
title: 创建自定义字段
description: 逐步指南:向任何对象添加自定义字段。
---
Custom fields let you capture information specific to your business. Add them to any object—standard or custom.
使用自定义字段可捕获特定于您业务的信息。 可将其添加到任何对象——标准或自定义。
## Steps
## 步骤
1. Go to **Settings → Data Model**
2. Select the object you want to add a field to
3. Click **+ Add Field**
4. Choose a **field type** (see [Fields](/l/zh/user-guide/data-model/capabilities/fields) for all types)
5. Enter the **field name** and optional description
6. Configure field-specific settings (see below)
7. Click **Save**
1. 进入 **设置 → 数据模型**
2. 选择要添加字段的对象
3. 点击 **+ 添加字段**
4. 选择**字段类型**(所有类型请参见[字段](/l/zh/user-guide/data-model/capabilities/fields)
5. 输入**字段名称**和可选描述
6. 配置特定于该字段的设置(见下文)
7. 单击 **保存**
**Quick method:** Click the **+** at the end of column headers in any table view → **Customize fields**.
**快速方法:** 在任意表格视图的列标题末尾点击 **+** → **自定义字段**
## Show the Field in Views
## 在视图中显示字段
New fields aren't automatically visible. To display:
新字段不会自动显示。 要显示:
1. Open the object's table view
2. Click **Options → Fields**
3. Click the **eye icon** next to your field to show it
4. Drag to reorder
1. 打开该对象的表格视图
2. 点击 **选项 → 字段**
3. 点击字段旁的 **眼睛图标** 以显示该字段
4. 拖动以重新排序
## Configuration Options
## 配置选项
### For Select / Multi-Select
### 用于选择/多选
1. Click **+ Add option** to create choices
2. Set a **default option** if desired
3. Drag to reorder options
1. 点击 **+ 添加选项** 以创建选项
2. 如有需要,设置**默认选项**
3. 拖动以重新排序选项
<Note>
**Use API names for imports.** Enable **Advanced mode** in Settings to see API names. See [Field Mapping](/l/zh/user-guide/data-migration/capabilities/field-mapping).
**导入时请使用 API 名称。** 在设置中启用 **高级模式** 以查看 API 名称。 请参见[字段映射](/l/zh/user-guide/data-migration/capabilities/field-mapping)
</Note>
### For Currency Fields
### 适用于货币字段
Set the **default currency** (USD, EUR, etc.) for new records.
设置**默认货币**USDEUR 等) 用于新记录。
### For Phone Fields
### 适用于电话字段
Set the **default country code** to pre-fill for new phone numbers.
设置**默认国家代码**,用于预填新的电话号码。
### Making a Field Unique
### 将字段设置为唯一
Toggle **Unique** to prevent duplicate values across records.
切换**唯一**选项,以防止各记录之间出现重复值。
<Note>
If duplicates exist (including in deleted records), you'll get an error. Clean up duplicates first.
如果存在重复项(包括已删除记录中的重复项),将会出现错误。 请先清理重复项。
</Note>
### Setting Default Values
### 设置默认值
For Select fields, you can choose which option is pre-selected for new records. For Checkbox fields, set whether it's checked or unchecked by default.
对于选择字段,您可以选择新记录预先选中的选项。 对于复选框字段,设置默认是否选中。
## Deactivating a Field
## 停用字段
1. Go to **Settings → Data Model**
2. Find the field
3. Click **⋮ → Deactivate**
1. 进入 **设置 → 数据模型**
2. 找到该字段
3. 点击 **⋮ → 停用**
Data is preserved. You can reactivate or permanently delete later.
数据将被保留。 您可以稍后重新启用或永久删除。
## Related
## 相关内容
* [Fields](/l/zh/user-guide/data-model/capabilities/fields) — all field types explained
* [Data Model FAQ](/l/zh/user-guide/data-model/how-tos/data-model-faq) — common questions
* [字段](/l/zh/user-guide/data-model/capabilities/fields) — 所有字段类型说明
* [数据模型常见问题解答](/l/zh/user-guide/data-model/how-tos/data-model-faq) — 常见问题
@@ -1,51 +1,51 @@
---
title: Create Custom Objects
description: Step-by-step guide to creating custom objects in Twenty.
title: 创建自定义对象
description: 在 Twenty 中创建自定义对象的分步指南。
---
Custom objects let you store information unique to your business that standard objects don't cover. For example: Projects, Products, Tickets, or Listings.
自定义对象可用于存储您业务独有而标准对象未涵盖的信息。 例如:项目、产品、工单或列表项。
<Note>
**Not sure if you need an object or a field?** See [Understanding Your Data Model](/l/zh/user-guide/data-model/overview) for guidance.
**不确定该创建对象还是字段?** 请参阅[了解您的数据模型](/l/zh/user-guide/data-model/overview)以获取指导。
</Note>
## Steps
## 步骤
1. Go to **Settings → Data Model**
2. Click **+ New object**
3. Fill in:
* **Singular name** (e.g., "Listing")
* **Plural name** (e.g., "Listings")
* **Icon**
* **Description** (optional)
4. Click **Save**
1. 进入 **设置 → 数据模型**
2. 点击 **+ 新建对象**
3. 填写:
* **单数名称**(例如,"Listing"
* **复数名称**(例如,"Listings"
* **图标**
* **描述**(可选)
4. 单击 **保存**
Your object appears in the sidebar immediately.
您的对象会立即显示在侧边栏中。
## Next: Add Fields
## 下一步:添加字段
New objects start with basic fields. Add custom fields to capture the data you need:
新建对象默认包含一些基础字段。 添加自定义字段以捕获所需数据:
1. In **Settings → Data Model**, select your object
2. Click **+ Add Field**
3. Choose a field type, configure, and save
1. **设置 → 数据模型** 中,选择您的对象
2. 点击 **+ 添加字段**
3. 选择字段类型,配置并保存
See [How to Create Custom Fields](/l/zh/user-guide/data-model/how-tos/create-custom-fields) for details on field types and configuration.
有关字段类型和配置的详细信息,请参阅[如何创建自定义字段](/l/zh/user-guide/data-model/how-tos/create-custom-fields)
## Connecting to Other Objects
## 连接到其他对象
To link your object to People, Companies, or other objects, create a relation field. See [How to Create Relation Fields](/l/zh/user-guide/data-model/how-tos/create-relation-fields).
要将您的对象与人员、公司或其他对象关联,请创建关系字段。 请参阅[如何创建关系字段](/l/zh/user-guide/data-model/how-tos/create-relation-fields)
## Deactivating an Object
## 停用对象
If you no longer need an object:
如果您不再需要某个对象:
1. Go to **Settings → Data Model**
2. Toggle the object off
1. 进入 **设置 → 数据模型**
2. 将该对象切换为关闭状态
The object is hidden but data is preserved. You can reactivate or permanently delete later.
该对象会被隐藏,但数据会被保留。 您可以稍后重新启用或永久删除。
## Related
## 相关内容
* [Objects](/l/zh/user-guide/data-model/capabilities/objects) — standard vs custom objects
* [Data Model FAQ](/l/zh/user-guide/data-model/how-tos/data-model-faq) — common questions
* [对象](/l/zh/user-guide/data-model/capabilities/objects) — 标准对象与自定义对象
* [数据模型常见问题解答](/l/zh/user-guide/data-model/how-tos/data-model-faq) — 常见问题
@@ -0,0 +1,180 @@
---
title: 创建多对多关系
description: 当双方都有多个条目时,使用连接对象将记录相互关联。
---
多对多关系使您能够在关系双方连接多个记录。 例如:许多 People 可以参与许多 Projects,并且每个 Project 可以包含许多 People。
<Warning>
**Lab 功能**:连接关系目前位于 Lab 中。 在按照本指南操作之前,请在 **Settings → Updates → Lab** 中启用它们。
</Warning>
<Note>
此功能还需要启用 **Advanced mode**(在 Settings 的右下角切换)。
</Note>
## 何时使用多对多
当关系双方都可能存在多个关联时,请使用多对多:
| 关系 | 示例 |
| ----------------- | -------------------------- |
| People ↔ Projects | 一个人参与多个项目;一个项目包含多名团队成员 |
| Companies ↔ Tags | 一个公司可以拥有多个标签;一个标签可以应用于多家公司 |
| Products ↔ Orders | 一个产品可以出现在多个订单中;一个订单包含多个产品 |
## 工作原理
Twenty 在多对多关系中使用 **连接对象** 模式。 连接对象位于两个对象之间,并存储它们之间的关联:
```
People ←→ Project Assignments ←→ Projects
```
该 **Project Assignments** 对象(连接对象)具有:
* 到 People 的关系(多对一)
* 到 Projects 的关系(多对一)
启用连接关系开关后,Twenty 将直接显示已关联的记录,而不再展示中间的连接对象记录。
## 先决条件
1. **在 Lab 中启用连接关系**:前往 **Settings → Updates → Lab** 并启用 **Junction Relations**
2. **启用 Advanced mode**:在 Settings 侧边栏的右下角开启 **Advanced mode**
3. 规划您的数据模型:
* 您要连接哪两个对象?
* 连接对象应如何命名?
## 步骤 1:创建连接对象
首先,创建用于保存关联的中间对象。
1. 进入 **设置 → 数据模型**
2. 点击 **+ 新建对象**
3. 使用描述性名称(例如,"Project Assignment"、"Team Member"、"Product Order"
4. 单击 **保存**
<Tip>
**命名约定**:使用能描述关系的名称,例如 "Project Assignment" 或 "Team Membership"。 这会让数据模型更易理解。
</Tip>
## 步骤 2:从连接对象创建关系
从连接对象向您要连接的两个对象添加关系字段。
### 第一条关系(连接对象 → 对象 A)
1. 在 **Settings → Data Model** 中选择您的连接对象
2. 点击 **+ 添加字段**
3. 将字段类型选择为 **Relation**
4. 选择第一个对象(例如,"People"
5. 将关系类型设置为 **Many-to-One**(多个分配可关联到一个人)
6. 为这些字段命名:
* 连接对象上的字段:例如,"Person"
* People 上的字段:例如,"Project Assignments"
7. 单击 **保存**
### 第二条关系(连接对象 → 对象 B)
1. 仍在连接对象中,点击 **+ Add Field**
2. 将字段类型选择为 **Relation**
3. 选择第二个对象(例如,"Projects"
4. 将关系类型设置为 **Many-to-One**
5. 为这些字段命名:
* 连接对象上的字段:例如,"Project"
* Projects 上的字段:例如,"Team Members"
6. 单击 **保存**
## 步骤 3:配置连接关系的显示方式
现在配置源对象以直接显示已关联的记录,跳过中间的连接对象。
1. 进入 **设置 → 数据模型**
2. 选择第一个对象(例如,"People"
3. 找到指向连接对象的关系字段(例如,"Project Assignments"
4. 点击以编辑该字段
5. 启用 **"This is a relation to a Junction Object"**
6. 选择 **Target relation**(例如,"Project" —— 连接对象上指向另一侧的字段)
7. 单击 **保存**
{/* TODO: Add image
<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}}/>
*/}
对另一侧对象重复上述操作:
1. 在 Data Model 中选择 "Projects"
2. 编辑 "Team Members" 关系字段
3. 启用连接关系开关
4. 将目标关系选择为 "Person"
5. 保存
## 结果
配置完成后:
* 在 **Person** 记录中,"Project Assignments" 字段将直接显示 **Projects**(而非分配记录)
* 在 **Project** 记录中,"Team Members" 字段将直接显示 **People**
连接对象仍然存在并存储关联,但 UI 呈现的是更简洁的多对多视图。
## 示例:People ↔ Projects
以下是完整的操作演示:
### 创建连接对象
* 名称:**Project Assignment**
* 描述:"将人员与其参与的项目关联起来"
### 添加关系
1. **Project Assignment → People**
* 类型:Many-to-One
* Assignment 上的字段:"Person"
* People 上的字段:"Project Assignments"
2. **Project Assignment → Projects**
* 类型:Many-to-One
* Assignment 上的字段:"Project"
* Projects 上的字段:"Team Members"
### 配置连接关系显示
1. 在 **People** 对象上:
* 编辑 "Project Assignments" 字段
* 启用连接关系开关
* 目标:"Project"
2. 在 **Projects** 对象上:
* 编辑 "Team Members" 字段
* 启用连接关系开关
* 目标:"Person"
### 开始使用
* 打开某个 Person 记录 → 直接查看其 Projects
* 打开某个 Project 记录 → 直接查看其团队成员
* 可从任一侧创建新的关联
## 为关联添加额外数据
由于连接对象是一个真实对象,您可以添加自定义字段来存储关系相关的信息:
* **角色**"Developer"、"Designer"、"Manager"
* **开始日期**:他们加入项目的时间
* **分配时长**:每周在该项目上的工时
要访问这些数据,请直接导航到连接对象,或通过 API 查询。
## 限制
* **CSV 导入/导出**:不支持直接导入多对多关系。 请改为将记录导入连接对象。
* **筛选器**:按多对多关系进行筛选的选项可能有限。
## 相关内容
* [关系字段](/l/zh/user-guide/data-model/capabilities/relation-fields) — 关系类型说明
* [创建自定义对象](/l/zh/user-guide/data-model/how-tos/create-custom-objects) — 如何创建对象
* [创建关系字段](/l/zh/user-guide/data-model/how-tos/create-relation-fields) — 基本关系设置
@@ -1,60 +1,60 @@
---
title: Create Relation Fields
description: Step-by-step guide to connecting objects with relation fields.
title: 创建关系字段
description: 通过关系字段逐步将对象连接起来。
---
Relation fields connect records from different objects—for example, linking People to Companies.
关系字段可连接不同对象的记录——例如,将人员链接到公司。
<Note>
**Relation names cannot be changed after creation** (they affect the API). Plan your names carefully.
**关系名称在创建后无法更改**(它们会影响 API)。 请谨慎规划名称。
</Note>
## Before You Start
## 开始之前
Decide:
请确定:
* Which objects are you connecting? (e.g., People → Companies)
* Which is the "one" side? (e.g., Company)
* Which is the "many" side? (e.g., People — many people work at one company)
* What should the field be named on each side?
* 要连接哪些对象? (例如,人员 → 公司)
* 哪一方是“一”端? (例如,公司)
* 哪一方是“多”端? (例如,人员—许多人在同一家公司工作)
* 两端的字段应如何命名?
See [Relation Fields](/l/zh/user-guide/data-model/capabilities/relation-fields) for relation types explained.
请参阅[关系字段](/l/zh/user-guide/data-model/capabilities/relation-fields),了解关系类型的说明。
## Steps
## 步骤
1. Go to **Settings → Data Model**
2. Select the object where you want the relation (typically the "many" side)
3. Click **+ Add Field**
4. Select **Relation** as the field type
5. Choose the **target object**
6. Select **One-to-Many** or **Many-to-One**
7. Enter field names for **both sides** of the relation
8. Click **Save**
1. 进入 **设置 → 数据模型**
2. 选择要创建关系的对象(通常为“多”端)
3. 点击 **+ 添加字段**
4. 将字段类型选择为 **关系**
5. 选择**目标对象**
6. 选择 **一对多** **多对一**
7. 为关系的**两端**输入字段名称
8. 单击 **保存**
## Example: People → Companies
## 示例:人员 → 公司
* Go to **Settings → Data Model → People**
* Add a Relation field
* Target: **Companies**
* Type: **Many-to-One**
* Field on People: **Company**
* Field on Companies: **Employees**
* 进入 **设置 → 数据模型 → 人员**
* 添加关系字段
* 目标:**公司**
* 类型:**多对一**
* 人员中的字段:**公司**
* 公司中的字段:**员工**
Now each Person can be linked to a Company, and each Company shows its People.
现在,每个人员都可以关联到一家公司,每家公司都会显示其人员。
## Deleting a Relation
## 删除关系
1. Go to **Settings → Data Model**
2. Find the relation field
3. Click **⋮ → Deactivate**
1. 进入 **设置 → 数据模型**
2. 找到该关系字段
3. 点击 **⋮ → 停用**
Links are preserved but hidden. Reactivate to restore.
关联会被保留但隐藏。 重新启用即可恢复。
<Note>
**Deleting a relation doesn't delete records.** Only the link between them is removed.
**删除关系不会删除记录。** 只会移除它们之间的关联。
</Note>
## Related
## 相关内容
* [Relation Fields](/l/zh/user-guide/data-model/capabilities/relation-fields) — types and limitations
* [How to Import Relations](/l/zh/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — bulk import linked records
* [关系字段](/l/zh/user-guide/data-model/capabilities/relation-fields) — 类型和限制
* [如何导入关系](/l/zh/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — 批量导入关联记录
@@ -1,22 +1,22 @@
---
title: Customize Your Data Model
description: Overview of data model customization options.
title: 自定义您的数据模型
description: 数据模型自定义选项概览。
---
Twenty's data model is fully customizable. Create objects, fields, and relations to match your business.
Twenty 的数据模型完全可自定义。 创建对象、字段和关系,以符合您的业务。
## Quick Links
## 快速链接
| I want to... | Guide |
| ------------------------ | -------------------------------------------------------------------------------------- |
| Create a new object | [How to Create Custom Objects](/l/zh/user-guide/data-model/how-tos/create-custom-objects) |
| Add fields to an object | [How to Create Custom Fields](/l/zh/user-guide/data-model/how-tos/create-custom-fields) |
| Connect objects together | [How to Create Relation Fields](/l/zh/user-guide/data-model/how-tos/create-relation-fields) |
| 我想要... | 指南 |
| ------- | ----------------------------------------------------------------- |
| 创建新对象 | [如何创建自定义对象](/l/zh/user-guide/data-model/how-tos/create-custom-objects) |
| 为对象添加字段 | [如何创建自定义字段](/l/zh/user-guide/data-model/how-tos/create-custom-fields) |
| 将对象关联起来 | [如何创建关联字段](/l/zh/user-guide/data-model/how-tos/create-relation-fields) |
## Learn More
## 了解更多
* [Understanding Your Data Model](/l/zh/user-guide/data-model/overview) — key concepts and planning tips
* [Objects](/l/zh/user-guide/data-model/capabilities/objects) — standard vs custom objects
* [Fields](/l/zh/user-guide/data-model/capabilities/fields) — all field types
* [Relation Fields](/l/zh/user-guide/data-model/capabilities/relation-fields) — connecting objects
* [Data Model FAQ](/l/zh/user-guide/data-model/how-tos/data-model-faq) — common questions
* [理解您的数据模型](/l/zh/user-guide/data-model/overview) — 关键概念与规划建议
* [对象](/l/zh/user-guide/data-model/capabilities/objects) — 标准对象与自定义对象
* [字段](/l/zh/user-guide/data-model/capabilities/fields) — 所有字段类型
* [关联字段](/l/zh/user-guide/data-model/capabilities/relation-fields) — 连接对象
* [数据模型常见问题](/l/zh/user-guide/data-model/how-tos/data-model-faq) — 常见问题
@@ -1,155 +1,155 @@
---
title: Data Model FAQ
description: Frequently asked questions about Twenty's data model.
title: 数据模型常见问题解答
description: 关于 Twenty 数据模型的常见问题。
---
## Object Management
## 对象管理
<AccordionGroup>
<Accordion title="Can I delete a custom object?">
Yes, custom objects can be deleted. You can also deactivate them first, which hides the object and its data from the interface while preserving the data.
<Accordion title="我可以删除自定义对象吗?">
是的,可以删除自定义对象。 您也可以先将其停用,这会在界面中隐藏该对象及其数据,同时保留这些数据。
</Accordion>
<Accordion title="Can I delete standard objects (People, Companies, etc.)?">
No, standard objects cannot be deleted. You can only deactivate them, which hides them from the interface but preserves the data.
<Accordion title="我可以删除标准对象(人员、公司等)吗?">
不可以,标准对象无法删除。 您只能将其停用,这会在界面中将其隐藏,但会保留数据。
</Accordion>
<Accordion title="How many custom objects can I create?">
You can create as many custom objects and fields as you need — the price doesn't change.
<Accordion title="我可以创建多少个自定义对象?">
您可以根据需要创建任意多的自定义对象和字段 — 价格不会变。
</Accordion>
<Accordion title="Can I rename a standard object?">
You can rename the label of standard objects (People, Companies, Opportunities), but not their API names. The API names are fixed for consistency across all Twenty workspaces.
<Accordion title="我可以重命名标准对象吗?">
您可以重命名标准对象的标签(PeopleCompaniesOpportunities),但不能更改其 API 名称。 为了在所有 Twenty 工作区中保持一致性,API 名称是固定的。
</Accordion>
<Accordion title="Can I change an object's icon?">
Yes, you can change the icon for both standard and custom objects in **Settings → Data Model**.
<Accordion title="我可以更改对象的图标吗?">
可以,您可以在 **设置 → 数据模型** 中更改标准对象和自定义对象的图标。
</Accordion>
<Accordion title="Can I reorder objects in the left navigation bar?">
Not yet. Object ordering in the navigation is currently fixed, but this feature is planned for a future release.
<Accordion title="我可以在左侧导航栏中重新排列对象吗?">
还不可以。 导航中的对象排序目前是固定的,但该功能计划于未来发布。
</Accordion>
<Accordion title="Can I hide objects from the left navigation bar?">
All active objects appear in the navigation. You can deactivate objects you don't need under **Settings → Data Model**.
<Accordion title="我可以隐藏左侧导航栏中的对象吗?">
所有活动对象都将出现在导航中。 您可以在 **设置 → 数据模型** 下停用不需要的对象。
</Accordion>
</AccordionGroup>
## Field Capabilities
## 字段功能
<AccordionGroup>
<Accordion title="Can I change a field type after creation?">
No, field types cannot be changed after creation. If you need a different type, create a new field with the correct type, migrate your data, then deactivate the old field.
<Accordion title="创建后我可以更改字段类型吗?">
不可以,字段类型在创建后无法更改。 如果您需要其他类型,请创建一个具有正确类型的新字段,迁移您的数据,然后停用旧字段。
</Accordion>
<Accordion title="Why do I need different singular and plural names?">
Our GraphQL API uses both forms for different operations:
<Accordion title="为什么我需要不同的单复数名称?">
我们的 GraphQL API 针对不同操作使用单复数形式:
* `createPerson` (singular) for single record actions
* `createPeople` (plural) for bulk operations
* `createPerson`(单数)用于单个记录操作
* `createPeople`(复数)用于批量操作
This creates limitations when singular and plural forms are the same, but it improves the developer experience.
当单复数形式相同时,这会产生限制,但它改善了开发者的体验。
</Accordion>
<Accordion title="Why are some field names protected?">
Certain field names like `Type` or `Application` are reserved for system use. Choose alternative names like `Category` or `Classification` instead.
<Accordion title="为什么某些字段名称是受保护的?">
某些字段名称如 `Type` `Application` 被保留用于系统使用。 请选择其他名称,如 `Category` `Classification`
</Accordion>
<Accordion title="What happens when I deactivate a field?">
* The field is hidden from the interface
* Existing data is preserved
* You can still access the field via API
* Existing relations remain but you can't create new ones
* You can reactivate the field later
<Accordion title="停用字段会发生什么?">
* 该字段会在界面中被隐藏
* 现有数据将被保留
* 您仍可通过 API 访问该字段
* 现有关联将保留,但您无法创建新的关联
* 您可以稍后重新启用该字段
</Accordion>
<Accordion title="Can I make a field required?">
Currently, you cannot make custom fields required. All fields accept empty values. You can use workflows to enforce required fields by sending alerts or blocking actions when fields are empty.
<Accordion title="我可以将字段设为必填吗?">
目前,您无法将自定义字段设为必填。 所有字段都接受空值。 您可以使用工作流在字段为空时发送警报或阻止操作,以强制执行必填字段。
</Accordion>
<Accordion title="What's the difference between unique and required?">
* **Unique**: No two records can have the same value in this field
* **Required**: The field must have a value (not currently supported for custom fields)
<Accordion title="唯一与必填有什么区别?">
* **唯一**:任意两条记录在该字段中的值不能相同
* **必填**:该字段必须有值(目前不支持自定义字段)
</Accordion>
<Accordion title="Can I create formula fields?">
Formula fields are coming in **Q1 2026**. In the meantime, you can use workflows to calculate and update field values automatically.
<Accordion title="我可以创建公式字段吗?">
公式字段将在 **2026 年第一季度** 推出。 同时,您可以使用工作流程来自动计算和更新字段值。
</Accordion>
<Accordion title="Can I have nested fields in my objects?">
Nested fields are coming in **Q1 2026**. Currently, you can use workflows to bring field values from related objects. For example, to display a company's industry on a Person record, create a custom field on People and use a workflow to synchronize the value.
<Accordion title="我可以在我的对象中使用嵌套字段吗?">
嵌套字段将在 **2026 年第一季度** 推出。 目前,您可以使用工作流程从相关对象中获取字段值。 例如,要在人员记录上显示公司的行业信息,可以在人员自定义字段中创建一个自定义字段,并使用工作流程来同步该值。
</Accordion>
<Accordion title="Can I reorder fields in objects?">
Field reordering will be available with custom layouts in **Q4 2025**. Currently, fields appear in alphabetical order.
<Accordion title="我可以在对象中重新排序字段吗?">
字段重新排序将伴随自定义布局在 **2025 年第四季度** 推出。 目前,字段按字母顺序显示。
</Accordion>
</AccordionGroup>
## Relations
## 关系
<AccordionGroup>
<Accordion title="Can I have a relation pointing to the same object?">
Yes! Self-referencing relations are supported and recommended for use cases like account hierarchies. For example, create a relation from Companies to Companies to track parent/child accounts.
<Accordion title="我可以创建指向同一对象的关系吗?">
是! 支持自引用关系,并建议在账户层级等用例中使用。 例如,从"公司"到"公司"创建关系,以跟踪父/子账户。
</Accordion>
<Accordion title="Can I create many-to-many relationships?">
Many-to-many relationships are coming in **H1 2026**. Currently, create an intermediate object with two one-to-many relationships as a workaround.
<Accordion title="我可以创建多对多关系吗?">
多对多关系将在 **2026 年上半年** 推出。 目前,可以创建一个中间对象,建立两个一对多关系作为替代方案。
For example, to link People and Projects (many-to-many), create a "Project Assignments" object with:
例如,要关联人员和项目(多对多),请创建一个 "项目分配" 对象,其中包含:
* A relation to People (many assignments → one person)
* A relation to Projects (many assignments → one project)
* 到人员的关系(多个分配 → 一名人员)
* 到项目的关系(多个分配 → 一个项目)
</Accordion>
<Accordion title="What are relations to multiple object types (Morph relationships)?">
These allow one object to relate to multiple different object types through a single field. For example, Notes can be attached to People AND Companies AND Opportunities simultaneously.
<Accordion title="什么是指向多个对象类型的关系(Morph 关系)?">
这使单个对象能够通过一个字段关联到多种不同的对象类型。 例如,备注可以同时附加到人员、公司和商机。
Each Note links to one Person, one Company, and one Opportunity at the same time.
每条备注同时关联到一名人员、一家公司和一个商机。
Learn more in [Relation Fields](/l/zh/user-guide/data-model/capabilities/relation-fields).
在 [关系字段](/l/zh/user-guide/data-model/capabilities/relation-fields) 中了解更多。
</Accordion>
<Accordion title="Can I have multiple relations between the same objects?">
Yes, you can create multiple relations between the same two objects. For example, a Company could have both a "Primary Contact" and "Billing Contact" relation to People.
<Accordion title="同一对对象之间可以有多个关系吗?">
可以,您可以在同一对对象之间创建多个关系。 例如,一个公司可以同时与人员建立 "主要联系人" 和 "账单联系人" 两个关系。
</Accordion>
<Accordion title="What happens to relations when I delete a record?">
When you delete a record, the relation link is removed from the related records. The related records themselves are not deleted.
<Accordion title="当我删除一条记录时,关系会发生什么变化?">
当您删除记录时,相关记录中的关系链接会被移除。 相关记录本身不会被删除。
</Accordion>
<Accordion title="Can I create circular relations?">
While technically possible, circular relations (A → B → C → A) should be avoided as they can cause confusion and potential performance issues.
<Accordion title="我可以创建循环关系吗?">
尽管在技术上可行,循环关系(A → B → C → A)应尽量避免,因为它们可能导致混淆并带来潜在的性能问题。
</Accordion>
</AccordionGroup>
## Access and Permissions
## 访问权限
<AccordionGroup>
<Accordion title="Where can I see and edit my data model?">
Go to **Settings → Data Model** to view and edit all your objects and fields.
<Accordion title="我在哪里可以查看和编辑我的数据模型?">
前往 **设置 → 数据模型** 查看并编辑您的所有对象和字段。
</Accordion>
<Accordion title="Why can't I see the Data Model under Settings?">
Reach out to your workspace administrator. Data model access is usually restricted to administrators only.
<Accordion title="为什么我在设置中看不到数据模型?">
请联系您的工作区管理员。 数据模型访问通常仅限于管理员。
</Accordion>
</AccordionGroup>
## Data Management
## 数据管理
<AccordionGroup>
<Accordion title="Is there a limit to how many records I can have?">
There's no hard limit on record counts. However, very large datasets may impact performance in some views. Use filters and views to manage large datasets effectively.
<Accordion title="记录数量是否有限制?">
记录数量没有硬性上限。 但是,非常大的数据集可能会影响某些视图中的性能。 使用筛选器和视图高效管理大型数据集。
</Accordion>
<Accordion title="Can I import data into custom objects?">
Yes, you can import CSV data into any object, including custom objects. The import process supports field mapping for custom fields. See [How to Prepare Your CSV Files](/l/zh/user-guide/data-migration/how-tos/prepare-your-csv-files).
<Accordion title="我可以将数据导入自定义对象吗?">
是的,您可以将 CSV 数据导入任何对象,包括自定义对象。 导入过程支持自定义字段的映射。 参见 [如何准备 CSV 文件](/l/zh/user-guide/data-migration/how-tos/prepare-your-csv-files)
</Accordion>
<Accordion title="Can I export my data model configuration?">
Currently, there's no built-in export for data model configuration. Contact support if you need to migrate your data model between workspaces.
<Accordion title="我可以导出我的数据模型配置吗?">
目前,数据模型配置没有内置导出功能。 如果您需要在工作区之间迁移数据模型,请联系支持团队。
</Accordion>
</AccordionGroup>
## Need More Help?
## 需要更多帮助吗?
Check our [Implementation Services](/l/zh/user-guide/getting-started/capabilities/implementation-services) for help with complex data model design.
查看我们的 [实施服务](/l/zh/user-guide/getting-started/capabilities/implementation-services) 以获取复杂数据模型设计方面的帮助。
@@ -1,180 +1,180 @@
---
title: Data Model
description: Learn what a data model is and how to design one that fits your business.
title: 数据模型
description: 了解什么是数据模型,以及如何设计一个适合您业务的模型。
image: /images/user-guide/fields/custom_data_model.png
---
<Frame>
<img src="/images/user-guide/fields/custom_data_model.png" alt="Data Model" />
<img src="/images/user-guide/fields/custom_data_model.png" alt="数据模型" />
</Frame>
## What is a Data Model?
## 什么是数据模型?
A data model is the structure that defines how information is organized in your CRM. Think of it as the **blueprint** of your customer data — you design it once, then fill it with your actual data.
数据模型是定义信息在您的CRM中如何组织的结构。 可以把它看作您的客户数据的**蓝图** — 您只需设计一次,然后用实际数据将其填充。
## Key Concepts
## 关键概念
### Objects
### 对象
**Objects** are the main categories of data in your CRM. Each object represents a type of thing you want to track.
**对象**是您的 CRM 中数据的主要类别。 每个对象代表您想跟踪的一类事物。
Twenty comes with standard objects:
Twenty 自带标准对象:
* **People** — individuals (contacts, leads, partners)
* **Companies** — organizations
* **Opportunities** — deals or sales
* **Notes** — attached notes on records
* **Tasks** — to-dos linked to records
* **People** — 个人(联系人、潜在客户、合作伙伴)
* **Companies** — 组织
* **Opportunities** — 交易或销售
* **Notes** — 附加到记录的备注
* **Tasks** — 与记录关联的待办事项
You can also create **custom objects** for anything specific to your business (e.g., Projects, Subscriptions, Events).
您也可以为特定于您业务的任何内容创建**自定义对象**(例如,ProjectsSubscriptionsEvents)。
### Fields
### 字段
**Fields** are the properties or attributes that describe each object. They store the actual information.
**字段**是用于描述每个对象的属性或特征。 它们存储实际信息。
For example, the **People** object has fields like:
例如,**People** 对象具有如下字段:
* Name
* Email
* Phone
* Job Title
* Company (a relation to the Companies object)
* 名称
* 电子邮件
* 电话
* 职位
* 公司(与 Companies 对象的关联)
Fields have different **types**: text, number, date, select, multi-select, relation, and more. You can add custom fields to any object.
字段有不同的**类型**:文本、数字、日期、单选、多选、关联等。 您可以向任何对象添加自定义字段。
### Records
### 记录
**Records** are the individual entries within an object — the actual data you create and manage.
**记录**是对象中的单个条目 — 您创建和管理的实际数据。
For example:
例如:
* "John Smith" is a **record** in the People object
* "Acme Corp" is a **record** in the Companies object
* "John Smith" 是 People 对象中的一个**记录**
* "Acme Corp" 是 Companies 对象中的一个**记录**
**An analogy:**
**类比:**
| Data Model Concept | Real-World Analogy |
| ------------------ | ------------------------------------------ |
| **Objects** | Sections in a book (the categories) |
| **Fields** | Columns in a spreadsheet (the properties) |
| **Records** | Rows in a spreadsheet (the actual entries) |
| 数据模型概念 | 现实类比 |
| ------ | ------------- |
| **对象** | 书中的章节(类别) |
| **字段** | 电子表格中的列(属性) |
| **记录** | 电子表格中的行(实际条目) |
You design the data model (objects + fields) once, then create many records within that structure.
您只需设计一次数据模型(对象 + 字段),然后在该结构内创建许多记录。
## Why Customize Your Data Model?
## 为什么要自定义您的数据模型?
Every business works differently. Customizing your data model means you can shape Twenty around **your** processes instead of forcing yours into a rigid system.
每个企业的运作方式都不尽相同。 自定义数据模型意味着您可以围绕**您的**流程来塑造 Twenty,而不是把您的流程硬塞进一个僵化的系统。
Twenty offers full flexibility:
Twenty 提供完全的灵活性:
* Create as many custom objects as you need
* Add unlimited custom fields
* The price doesn't change based on customization
* 根据需要创建任意数量的自定义对象
* 无限添加自定义字段
* 价格不会因自定义而变化
## Tips to Design Your Data Model
## 设计数据模型的提示
### 1. Start with Your Core Objects
### 1. 从您的核心对象开始
Identify the main concepts you work with. Twenty already provides:
识别您所使用的主要概念。 Twenty 已提供:
* **People** — your contacts
* **Companies** — your accounts
* **Opportunities** — your deals
* **People** — 您的联系人
* **Companies** — 您的客户
* **Opportunities** — 您的商机
Think about what else you might need:
想想您还可能需要什么:
* Stripe would need a `Subscriptions` object
* Airbnb would need a `Trips` object
* An accelerator would need a `Batches` object
* Stripe 需要一个 `Subscriptions` 对象
* Airbnb 需要一个 `Trips` 对象
* 加速器需要一个 `Batches` 对象
### 2. Use Fields for Variations, Not New Objects
### 2. 用字段表达变体,而不是创建新对象
If something is just a characteristic of an existing object, make it a **field**.
如果某项只是现有对象的一个特征,请将其设为**字段**
**Use fields for:**
**字段适用于:**
* Categories and labels (e.g., `Industry` for Companies)
* Status values (e.g., `Stage` for Opportunities)
* Attributes and properties
* 类别和标签(例如,Companies 的 `Industry`
* 状态值(例如,Opportunities 的 `Stage`
* 属性和特性
### 3. Create an Object When It Stands on Its Own
### 3. 当某个概念可独立存在时创建对象
If the concept has its own lifecycle, properties, or relationships, it deserves an object.
如果该概念有自己的生命周期、属性或关系,就值得设为一个对象。
**Create an object for:**
**为以下情况创建对象:**
* **Projects** — have deadlines, owners, and tasks
* **Subscriptions** — connect companies, products, and invoices
* **Events** — involve attendees and follow-up actions
* **Projects** — 具有截止日期、所有者和任务
* **Subscriptions** — 连接公司、产品和发票
* **Events** — 涉及与会者和后续行动
These go beyond a single field because they carry their own data and relationships.
这些超出单个字段的范围,因为它们携带自己的数据和关系。
### 4. Create an Object When Records Are Open-Ended
### 4. 当记录数量不确定时创建对象
If something can be linked multiple times and you don't know how many, use an object.
如果某个事物可以被多次关联且数量不确定,请使用对象。
**Bad approach:**
Creating fields like `Product 1`, `Product 2`, `Product 3`...
**不佳的做法:**
创建诸如 `Product 1``Product 2``Product 3` 等字段...
**Good approach:**
Create a `Products` object and relate it to records. This supports one, two, or a hundred products without changing your model.
**较佳的做法:**
创建一个 `Products` 对象并将其关联到记录。 这样就能在不更改模型的情况下支持一个、两个,甚至上百个产品。
### 5. Keep It Simple First
### 5. 先保持简单
Start with fields. Move to new objects only when you feel the limits:
从字段开始。 仅当您感到受限时,才迁移到新对象:
* Too many fields on one object
* Repeated records that should be separate
* Relationships that don't fit neatly
* 单个对象上的字段过多
* 重复的记录,本应分开
* 不够契合的关系
## Special Note on People, Companies, and Opportunities
## 关于人、公司和机会的特别注意事项
<Warning>
**Email and calendar sync only works with People, Companies, and Opportunities.**
**电子邮件和日历同步仅适用于人、公司和机会。**
These are the only objects where you can access synchronized emails and meetings from your mailbox/calendar. We recommend using them as much as possible.
只有在这些对象中,您才能从您的邮箱/日历访问已同步的电子邮件和会议。 我们建议尽可能多地使用它们。
</Warning>
**Best practices:**
**最佳实践:**
* If you need categories of People, use fields (not new objects)
* Example: Use a `Person Type` field with values "Prospect" and "Partner" instead of creating separate objects
* Create different **views** to filter: one showing partners, another showing prospects
* 如果您需要对人进行分类,请使用字段(而不是新对象)
* 示例:使用 `Person Type` 字段,取值为“潜在客户”和“合作伙伴”,而不是创建单独的对象
* 创建不同的**视图**进行筛选:一个显示合作伙伴,另一个显示潜在客户
**It's okay to have fields that don't apply to every record.** For example, a `Referral Link` field on People that only applies when `Person Type = Partner`. Hide this field from views where it's not relevant.
**并非每条记录都适用的字段是可以接受的。** 例如,在“人”对象上设置 `Referral Link` 字段,仅当 `Person Type = Partner` 时适用。 在不相关的视图中隐藏此字段。
## Questions to Guide Your Choice
## 指导选择的问题
Ask yourself:
问问自己:
<Check>Is this just a property of something I already have, or does it need its own properties?</Check>
<Check>Will I ever need to track multiple of these per record, without knowing how many?</Check>
<Check>Does this concept connect to several different objects, not just one?</Check>
<Check>Will it have its own lifecycle (stages, start/end dates)?</Check>
<Check>这只是我已拥有的事物的属性,还是需要它自己的属性?</Check>
<Check>我是否需要为每个记录跟踪多个此类项目,而无法提前知道有多少?</Check>
<Check>这一概念是否连接多个不同对象,而不仅仅是一个?</Check>
<Check>它是否有其自身的生命周期(阶段、开始/结束日期)?</Check>
If the answer is "yes" to one or more, it's probably time for a new object.
如果对一个或多个问题的回答是“是”,可能是时候创建一个新对象了。
## Accessing Your Data Model
## 访问您的数据模型
1. Go to **Settings** in the left sidebar
2. Click **Data Model**
3. View all your objects (standard and custom)
4. Click any object to see and edit its fields
1. 转到左侧边栏中的**设置**
2. 单击 **数据模型**
3. 查看您的所有对象(标准和自定义)
4. 单击任一对象以查看并编辑其字段
<Note>
**Don't see Data Model in Settings?**
**在设置中看不到数据模型?**
Access to the data model is usually restricted to administrators. Contact your workspace admin if you need access.
对数据模型的访问通常仅限于管理员。 如果您需要访问权限,请联系您的工作区管理员。
</Note>
## Next Steps
## 下一步
Once you've planned your data model:
一旦您规划好数据模型:
* [How to Create Custom Objects](/l/zh/user-guide/data-model/how-tos/create-custom-objects)
* [How to Create Custom Fields](/l/zh/user-guide/data-model/how-tos/create-custom-fields)
* [How to Create Relation Fields](/l/zh/user-guide/data-model/how-tos/create-relation-fields)
* [如何创建自定义对象](/l/zh/user-guide/data-model/how-tos/create-custom-objects)
* [如何创建自定义字段](/l/zh/user-guide/data-model/how-tos/create-custom-fields)
* [如何创建关系字段](/l/zh/user-guide/data-model/how-tos/create-relation-fields)
## Need Help?
## 需要帮助?
Our team can help you design and create the data model you need. Discover our [Implementation Services](/l/zh/user-guide/getting-started/capabilities/implementation-services).
我们的团队可以协助您设计和创建所需的数据模型。 发现我们的[实施服务](/l/zh/user-guide/getting-started/capabilities/implementation-services)