模型字段说明
字段通用属性
- 字段名称：在内容管理界面上显示的友好的文本名称
- 字段标识：对应数据库中的字段名，通过 SDK 或者 HTTP API 读写时会依据字段标识
- 字段描述：在内容管理界面上展示的描述信息
- 默认值：在内容管理界面中，如果用户不填写内容，默认会取默认值
- 是否必填：限制某个字段是否必须填写，不填写则会报错
- 是否唯一：开启后，该字段内容在一个内容表中只能存在一份
- 是否为主显示列：在被其他内容表关联时，显示的列表中默认会依据主显示列的字段来显示，默认是根据 _id 来作为主显示列
支持的字段类型
目前支持以下类型：文本、布尔值、数字、数组、对象、JSON、邮箱、电话、网址、图片、富文本、Markdown、日期时间、枚举、地理位置、文件、自动编号、地区、关联关系(新)
| 类型 | 说明 | 示例 | 备注 |
|---|---|---|---|
| 文本 | 用于存储字符串类型的文本信息，支持单行文本和多行文本。 | "Hello, World!" | 最长可存储 4000 字节，若需存储更长内容，可使用富文本字段 |
| 布尔值 | 用于存储真或假的逻辑值。 | true/ false | - |
| 数字 | 用于存储整数或浮点数 | 42 / 3.14 | 整数位加小数位不超过 16 位，小数计算可能有精度缺失 |
| 数组 | 用于存储一组相同类型的元素。 | [1, 2, 3] | - |
| 对象 | 用于存储键值对的集合，支持类型嵌套。 | {"name": "Alice", "age": 30} | - |
| Json | 用于存储 JSON 格式的数据。 | {"key": "value"} | 适用于复杂的数据结构或动态属性 |
| 邮箱 | 用于存储电子邮件地址。 | "john@example.com" | - |
| 电话 | 用于存储电话号码，支持手机号码和固定电话。 | "18888888888" | 手机号码校验规则为符合大陆手机号规范的 11 位字符串，固定电话校验规则为有 0 开头的 2，3 位区号或者没有区号的 7-8 位字符串 |
| 网址 | 用于存储网页链接。 | "https://www.example.com" | - |
| 图片 | 用于存储图片文件的链接或路径。 | "cloud://xxx.com/path/to/image.jpg" / "https://foo.bar/example.png" | 单张图片最大 10M |
| 多媒体 | 用于存储音频或视频文件的链接或路径。 | "cloud://xxx.com/path/to/a.mp4" / "https://foo.bar/example.mp4" | 单文件最大 500M |
| 富文本 | 用于存储格式化的文本内容，如 HTML。 | <p>This is a paragraph</p> | 最大长度 262144 字节 |
| Markdown | 用于存储 Markdown 格式的文本内容。 | "# This is a heading" | 可使用 Markdown 编辑器编辑内容，并支持实时预览 |
| 日期时间 | 用于存储日期和时间信息。 | "1645977600000" | 时间戳，单位 ms |
| 枚举 | 用于存储预定义的值集合中的值，支持单选或多选。 | "am" / ["1", "2"] | 枚举单选存储字符串，枚举多选存储数组 |
| 地理位置 | 用于存储地理位置信息。 | {"geopoint": {"type": "Point","coordinates": [40.56, 5.89]}, "address": "深圳市南山区深南大道\*\*号"} | 固定格式的对象，address 是位置的文字说明，coordinates 是包含经纬度的数组 |
| 文件 | 用于存储文件的链接或路径。 | "cloud:://xxx.com/path/to/file.pdf" / "https://foo.bar/example.pdf" | 单文件最大 500M |
| 自动编号 | 用于自动生成唯一的编号。 | 1001 | 若不填则后端自动补齐，若传参，使用客户定义的值 |
| 地区 | 用于存储地区信息。 | "陕西省,西安市,雁塔区" / "北京市,海淀区" | 以逗号分割的地理位置，支持省、市、区 |
| 关联关系(新) | 用于表示模型之间的关联关系。 | - | 支持一对一，多对一，一对多 |