Impor

Action: Import RecordCommunity Edition+

Pengantar

Menggunakan template Excel untuk mengimpor data, dapat mengkonfigurasi Field mana yang akan diimpor, otomatis menghasilkan template.

20251029165818

Petunjuk Impor

Field Tipe Numerik

Mendukung angka dan persentase. Teks N/A atau - akan difilter

Angka1PersentaseAngka2Angka3
12325%N/A-

Setelah dikonversi ke JSON menjadi

{
  "Angka1": 123,
  "Persentase": 0.25,
  "Angka2": null,
  "Angka3": null,
}

Field Tipe Boolean

Teks input yang didukung (Bahasa Inggris case-insensitive):

  • Yes, Y, True, 1, Ya
  • No, N, False, 0, Tidak
Field1Field2Field3Field4Field4
TidakYaYtrue0

Setelah dikonversi ke JSON menjadi

{
  "Field1": false,
  "Field2": true,
  "Field3": true,
  "Field4": true,
  "Field5": false,
}

Field Tipe Tanggal

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

Setelah dikonversi ke JSON menjadi

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

Field Tipe Pilihan

Nilai opsi dan label opsi dapat dijadikan teks impor. Beberapa opsi dipisahkan dengan koma (, ,) atau pemisah ()

Misalnya Field Prioritas memiliki opsi yang tersedia:

Nilai OpsiLabel Opsi
lowRendah
mediumSedang
highTinggi

Nilai opsi dan label opsi dapat dijadikan teks impor

Prioritas
Tinggi
low

Setelah dikonversi ke JSON menjadi

[{ Prioritas: 'high' }, { Prioritas: 'low' }];

Field Region Administratif Tiongkok

Region1Region2
Beijing/Distrik KotaTianjin/Distrik Kota

Setelah dikonversi ke JSON menjadi

{
  "Region1": ["11","1101"],
  "Region2": ["12","1201"]
}

Field Lampiran

Setelah dikonversi ke JSON menjadi

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

Field Tipe Relasi

Beberapa data dipisahkan dengan koma (, ,) atau pemisah ()

Departemen/NamaKategori/Judul
Tim DevKategori1, Kategori2

Setelah dikonversi ke JSON menjadi

{
  "Departemen": [1], // 1 adalah ID record dengan nama departemen "Tim Dev"
  "Kategori": [1,2], // 1,2 adalah ID record dengan judul kategori "Kategori1" dan "Kategori2"
}

Field Tipe JSON

JSON1
{"key":"value"}

Setelah dikonversi ke JSON menjadi

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

Tipe Geometri Peta

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

Setelah dikonversi ke JSON menjadi

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

Format Impor Kustom

Mendaftarkan ValueParser kustom melalui metode db.registerFieldValueParsers(), contoh:

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();

// Saat Field type=point diimpor, akan di-parse melalui PointValueParser
db.registerFieldValueParsers({
  point: PointValueParser,
});

Contoh impor

Point
1,2

Setelah dikonversi ke JSON menjadi

{
  "Point": [1,2]
}

Konfigurasi Action

20251029170959

  • Konfigurasi Field yang dapat diimpor

20251029171036