记录字段值类型

查找 (Lookup) 字段不是一种具体的字段类型，我们可以从关联表查找任何一种字段，查找字段的类型是由关联表原字段决定的，并且具有 isLookup 属性，查找字段是不可以被编辑的。

所有字段的返回值都可能存在 isMultipleCellValue: true 的情况。

这是因为字段可能被查找（Lookup）的。当关联值可以多选的时候，查找字段的值必然是数组值
字段可配置，比如成员字段和关联字段可以配置单选或者多选，在代码中，你可以通过 field.isMultipleCellValue 来判断字段是否为多值。

不应当用字段类型来判断是否允许写入，而是通过字段上的 isComputed 来判断。

1. 数字字段 (Number Field)

type: number
写入类型: number
返回类型:
- isMultipleCellValue: false: number
- isMultipleCellValue: true: number[]

示例：

// 写入值
42

// 返回值 (isMultipleCellValue: false)
42

// 返回值 (isMultipleCellValue: true)
[42, 17, 99]

2. 单行文本字段 (Single Line Text Field)

type: singleLineText
写入类型: string
返回类型:
- isMultipleCellValue: false: string
- isMultipleCellValue: true: string[]

示例：

// 写入值
"Hello, Teable!"

// 返回值 (isMultipleCellValue: false)
"Hello, Teable!"

// 返回值 (isMultipleCellValue: true)
["Hello, Teable!", "Welcome", "Good day"]

3. 长文本字段 (Long Text Field)

type: longText
写入类型: string
返回类型:
- isMultipleCellValue: false: string
- isMultipleCellValue: true: string[]

示例：

// 写入值
"This is a long text field that can contain multiple paragraphs..."

// 返回值 (isMultipleCellValue: false)
"This is a long text field that can contain multiple paragraphs..."

// 返回值 (isMultipleCellValue: true)
["This is a long text...", "Another long text...", "Yet another long text..."]

4. 单选字段 (Single Select Field)

type: singleSelect
写入类型: string (选项值)
返回类型:
- isMultipleCellValue: false: string
- isMultipleCellValue: true: string[]

示例：

// 写入值
"Option A"

// 返回值 (isMultipleCellValue: false)
"Option A"

// 返回值 (isMultipleCellValue: true)
["Option A", "Option B", "Option C"]

5. 多选字段 (Multiple Select Field)

type: multipleSelect
写入类型: string[] (选项值数组)
返回类型: string[]

示例：

// 写入值
["Red", "Blue", "Green"]

// 返回值
["Red", "Blue", "Green"]

6. 关联字段 (Link Field)

type: link
写入类型:
- isMultipleCellValue: false: { id: string }
- isMultipleCellValue: true: { id: string }[]
返回类型:
- isMultipleCellValue: false: { id: string, title?: string }
- isMultipleCellValue: true: { id: string, title?: string }[]

示例：

// 写入值 (isMultipleCellValue: false)
{ id: "rec123456" }

// 写入值 (isMultipleCellValue: true)
[{ id: "rec123456" }, { id: "rec789012" }]

// 返回值 (isMultipleCellValue: false)
{ id: "rec123456", title: "Related Record 1" }

// 返回值 (isMultipleCellValue: true)
[
  { id: "rec123456", title: "Related Record 1" },
  { id: "rec789012", title: "Related Record 2" }
]

7. 公式字段 (Formula Field)

type: formula
写入类型: 不可直接写入
返回类型: 取决于公式结果，可能是 string | number | boolean 或它们的数组形式

示例：

// 返回值 (isMultipleCellValue: false)
42 // 或 "Result" 或 true

// 返回值 (isMultipleCellValue: true)
[42, 17, 99] // 或 ["Result1", "Result2"] 或 [true, false, true]

8. 附件字段 (Attachment Field)

上传一个附件到附件字段需要使用独立的 API，详情请查看上传附件章节

type: attachment

写入类型:

{
  id: string;
  name: string;
  path: string;
  token: string; // 唯一标识
  size: number; // 文件字节大小
  mimetype: string; // 文件类型
  presignedUrl?: string; // 文件预览/下载地址
  width?: number; // 图片宽度
  height?: number; // 图片高度
}[]

返回类型:

{
  id: string;
  name: string;
  path: string;
  token: string; // 唯一标识
  size: number; // 文件字节大小
  mimetype: string; // 文件类型
  presignedUrl?: string; // 文件预览/下载地址
  width?: number; // 图片宽度
  height?: number; // 图片高度
}[]

示例：

