TIP
이 문서는 AI로 번역되었습니다. 부정확한 내용이 있을 경우 영어 버전을 참조하세요
임포트
This feature is provided by the plugin «액션: 레코드 가져오기»
소개
Excel 템플릿을 사용하여 데이터를 임포트할 수 있습니다. 어떤 필드를 임포트할지 설정할 수 있으며, 템플릿은 자동으로 생성됩니다.

임포트 안내
숫자 타입 필드
숫자와 백분율을 지원하며, N/A 또는 -와 같은 텍스트는 필터링됩니다.
JSON으로 변환 후:
{
"숫자1": 123,
"백분율": 0.25,
"숫자2": null,
"숫자3": null,
}
불리언 타입 필드
지원되는 입력 텍스트 (영어는 대소문자를 구분하지 않습니다):
Yes, Y, True, 1, 是
No, N, False, 0, 否
JSON으로 변환 후:
{
"필드1": false,
"필드2": true,
"필드3": true,
"필드4": true,
"필드5": false,
}
날짜 타입 필드
| DateOnly | Local(+08:00) | GMT |
|---|
| 2023-01-18 22:22:22 | 2023-01-18 22:22:22 | 2023-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 | 높음 |
옵션 값과 옵션 레이블 모두 임포트 텍스트로 사용할 수 있습니다.
JSON으로 변환 후:
[{ 우선순위: 'high' }, { 우선순위: 'low' }];
중국 행정 구역 필드
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 타입 필드
JSON으로 변환 후:
{
"JSON": {"key":"value"}
}
지도 지오메트리 타입
| Point | Line | Polygon | Circle |
|---|
| 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,
});
임포트 예시
JSON으로 변환 후:
액션 설정


- 연동 규칙: 버튼을 동적으로 표시/숨김;
- 버튼 편집: 버튼의 제목, 타입, 아이콘을 편집합니다.