feat: update release note
@ -1,4 +1,4 @@
 | 
			
		||||
# v0.8.1: Collection 模板
 | 
			
		||||
# v0.9.0: Collection 模板
 | 
			
		||||
 | 
			
		||||
<img src="./v08-1-collection-templates/v08-1-collection-templates.jpg">
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										33
									
								
								docs/en-US/welcome/release/formulas.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						@ -0,0 +1,33 @@
 | 
			
		||||
# v0.9.0:字段的计算公式插件
 | 
			
		||||
 | 
			
		||||
NocoBase 目前提供了两种计算公式插件:
 | 
			
		||||
 | 
			
		||||
- `@nocobase/plugin-math-formula-field` Math 公式
 | 
			
		||||
- `@nocobase/plugin-excel-formula-field` Excel 公式(感谢 [azriel46d](https://github.com/nocobase/nocobase/pull/906) 贡献)
 | 
			
		||||
 | 
			
		||||
## Math Formula
 | 
			
		||||
 | 
			
		||||
基于 [Math.js](https://mathjs.org/) 实现,它具有支持符号计算的灵活表达式解析器,大量内置函数和常量,并提供了集成的解决方案来处理不同的数据类型,例如数字,大数,复数,分数,单位和矩阵。
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
import { evaluate } from 'mathjs';
 | 
			
		||||
// expressions
 | 
			
		||||
evaluate('1.2 * (2 + 4.5)')     // 7.8
 | 
			
		||||
evaluate('12.7 cm to inch')     // 5 inch
 | 
			
		||||
evaluate('sin(45 deg) ^ 2')     // 0.5
 | 
			
		||||
evaluate('9 / 3 + 2i')          // 3 + 2i
 | 
			
		||||
evaluate('det([-1, 2; 3, 1])')  // -7
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
<img src="./formulas/math-form.jpg" />
 | 
			
		||||
 | 
			
		||||
## Excel Formula
 | 
			
		||||
 | 
			
		||||
基于 [Formula.js](https://formulajs.info/) 实现,详细用法参考 [Formula.js functions](https://formulajs.info/functions/)。
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
SUM(-5, 15, 32) // 42
 | 
			
		||||
IF(true, 'Hello!', 'Goodbye!') // Hello!
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
<img src="./formulas/excel-form.jpg" />
 | 
			
		||||
							
								
								
									
										
											BIN
										
									
								
								docs/en-US/welcome/release/formulas/excel-form.jpg
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 310 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								docs/en-US/welcome/release/formulas/math-form.jpg
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 307 KiB  | 
@ -1,5 +1,65 @@
 | 
			
		||||
# Release Notes
 | 
			
		||||
 | 
			
		||||
## 2022/01/11 ~v0.9.0-alpha.1
 | 
			
		||||
 | 
			
		||||
### 协议变更
 | 
			
		||||
 | 
			
		||||
- [内核](https://github.com/nocobase/nocobase/tree/main/packages/core) 继续采用 [Apache 2.0 协议](https://github.com/nocobase/nocobase/blob/main/LICENSE-APACHE-2.0)
 | 
			
		||||
- [插件](https://github.com/nocobase/nocobase/tree/main/packages/plugins) 变更为 [AGPL 3.0 协议](https://github.com/nocobase/nocobase/blob/main/LICENSE-AGPL)
 | 
			
		||||
 | 
			
		||||
### 内核改进
 | 
			
		||||
 | 
			
		||||
- [NocoBase 的 Logging 系统](/welcome/release/logger)
 | 
			
		||||
- [数据表继承](/welcome/release/inherits)
 | 
			
		||||
- [数据表模板](/welcome/release/collection-templates)
 | 
			
		||||
- 数据表主键默认为 BigInt 类型
 | 
			
		||||
- 提供更健全的 ACL 模块
 | 
			
		||||
- 关系字段组件支持切换为简单的 Select 组件
 | 
			
		||||
- 支持页面标签页
 | 
			
		||||
- 表格、看板支持固定区块
 | 
			
		||||
- 提供更为友好的关系筛选
 | 
			
		||||
- 日历区块支持显示农历
 | 
			
		||||
- 日历区块支持配置、删除重复日程
 | 
			
		||||
- 表格区块横向滚动条优化,支持调整列宽
 | 
			
		||||
- 弹窗可配置尺寸大小
 | 
			
		||||
 | 
			
		||||
### 新增插件
 | 
			
		||||
 | 
			
		||||
- Excel 数据导入插件
 | 
			
		||||
- 图形化数据表配置插件
 | 
			
		||||
- SSO 插件:OIDC、SAML
 | 
			
		||||
- 地图插件
 | 
			
		||||
- iframe 区块插件
 | 
			
		||||
- 数据快照插件
 | 
			
		||||
- 应用复制、备份、迁移插件
 | 
			
		||||
- [字段的计算公式插件:Math Formula 和 Excel Formula](/welcome/release/formulas)
 | 
			
		||||
 | 
			
		||||
### 其他插件优化
 | 
			
		||||
 | 
			
		||||
- 数据表配置:
 | 
			
		||||
  - 数据表支持筛选
 | 
			
		||||
  - 数据表支持设置标题字段
 | 
			
		||||
  - 数据表支持分类
 | 
			
		||||
- 工作流:
 | 
			
		||||
  - 修复触发器取值功能
 | 
			
		||||
  - 前端代码重构,插件独立化
 | 
			
		||||
  - 修复执行历史加载问题
 | 
			
		||||
  - 数据表触发后执行不再使用相同事务,优化执行流程
 | 
			
		||||
  - 新增调度器和触发缓存,以队列执行方式解决并发问题
 | 
			
		||||
  - 修复定时任务结束时间组件问题
 | 
			
		||||
  - 修复定时任务跳秒问题
 | 
			
		||||
  - 支持工作流级别复制
 | 
			
		||||
  - 重构上下文及节点变量数据结构
 | 
			
		||||
- 验证码:
 | 
			
		||||
  - 新增验证码配置面板
 | 
			
		||||
- 文件管理器:
 | 
			
		||||
  - 修复本地存储静态文件服务中间件
 | 
			
		||||
  - 本地存储空 baseUrl 配置容错处理
 | 
			
		||||
- 自动编号:
 | 
			
		||||
  - 重构为由数据表记录序列
 | 
			
		||||
  - 增加可输入和匹配规则的配置
 | 
			
		||||
  - 修复生成数字不小于配置的起始值
 | 
			
		||||
 | 
			
		||||
## 2022/10/31 ~ v0.8.0-alpha.1
 | 
			
		||||
 | 
			
		||||
- Starting with v0.8, NocoBase begins to provide an available plugin manager and development documentation. 
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										74
									
								
								docs/en-US/welcome/release/inherits.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						@ -0,0 +1,74 @@
 | 
			
		||||
# v0.9.0: 数据表继承
 | 
			
		||||
 | 
			
		||||
数据表继承基于 [PostgreSQL 的 INHERITS 语法](https://www.postgresql.org/docs/current/tutorial-inheritance.html) 实现,仅限于 PostgreSQL 数据库安装的 NocoBase 时才会提供。
 | 
			
		||||
 | 
			
		||||
## 示例
 | 
			
		||||
 | 
			
		||||
我们从一个例子开始,假设要做一个教学系统,有三类用户:学生、家长和老师。
 | 
			
		||||
 | 
			
		||||
如果没有继承,要分别为三类用户建表:
 | 
			
		||||
 | 
			
		||||
- 学生:姓名、年龄、性别、身份证
 | 
			
		||||
- 家长:姓名、年龄、性别、职业、学历
 | 
			
		||||
- 老师:姓名、年龄、性别、教龄、已婚
 | 
			
		||||
 | 
			
		||||
有了数据表继承之后,共同的信息就可以提炼出来:
 | 
			
		||||
 | 
			
		||||
- 用户:姓名、年龄、性别
 | 
			
		||||
- 学生:身份证
 | 
			
		||||
- 家长:职业、学历
 | 
			
		||||
- 老师:教龄、已婚
 | 
			
		||||
 | 
			
		||||
ER 图如下:
 | 
			
		||||
 | 
			
		||||
<img src="./inherits/er.svg" style="max-width: 700px;" />
 | 
			
		||||
 | 
			
		||||
注:子表 ID 和父表 ID 共享序列
 | 
			
		||||
 | 
			
		||||
## 配置数据表继承
 | 
			
		||||
 | 
			
		||||
Inherits 字段选择需要继承的数据表
 | 
			
		||||
 | 
			
		||||
<img src="./inherits/inherit.jpg" />
 | 
			
		||||
 | 
			
		||||
通过代码配置如下:
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
db.collection({
 | 
			
		||||
  name: 'users',
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
db.collection({
 | 
			
		||||
  name: 'students',
 | 
			
		||||
  inherits: 'users',
 | 
			
		||||
});
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
注意:
 | 
			
		||||
 | 
			
		||||
- 继承的表并不能随意选择,主键必须是唯一序列,比如 uuid 或者所有继承线路上的表的 id 自增序列都用同一个
 | 
			
		||||
- Inherits 参数不能被编辑
 | 
			
		||||
- 如果有继承关系,被继承的父表不能被删除
 | 
			
		||||
 | 
			
		||||
## 数据表字段列表
 | 
			
		||||
 | 
			
		||||
字段列表里同步显示继承的父表字段,父表字段不可以修改,但可以重写(Override)
 | 
			
		||||
 | 
			
		||||
<img src="./inherits/inherit-fields.jpg" />
 | 
			
		||||
 | 
			
		||||
重写父表字段的注意事项:
 | 
			
		||||
- 子表字段标识与父表字段一样时为重写
 | 
			
		||||
- 重写字段的类型必须保持一致
 | 
			
		||||
- 关系字段除了 target collection 以外的其他参数需要保持一致
 | 
			
		||||
 | 
			
		||||
## 父表的子表区块
 | 
			
		||||
 | 
			
		||||
在父表区块里可以配置子表的区块
 | 
			
		||||
 | 
			
		||||
<img src="./inherits/inherited-blocks.jpg" />
 | 
			
		||||
 | 
			
		||||
## 新增继承的父表字段的配置
 | 
			
		||||
 | 
			
		||||
当有继承的父表时,配置字段时,会提供从父表继承的字段的配置
 | 
			
		||||
 | 
			
		||||
<img src="./inherits/configure-fields.jpg" />
 | 
			
		||||
							
								
								
									
										
											BIN
										
									
								
								docs/en-US/welcome/release/inherits/configure-fields.jpg
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 163 KiB  | 
							
								
								
									
										4
									
								
								docs/en-US/welcome/release/inherits/er.svg
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 25 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								docs/en-US/welcome/release/inherits/form.jpg
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 246 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								docs/en-US/welcome/release/inherits/inherit-fields.jpg
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 313 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								docs/en-US/welcome/release/inherits/inherit.jpg
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 231 KiB  | 
							
								
								
									
										
											BIN
										
									
								
								docs/en-US/welcome/release/inherits/inherited-blocks.jpg
									
									
									
									
									
										Normal file
									
								
							
							
						
						| 
		 After Width: | Height: | Size: 142 KiB  | 
@ -1,4 +1,4 @@
 | 
			
		||||
# v0.8.1:NocoBase 的 Logging 系统
 | 
			
		||||
# v0.9.0:NocoBase 的 Logging 系统
 | 
			
		||||
 | 
			
		||||
## `@nocobase/logger`
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
| 
		 After Width: | Height: | Size: 177 KiB  | 
							
								
								
									
										79
									
								
								docs/zh-CN/welcome/release/collection-templates.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						@ -0,0 +1,79 @@
 | 
			
		||||
# v0.9.0: Collection 模板
 | 
			
		||||
 | 
			
		||||
<img src="./v08-1-collection-templates/v08-1-collection-templates.jpg">
 | 
			
		||||
 | 
			
		||||
## 为什么需要 Collection 模板?
 | 
			
		||||
 | 
			
		||||
待补充
 | 
			
		||||
 | 
			
		||||
## 配置参数说明
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
interface ICollectionTemplate {
 | 
			
		||||
  name: string;
 | 
			
		||||
  title?: string;
 | 
			
		||||
  /** 排序 */
 | 
			
		||||
  order?: number;
 | 
			
		||||
  /** 默认配置 */
 | 
			
		||||
  default?: CollectionOptions;
 | 
			
		||||
  /** UI 可配置的 CollectionOptions 参数(添加或编辑的 Collection 表单的字段) */
 | 
			
		||||
  configurableProperties?: Record<string, ISchema>;
 | 
			
		||||
  /** 当前模板可用的字段类型 */
 | 
			
		||||
  availableFieldInterfaces?: AvailableFieldInterfacesInclude | AvailableFieldInterfacesExclude;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
interface AvailableFieldInterfacesInclude {
 | 
			
		||||
  include?: any[];
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
interface AvailableFieldInterfacesExclude {
 | 
			
		||||
  exclude?: any[];
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
interface CollectionOptions {
 | 
			
		||||
  /** 
 | 
			
		||||
   * 自动生成 id
 | 
			
		||||
   * @default true
 | 
			
		||||
   * */
 | 
			
		||||
  autoGenId?: boolean;
 | 
			
		||||
  /** 创建人 */
 | 
			
		||||
  createdBy?: boolean;
 | 
			
		||||
  /** 最后更新人 */
 | 
			
		||||
  updatedBy?: boolean;
 | 
			
		||||
  /** 创建日期 */
 | 
			
		||||
  createdAt?: boolean;
 | 
			
		||||
  /** 更新日期 */
 | 
			
		||||
  updatedAt?: boolean;
 | 
			
		||||
  /** 可排序 */
 | 
			
		||||
  sortable?: boolean;
 | 
			
		||||
  /* 树结构 */
 | 
			
		||||
  tree?: string;
 | 
			
		||||
  /* 日志 */
 | 
			
		||||
  logging?: boolean;
 | 
			
		||||
  /** 继承 */
 | 
			
		||||
  inherits: string | string[];
 | 
			
		||||
  /* 字段列表 */
 | 
			
		||||
  fields?: FieldOptions[];
 | 
			
		||||
}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## 示例
 | 
			
		||||
 | 
			
		||||
创建时都不需要 autoGenId,并且只提供 title 和 name 配置项
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
import { collectionConfigurableProperties } from '@nocobase/client';
 | 
			
		||||
 | 
			
		||||
{
 | 
			
		||||
  default: {
 | 
			
		||||
    autoGenId: false,
 | 
			
		||||
    fields: [],
 | 
			
		||||
  },
 | 
			
		||||
  configurableProperties: {
 | 
			
		||||
    ...collectionConfigurableProperties('name', 'title'),
 | 
			
		||||
  },
 | 
			
		||||
}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
完整插件示例参考:[samples/custom-collection-template](https://github.com/nocobase/nocobase/tree/feat/collection-templates/packages/samples/custom-collection-template)
 | 
			
		||||
 | 
			
		||||
@ -1,4 +1,4 @@
 | 
			
		||||
# v0.8.1:字段的计算公式插件
 | 
			
		||||
# v0.9.0:字段的计算公式插件
 | 
			
		||||
 | 
			
		||||
NocoBase 目前提供了两种计算公式插件:
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
@ -1,5 +1,65 @@
 | 
			
		||||
# 更新日志
 | 
			
		||||
 | 
			
		||||
## 2022/01/11 ~v0.9.0-alpha.1
 | 
			
		||||
 | 
			
		||||
### 协议变更
 | 
			
		||||
 | 
			
		||||
- [内核](https://github.com/nocobase/nocobase/tree/main/packages/core) 继续采用 [Apache 2.0 协议](https://github.com/nocobase/nocobase/blob/main/LICENSE-APACHE-2.0)
 | 
			
		||||
- [插件](https://github.com/nocobase/nocobase/tree/main/packages/plugins) 变更为 [AGPL 3.0 协议](https://github.com/nocobase/nocobase/blob/main/LICENSE-AGPL)
 | 
			
		||||
 | 
			
		||||
### 内核改进
 | 
			
		||||
 | 
			
		||||
- [NocoBase 的 Logging 系统](/welcome/release/logger)
 | 
			
		||||
- [数据表继承](/welcome/release/inherits)
 | 
			
		||||
- [数据表模板](/welcome/release/collection-templates)
 | 
			
		||||
- 数据表主键默认为 BigInt 类型
 | 
			
		||||
- 提供更健全的 ACL 模块
 | 
			
		||||
- 关系字段组件支持切换为简单的 Select 组件
 | 
			
		||||
- 支持页面标签页
 | 
			
		||||
- 表格、看板支持固定区块
 | 
			
		||||
- 提供更为友好的关系筛选
 | 
			
		||||
- 日历区块支持显示农历
 | 
			
		||||
- 日历区块支持配置、删除重复日程
 | 
			
		||||
- 表格区块横向滚动条优化,支持调整列宽
 | 
			
		||||
- 弹窗可配置尺寸大小
 | 
			
		||||
 | 
			
		||||
### 新增插件
 | 
			
		||||
 | 
			
		||||
- Excel 数据导入插件
 | 
			
		||||
- 图形化数据表配置插件
 | 
			
		||||
- SSO 插件:OIDC、SAML
 | 
			
		||||
- 地图插件
 | 
			
		||||
- iframe 区块插件
 | 
			
		||||
- 数据快照插件
 | 
			
		||||
- 应用复制、备份、迁移插件
 | 
			
		||||
- [字段的计算公式插件:Math Formula 和 Excel Formula](/welcome/release/formulas)
 | 
			
		||||
 | 
			
		||||
### 其他插件优化
 | 
			
		||||
 | 
			
		||||
- 数据表配置:
 | 
			
		||||
  - 数据表支持筛选
 | 
			
		||||
  - 数据表支持设置标题字段
 | 
			
		||||
  - 数据表支持分类
 | 
			
		||||
- 工作流:
 | 
			
		||||
  - 修复触发器取值功能
 | 
			
		||||
  - 前端代码重构,插件独立化
 | 
			
		||||
  - 修复执行历史加载问题
 | 
			
		||||
  - 数据表触发后执行不再使用相同事务,优化执行流程
 | 
			
		||||
  - 新增调度器和触发缓存,以队列执行方式解决并发问题
 | 
			
		||||
  - 修复定时任务结束时间组件问题
 | 
			
		||||
  - 修复定时任务跳秒问题
 | 
			
		||||
  - 支持工作流级别复制
 | 
			
		||||
  - 重构上下文及节点变量数据结构
 | 
			
		||||
- 验证码:
 | 
			
		||||
  - 新增验证码配置面板
 | 
			
		||||
- 文件管理器:
 | 
			
		||||
  - 修复本地存储静态文件服务中间件
 | 
			
		||||
  - 本地存储空 baseUrl 配置容错处理
 | 
			
		||||
- 自动编号:
 | 
			
		||||
  - 重构为由数据表记录序列
 | 
			
		||||
  - 增加可输入和匹配规则的配置
 | 
			
		||||
  - 修复生成数字不小于配置的起始值
 | 
			
		||||
 | 
			
		||||
## 2022/10/31 ~ v0.8.0-alpha.1
 | 
			
		||||
 | 
			
		||||
- 从 v0.8 开始,NocoBase 开始提供可用的插件管理器和开发文档。[查看 v0.8 的主要变化](/welcome/release/v08-changelog)
 | 
			
		||||
 | 
			
		||||
@ -1,4 +1,4 @@
 | 
			
		||||
# v0.8.1: 数据表继承
 | 
			
		||||
# v0.9.0: 数据表继承
 | 
			
		||||
 | 
			
		||||
数据表继承基于 [PostgreSQL 的 INHERITS 语法](https://www.postgresql.org/docs/current/tutorial-inheritance.html) 实现,仅限于 PostgreSQL 数据库安装的 NocoBase 时才会提供。
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
@ -1,4 +1,4 @@
 | 
			
		||||
# v0.8.1:NocoBase 的 Logging 系统
 | 
			
		||||
# v0.9.0:NocoBase 的 Logging 系统
 | 
			
		||||
 | 
			
		||||
## `@nocobase/logger`
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||