// 写入值
[
  {
    name: "document.pdf",
    type: "application/pdf",
    token: "abc123",
    size: 1024000
  }
]

// 返回值
[
  {
    id: "att123",
    name: "document.pdf",
    path: "/uploads/document.pdf",
    token: "abc123",
    size: 1024000,
    mimetype: "application/pdf",
    presignedUrl: "https://example.com/preview/document.pdf",
  },
  {
    id: "att456",
    name: "image.jpg",
    path: "/uploads/image.jpg",
    token: "def456",
    size: 2048000,
    mimetype: "image/jpeg",
    presignedUrl: "https://example.com/preview/image.jpg",
    width: 1920,
    height: 1080
  }
]

9. 日期字段 (Date Field)

type: date
写入类型: string (ISO 8601格式)
返回类型:
- isMultipleCellValue: false: string (ISO 8601格式)
- isMultipleCellValue: true: string[] (ISO 8601格式) 可以使用 new Date().toISOString() 来获得ISO 8601 时间格式

示例：

// 写入值
"2024-09-02T02:51:03.875Z"

// 返回值 (isMultipleCellValue: false)
"2024-09-02T02:51:03.875Z"

// 返回值 (isMultipleCellValue: true)
["2024-09-02T02:51:03.875Z", "2024-09-02T02:51:03.875Z"]

10. 创建时间字段 (Created Time Field)

type: createdTime
写入类型: 不可直接写入
返回类型:
- isMultipleCellValue: false: string (ISO 8601格式)
- isMultipleCellValue: true: string[] (ISO 8601格式)

示例：

// 返回值 (isMultipleCellValue: false)
"2023-04-15T10:30:00Z"

// 返回值 (isMultipleCellValue: true)
["2023-04-15T10:30:00Z", "2023-04-16T14:45:00Z"]

11. 最后修改时间字段 (Last Modified Time Field)

type: lastModifiedTime
写入类型: 不可直接写入
返回类型:
- isMultipleCellValue: false: string (ISO 8601格式)
- isMultipleCellValue: true: string[] (ISO 8601格式)

示例：

// 返回值 (isMultipleCellValue: false)
"2023-04-15T10:30:00Z"

// 返回值 (isMultipleCellValue: true)
["2023-04-15T10:30:00Z", "2023-04-16T14:45:00Z"]

12. 勾选字段 (Checkbox Field)

type: checkbox
写入类型: boolean
返回类型:
- isMultipleCellValue: false: boolean
- isMultipleCellValue: true: boolean[]

示例：

// 写入值
true

// 返回值 (isMultipleCellValue: false)
true

// 返回值 (isMultipleCellValue: true)
[true, false, true]

13. 汇总字段 (Rollup Field)

type: rollup
写入类型: 不可直接写入
返回类型: 取决于汇总配置，可能是 number | string 或它们的数组形式

示例：

// 返回值 (isMultipleCellValue: false)
42 // 或 "Summary Result"

// 返回值 (isMultipleCellValue: true)
[42, 17, 99] // 或 ["Summary 1", "Summary 2"]

14. 评分字段 (Rating Field)

type: rating
写入类型: number
返回类型:
- isMultipleCellValue: false: number
- isMultipleCellValue: true: number[]

示例：

// 写入值
4

// 返回值 (isMultipleCellValue: false)
4

// 返回值 (isMultipleCellValue: true)
[4, 3, 5]

15. 自动编号字段 (Auto Number Field)

type: autoNumber
写入类型: 不可直接写入
返回类型:
- isMultipleCellValue: false: number
- isMultipleCellValue: true: number[]

示例：

// 返回值 (isMultipleCellValue: false)
42

// 返回值 (isMultipleCellValue: true)
[42, 43, 44]

16. 用户字段 (User Field)

type: user
写入类型:
- isMultipleCellValue: false: { id: string, title: string }
- isMultipleCellValue: true: { id: string, title: string }[]
返回类型:
- isMultipleCellValue: false: { id: string, title: string, email?: string, avatar?: string }
- isMultipleCellValue: true: { id: string, title: string, email?: string, avatar?: string }[]

示例：

// 写入值 (isMultipleCellValue: false)
{ id: "user123", title: "John Doe" }

// 写入值 (isMultipleCellValue: true)
[
  { id: "user123", title: "John Doe" },
  { id: "user456", title: "Jane Smith" }
]

// 返回值 (isMultipleCellValue: false)
{
  id: "user123",
  title: "John Doe",
  email: "john@example.com",
  avatar: "https://example.com/avatar.jpg"
}

