138 lines
2.4 KiB
Markdown
138 lines
2.4 KiB
Markdown
# Collection 协议
|
||
|
||
Collection 是 NocoBase 的中枢，是一种用于描述数据结构（数据表和字段）的协议，和关系型数据库的概念非常接近，但不仅限于关系型数据库，也可以是 NoSQL 数据库、HTTP API 等数据源。
|
||
|
||
<img src="./schema.svg" style="max-width: 800px;" >
|
||
|
||
现阶段基于 Collection 协议实现了关系型数据库的对接（db.collections），NoSQL 数据库、HTTP API 等数据源在未来也会逐步实现。
|
||
|
||
Collection 协议主要包括 CollectionOptions 和 FieldOptions 两部分，因为 Field 是可扩展的，所以 FieldOptions 的参数非常灵活。
|
||
|
||
## CollectionOptions
|
||
|
||
```ts
|
||
interface CollectionOptions {
|
||
name: string;
|
||
title?: string;
|
||
// 树结构表，TreeRepository
|
||
tree?: 'adjacency-list' | 'closure-table' | 'materialized-path' | 'nested-set';
|
||
// 父子继承
|
||
inherits?: string | string[];
|
||
fields?: FieldOptions[];
|
||
timestamps?: boolean;
|
||
paranoid?: boolean;
|
||
sortable?: CollectionSortable;
|
||
model?: string;
|
||
repository?: string;
|
||
[key: string]: any;
|
||
}
|
||
|
||
type CollectionSortable = string | boolean | { name?: string; scopeKey?: string };
|
||
```
|
||
|
||
## FieldOptions
|
||
|
||
通用的字段参数
|
||
|
||
```ts
|
||
interface FieldOptions {
|
||
name: string;
|
||
type: string;
|
||
hidden?: boolean;
|
||
index?: boolean;
|
||
interface?: string;
|
||
uiSchema?: ISchema;
|
||
```
|
||
|
||
[UI Schema 的介绍点此查看](/development/client/ui-schema-designer/what-is-ui-schema)
|
||
|
||
### Field Type
|
||
|
||
Field Type 包括 Attribute Type 和 Association Type 两类：
|
||
|
||
**Attribute Type**
|
||
|
||
- 'boolean'
|
||
- 'integer'
|
||
- 'bigInt'
|
||
- 'double'
|
||
- 'real'
|
||
- 'decimal'
|
||
- 'string'
|
||
- 'text'
|
||
- 'password'
|
||
- 'date'
|
||
- 'time'
|
||
- 'array'
|
||
- 'json'
|
||
- 'jsonb'
|
||
- 'uuid'
|
||
- 'uid'
|
||
- 'formula'
|
||
- 'radio'
|
||
- 'sort'
|
||
- 'virtual'
|
||
|
||
**Association Type**
|
||
|
||
- 'belongsTo'
|
||
- 'hasOne'
|
||
- 'hasMany'
|
||
- 'belongsToMany'
|
||
|
||
### Field Interface
|
||
|
||
**Basic**
|
||
|
||
- input
|
||
- textarea
|
||
- phone
|
||
- email
|
||
- integer
|
||
- number
|
||
- percent
|
||
- password
|
||
- icon
|
||
|
||
**Choices**
|
||
|
||
- checkbox
|
||
- select
|
||
- multipleSelect
|
||
- radioGroup
|
||
- checkboxGroup
|
||
- chinaRegion
|
||
|
||
**Media**
|
||
|
||
- attachment
|
||
- markdown
|
||
- richText
|
||
|
||
**Date & Time**
|
||
|
||
- datetime
|
||
- time
|
||
|
||
**Relation**
|
||
|
||
- linkTo - `type: 'belongsToMany'`
|
||
- oho - `type: 'hasOne'`
|
||
- obo - `type: 'belongsTo'`
|
||
- o2m - `type: 'hasMany'`
|
||
- m2o - `type: 'belongsTo'`
|
||
- m2m - `type: 'belongsToMany'`
|
||
|
||
**Advanced**
|
||
|
||
- formula
|
||
- sequence
|
||
|
||
**System info**
|
||
|
||
- id
|
||
- createdAt
|
||
- createdBy
|
||
- updatedAt
|
||
- updatedBy
|