• 简体中文

      • 导入

      操作：导入记录社区版+

      介绍

      使用 Excel 模板导入数据，可以配置导入哪些字段，自动生成模板。

      20251029165818

      导入说明

      数字类型字段

      支持数字和百分比，N/A 或 - 的文案会被过滤掉

      数字1百分比数字2数字3
      12325%N/A-

      转 JSON 之后为

      {
  "数字1": 123,
  "百分比": 0.25,
  "数字2": null,
  "数字3": null,
}

      布尔类型字段

      输入文案支持（英文不区分大小写）：

      • Yes，Y，True，1，是
      • No，N，False，0，否
      字段1字段2字段3字段4字段4
      否是Ytrue0

      转 JSON 之后为

      {
  "字段1": false,
  "字段2": true,
  "字段3": true,
  "字段4": true,
  "字段5": false,
}

      日期类型字段

      DateOnlyLocal(+08:00)GMT
      2023-01-18 22:22:222023-01-18 22:22:222023-01-18 22:22:22

      转 JSON 之后为

      {
  "DateOnly": "2023-01-18T00:00:00.000Z",
  "Local(+08:00)": "2023-01-18T14:22:22.000Z",
  "GMT": "2023-01-18T22:22:22.000Z",
}

      选择类型字段

      选项值和选项标签都可作为导入文案，多个选项之间以以逗号（, ，）或顿号（、）区分

      如字段 优先级 的可选项包括：

      选项值选项标签
      low低
      medium中
      high低

      选项值和选项标签都可作为导入文案

      优先级
      高
      low

      转 JSON 之后为

      [{ 优先级: 'high' }, { 优先级: 'low' }];

      中国行政区字段

      地区1地区2
      北京市/市辖区天津市/市辖区

      转 JSON 之后为

      {
  "地区1": ["11","1101"],
  "地区2": ["12","1201"]
}

      附件字段

      附件
      https://www.nocobase.com/images/logo.png

      转 JSON 之后为

      {
  "附件": [
    {
      "filename": "logo.png",
      "title": "logo.png",
      "extname": ".png",
      "url": "https://www.nocobase.com/images/logo.png"
    }
  ]
}

      关系类型字段

      多条数据以逗号（, ，）或顿号（、）区分

      部门/名称分类/标题
      开发组分类1、分类2

      转 JSON 之后为

      {
  "部门": [1], // 1 为部门名称为「开发组」的记录 ID
  "分类": [1,2], // 1,2 为分类标题为「分类1」和「分类2」的记录 ID
}

      JSON 类型字段

      JSON1
      {"key":"value"}

      转 JSON 之后为

      {
  "JSON": {"key":"value"}
}

      地图几何图形类型

      PointLinePolygonCircle
      1,2(1,2),(3,4)(1,2),(3,4),(1,2)1,2,3

      转 JSON 之后为

      {
  "Point": [1,2],
  "Line": [[1,2], [3,4]],
  "Polygon": [[1,2], [3,4], [1,2]],
  "Circle": [1,2,3]
}

      自定义导入格式

      通过 db.registerFieldValueParsers() 方法注册自定义的 ValueParser，如：

      import { BaseValueParser } from '@nocobase/database';

class PointValueParser extends BaseValueParser {
  async setValue(value) {
    if (Array.isArray(value)) {
      this.value = value;
    } else if (typeof value === 'string') {
      this.value = value.split(',');
    } else {
      this.errors.push('Value invalid');
    }
  }
}

const db = new Database();

// type=point 的字段导入时，将通过 PointValueParser 解析数据
db.registerFieldValueParsers({
  point: PointValueParser,
});

      导入示例

      Point
      1,2

      转 JSON 之后为

      {
  "Point": [1,2]
}

      操作配置项

      20251029170959

      • 配置可导入字段

      20251029171036