> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 사용자 정의 필드

> 고객, 품목, 주문 및 기타 핵심 레코드에 회사 고유의 필드를 추가합니다. 정의 방법, 지원되는 레코드, 값이 저장되는 위치를 설명합니다.

관리자는 부품의 수출 분류나 고객의 핵심 거래처 담당자처럼 Alforse가 기본으로 추적하지 않는 정보를 기록하기 위해 사용자 정의 필드를 사용합니다. 각 필드를 한 번 정의하면 이후 해당 레코드 유형의 양식에 표시되고, 표준 필드와 함께 저장되며, API를 통해 읽을 수 있습니다. 데이터베이스 변경은 필요하지 않습니다.

## 필드 추가

1. **설정 → 사용자 정의 필드**를 엽니다. 대상이 되는 각 레코드 유형은 **테이블**, **모듈**, 이미 가진 **필드** 수가 표시된 행으로 나타납니다.
2. 레코드 유형의 행 메뉴를 열고 **신규 필드**를 선택합니다. **사용자 정의 필드 보기**를 선택하여 해당 유형의 기존 필드를 확인하고 거기서 추가할 수도 있습니다. **신규 사용자 정의 필드** 양식이 열립니다.
3. 아래에 설명된 설정을 입력하고 **저장**을 선택합니다.

레코드 유형의 필드 목록에서 핸들을 끌어 필드가 표시되는 순서를 바꾸고, 필드를 편집하거나 삭제할 수도 있습니다.

Alforse screenshot**설정 → 사용자 정의 필드: 테이블, 모듈, 필드 열이 있는 엔터티 카탈로그와 이름, 데이터 유형, 태그가 있는 필드 양식**

대상 엔터티마다 한 행이며, 필드 양식은 생성 후 데이터 유형을 잠급니다.

### 필드 설정

FieldType

<details>
  <summary>**이름**required`text`</summary>

  사용자에게 입력란의 라벨로 표시됩니다. 회사의 같은 테이블에 있는 두 필드가 같은 이름을 가질 수 없습니다.
</details>

<details>
  <summary>**데이터 유형**required`enum`</summary>

  사용자가 받는 입력 방식을 결정합니다. 다음 섹션의 아홉 가지 유형 중에서 선택합니다. **저장한 후에는 고정되므로**, 변경하려면 필드를 삭제하고 새로 추가해야 합니다.
</details>

<details>
  <summary>**목록 옵션**`text[]`</summary>

  유형이 **목록**일 때만 표시됩니다. 드롭다운의 각 선택지를 여기에 입력합니다. 양식은 비어 있거나 빈 선택지가 포함된 목록을 거부합니다.
</details>

<details>
  <summary>**필수**`boolean`</summary>

  값이 입력될 때까지 레코드 저장을 막습니다. 이 플래그는 **예/아니요** 필드에는 영향을 주지 않습니다.
</details>

<details>
  <summary>**태그**`text[]`</summary>

  같은 방식으로 태그가 지정된 레코드로 필드를 제한합니다. 비워 두면 테이블의 모든 레코드에 필드가 적용됩니다. 부품, 자재, 공구, 소모품, 지그, 서비스, 작업만 이 설정을 제공합니다.
</details>

### 데이터 유형

| 유형 | 사용자가 입력하는 내용 |
| - | - |
| **예/아니요** | 불리언 스위치 |
| **날짜** | 날짜 |
| **목록** | **목록 옵션** 중 하나의 선택 |
| **숫자** | 숫자 |
| **텍스트** | 자유 텍스트 |
| **사용자** | Alforse 사용자에 대한 참조 |
| **고객** | 고객에 대한 참조 |
| **공급업체** | 공급업체에 대한 참조 |
| **파일** | 정의되어 있지만 레코드 양식에는 아직 입력란이 없음 |

**사용자**, **고객** 또는 **공급업체**를 선택하면 입력란이 선택기가 됩니다. 저장되는 값은 입력한 텍스트가 아니라 해당하는 기존 레코드에 대한 참조입니다.

NOTE

**데이터 유형을 신중하게 선택하십시오**

처음 저장한 후에는 유형을 편집할 방법이 없습니다. 다른 유형이 필요하면 올바른 유형으로 새 필드를 추가하고 이전 필드에 저장되어 있던 값을 다시 입력하십시오.

## 사용자 정의 필드를 지원하는 레코드

사용자 정의 필드는 모든 레코드가 아니라 정해진 레코드 유형 목록에서 사용할 수 있습니다. 설정 페이지가 공식 목록입니다. 레코드 유형에 해당 행이 없으면 아직 사용자 정의 필드를 사용할 수 없습니다.

| 모듈 | 레코드 유형 |
| - | - |
| **영업** | 고객, 견적, 수주, 매출 송장, RFQ와 이들의 연락처, 위치, 라인 |
| **구매** | 공급업체, 발주서, 공급업체 견적, 구매 RFQ와 이들의 라인 및 연락처 |
| **송장 관리** | 매입 송장, 결제, 메모 |
| **품목** | 부품, 공구, 자재, 소모품, 지그, 서비스와 이들의 원가 및 계획 레코드([품목](https://docs.alforse.com/ko/docs/reference/items.md) 참조) |
| **자원** | 직원 직무, 작업장, 부서, 위치, 프로세스, 교대 |
| **재고** | 입고, 출하, 창고 이동, 피킹 목록, 선반 |
| **생산** | 작업 |
| **품질** | 게이지, 이슈 |
| **회계** | 계정, 지불 조건, 전표 |

## 값이 저장되는 위치

레코드 양식에서 사용자 정의 입력란은 표준 입력란 뒤에 나옵니다. 사용자가 입력한 값은 해당 레코드의 `customFields` JSON 컬럼에 보관됩니다.

이 컬럼은 API 응답에 포함되며 필터로 사용할 수 있습니다. 사용자에게 보이는 라벨이 아니라 필드 ID를 키로 하므로, 해석하기 전에 설정 카탈로그에서 각 키를 정의와 대응시키십시오.

HEADS UP

**CSV 가져오기와 내보내기는 사용자 정의 필드를 무시합니다**

CSV는 표준 필드만 처리합니다. 가져오기는 `customFields` 컬럼을 채우지 않으며 테이블 다운로드에서도 이 컬럼이 제외됩니다. 사용자 정의 값에는 레코드 양식이나 API를 사용하고, CSV가 처리하는 항목은 [가져오기 및 내보내기](https://docs.alforse.com/ko/docs/reference/import-export.md)를 확인하십시오.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.