// 返回值 (isMultipleCellValue: true)
[
  {
    id: "user123",
    title: "John Doe",
    email: "john@example.com",
    avatar: "https://example.com/avatar1.jpg"
  },
  {
    id: "user456",
    title: "Jane Smith",
    email: "jane@example.com",
    avatar: "https://example.com/avatar2.jpg"
  }
]

17. 创建者字段 (Created By Field)

写入类型: 不可直接写入
返回类型:
- isMultipleCellValue: false: { id: string, title: string, email?: string, avatar?: string }
- isMultipleCellValue: true: { id: string, title: string, email?: string, avatar?: string }[] 示例：

// 返回值 (isMultipleCellValue: false)
{
  id: "user123",
  title: "John Doe",
  email: "john@example.com",
  avatar: "https://example.com/avatar.jpg"
}

// 返回值 (isMultipleCellValue: true)
[
  {
    id: "user123",
    title: "John Doe",
    email: "john@example.com",
    avatar: "https://example.com/avatar1.jpg"
  },
  {
    id: "user456",
    title: "Jane Smith",
    email: "jane@example.com",
    avatar: "https://example.com/avatar2.jpg"
  }
]

18. 最后修改者字段 (Last Modified By Field)

写入类型: 不可直接写入
返回类型:
- isMultipleCellValue: false: { id: string, title: string, email?: string, avatar?: string }
- isMultipleCellValue: true: { id: string, title: string, email?: string, avatar?: string }[]

示例：

// 返回值 (isMultipleCellValue: false)
{
  id: "user123",
  title: "John Doe",
  email: "john@example.com",
  avatar: "https://example.com/avatar.jpg"
}

// 返回值 (isMultipleCellValue: true)
[
  {
    id: "user123",
    title: "John Doe",
    email: "john@example.com",
    avatar: "https://example.com/avatar1.jpg"
  },
  {
    id: "user456",
    title: "Jane Smith",
    email: "jane@example.com",
    avatar: "https://example.com/avatar2.jpg"
  }
]

入门

记录

API Reference

记录字段值类型

1. 数字字段 (Number Field)

2. 单行文本字段 (Single Line Text Field)

3. 长文本字段 (Long Text Field)

4. 单选字段 (Single Select Field)

5. 多选字段 (Multiple Select Field)

6. 关联字段 (Link Field)

7. 公式字段 (Formula Field)

8. 附件字段 (Attachment Field)

9. 日期字段 (Date Field)

10. 创建时间字段 (Created Time Field)

11. 最后修改时间字段 (Last Modified Time Field)

12. 勾选字段 (Checkbox Field)

13. 汇总字段 (Rollup Field)

14. 评分字段 (Rating Field)

15. 自动编号字段 (Auto Number Field)

16. 用户字段 (User Field)

17. 创建者字段 (Created By Field)

18. 最后修改者字段 (Last Modified By Field)

​1. 数字字段 (Number Field)

​2. 单行文本字段 (Single Line Text Field)

​3. 长文本字段 (Long Text Field)

​4. 单选字段 (Single Select Field)

​5. 多选字段 (Multiple Select Field)

​6. 关联字段 (Link Field)

​7. 公式字段 (Formula Field)

​8. 附件字段 (Attachment Field)

​9. 日期字段 (Date Field)

​10. 创建时间字段 (Created Time Field)

​11. 最后修改时间字段 (Last Modified Time Field)

​12. 勾选字段 (Checkbox Field)

​13. 汇总字段 (Rollup Field)

​14. 评分字段 (Rating Field)

​15. 自动编号字段 (Auto Number Field)

​16. 用户字段 (User Field)

​17. 创建者字段 (Created By Field)

​18. 最后修改者字段 (Last Modified By Field)

1. 数字字段 (Number Field)

2. 单行文本字段 (Single Line Text Field)

3. 长文本字段 (Long Text Field)

4. 单选字段 (Single Select Field)

5. 多选字段 (Multiple Select Field)

6. 关联字段 (Link Field)

7. 公式字段 (Formula Field)

8. 附件字段 (Attachment Field)

9. 日期字段 (Date Field)

10. 创建时间字段 (Created Time Field)

11. 最后修改时间字段 (Last Modified Time Field)

12. 勾选字段 (Checkbox Field)

13. 汇总字段 (Rollup Field)

14. 评分字段 (Rating Field)

15. 自动编号字段 (Auto Number Field)

16. 用户字段 (User Field)

17. 创建者字段 (Created By Field)

18. 最后修改者字段 (Last Modified By Field)