Tip

このドキュメントはAIによって翻訳されました。不正確な情報については、英語版をご参照ください

インポート

アクション: レコードのインポートCommunity Edition+

はじめに

Excelテンプレートを使ってデータをインポートできます。どのフィールドをインポートするか設定でき、テンプレートは自動で生成されます。

20251029165818

インポート手順

数値型フィールド

数値とパーセンテージに対応しています。N/A- といったテキストはフィルタリングされます。

数値1パーセンテージ数値2数値3
12325%N/A-

JSONに変換後:

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

真偽値型フィールド

入力テキストは以下に対応しています(英語は大文字・小文字を区別しません):

  • YesYTrue1
  • NoNFalse0
フィールド1フィールド2フィールド3フィールド4フィールド5
Ytrue0

JSONに変換後:

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

日付型フィールド

DateOnlyローカル(+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"]
}

添付ファイルフィールド

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"}
}

地図ジオメトリ型

ポイントラインポリゴンサークル
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,
});

インポート例

ポイント
1,2

JSONに変換後:

{
  "Point": [1,2]
}

アクション設定

20251029170959

  • インポート可能なフィールドを設定します

20251029171036