# 기기 카테고리와 관리 필드 설정하기

설정 > **`카테고리 및 필드`** 페이지에서 **카테고리** 탭과 **필드** 탭 두 개로 나뉘어 기기 유형과 각 유형에서 관리할 정보를 설정합니다.

{% hint style="info" %}
**페이지 경로** **설정 > 카테고리 및 필드** (`/settings/device-category`) 상단 탭: `카테고리 ({N})` / `필드 ({N})`
{% endhint %}

## 카테고리 탭 — 카테고리 추가/삭제

새로운 유형의 기기를 관리하려면 먼저 카테고리를 추가합니다. 각 카테고리마다 **내용 연수(연)** 를 입력하면 해당 유형 기기의 감가상각이 자동으로 계산됩니다.

**단계 1: 카테고리 추가 시작**

1. **설정 > 카테고리 및 필드** 로 이동합니다.
2. **`카테고리`** 탭에서 **`카테고리 추가하기`** 버튼을 클릭합니다.

**단계 2: 카테고리 정보 입력**

* 카테고리명 (예: 노트북 / 모니터 / 휴대폰 / 태블릿)
* 설명(선택)
* 내용 연수(선택, 감가상각 계산용)

<figure><img src="/files/dgjQX6TivodYHt2YGP7a" alt="" width="375"><figcaption></figcaption></figure>

## 필드 탭 — 시스템 필드 + 커스텀 필드 통합 관리

**필드** 탭에는 SMPLY 기본 제공 **시스템 필드**와 조직이 직접 추가한 **커스텀 필드**가 한 그리드에 표시됩니다. 카테고리별로 어떤 필드가 어떻게 쓰이는지 한눈에 파악할 수 있습니다.

### 그리드 컬럼

| 컬럼        | 설명                                         |
| --------- | ------------------------------------------ |
| **구분**    | `시스템` 또는 `직접 추가`                           |
| **카테고리**  | 이 필드가 속한 카테고리 (공통 필드는 공통 표시)               |
| **필드 이름** | 필드 표시명                                     |
| **필드 유형** | `텍스트` / `숫자` / `금액` / `날짜` / `제한 선택(enum)` |
| **필수 여부** | 필수 또는 선택                                   |

**시스템 필드**(행)에는 수정/삭제 메뉴가 제공되지 않습니다 — 읽기 전용입니다. **직접 추가 필드**(행)에는 `수정하기` / `삭제하기` 가 활성화됩니다.

### 기본 제공 시스템 필드 (14개)

카테고리 / 모델명 / 관리번호 / 상태 / 브랜드 / 시리얼번호 / 소유구분 / 사용자 / 위치 / 입고일 / 구매일 / 구매 금액 / 구매처 / 메모

{% hint style="info" %}
**기본 필드와 커스텀 필드의 차이**

* **시스템(기본) 필드**: 모든 기기에 공통으로 있는 관리 필드. 조직이 삭제할 수 없습니다.
* **직접 추가(커스텀) 필드**: 보증 기간·자산 태그·구매 링크 등 조직별 요구사항에 맞춰 자유롭게 추가
  {% endhint %}

***

### 커스텀 필드 추가하기

#### 1. 필드 탭에서 추가

1. **설정 > 카테고리 및 필드** 로 이동합니다.
2. **`필드`** 탭 상단 **`필드 추가하기`** 버튼을 클릭합니다. (드롭다운에 `일괄 업로드 템플릿 다운로드` 메뉴도 포함되어 있습니다)
3. 다이얼로그 *"커스텀 필드 추가"* 가 열립니다.

#### 2. 필드 정보 입력

| 항목           | 설명           | 제약사항                                        |
| ------------ | ------------ | ------------------------------------------- |
| **필드명**      | 필드를 식별할 이름   | <p>• 2\~30자<br>• 같은 카테고리 내 중복 불가</p>        |
| **필드 유형**    | 데이터 입력 방식    | 아래 "필드 유형" 참조                               |
| **필수 여부**    | 반드시 입력해야 하는지 | <p>• 선택 시: 기기 등록 시 필수<br>• 미선택 시: 선택 입력</p> |
| **기본값** (선택) | 자동으로 입력될 값   | 유형에 따라 설정 가능                                |
| **설명** (선택)  | 필드 설명        | 최대 200자                                     |

#### 4. 저장

**저장** 버튼을 클릭하여 필드를 추가합니다.

{% hint style="success" %}
**저장 즉시 반영** 저장하면 즉시 기기 상세 페이지와 등록/수정 화면에 표시됩니다.
{% endhint %}

***

### 필드 유형

커스텀 필드는 다양한 유형으로 생성할 수 있습니다.

#### 1. 텍스트 (Text)

**용도**: 자유 형식의 짧은 텍스트 입력

**예시**:

* 자산 태그: "ASSET-2024-001"
* 구매처: "삼성전자"
* 관리 부서: "IT팀"

**제약**:

* 최대 500자
* 한글/영문/숫자/특수문자 모두 가능

#### 2. 숫자 (Number)

**용도**: 수치 정보 입력

**예시**:

* 구매 가격: 1500000
* RAM 용량 (GB): 16
* 보증 기간 (개월): 36

**제약**:

* 정수 또는 소수점 입력
* 음수 가능
* 자동으로 천 단위 콤마(,) 표시

#### 3. 날짜 (Date)

**용도**: 날짜 정보 입력

**예시**:

* 구매일: 2024-01-15
* 보증 만료일: 2027-01-15
* 리스 계약 만료일: 2026-12-31

**기능**:

* 캘린더 선택 UI 제공
* 만료일 설정 시 알림 가능
* 날짜 기준 필터링 가능

#### 4. 제한 선택

**용도**: 미리 정의된 옵션 중 하나를 선택

**예시**:

* 구매 방법: \[직접 구매 | 리스 | 렌탈]
* 기기 상태: \[신규 | 양호 | 수리 필요 | 폐기 예정]
* 위치: \[본사 | 지점A | 지점B | 재택]

**설정**:

* 관리자가 추가한 값들 내에서만 선택 가능

***

### 필드 수정 및 삭제

#### 필드 수정

1. **커스텀 필드 설정** 화면으로 이동합니다.
2. 수정할 필드 옆의 **수정** 아이콘을 클릭합니다.
3. 정보를 수정하고 **저장**합니다.

{% hint style="warning" %}
**필드 유형은 변경할 수 없습니다.** 필드 유형을 바꾸려면 기존 필드를 삭제하고 새로 생성해야 합니다.
{% endhint %}

#### 필드 삭제

1. **커스텀 필드 설정** 화면으로 이동합니다.
2. 삭제할 필드 옆의 **삭제** 아이콘을 클릭합니다.
3. 확인 메시지를 읽고 **삭제**를 클릭합니다.

{% hint style="danger" %}
**주의: 필드를 삭제하면 해당 필드의 모든 데이터가 삭제됩니다.**

* 복구 불가능
* 기기에 입력된 모든 해당 필드 값이 영구 삭제됨
* 삭제 전 데이터를 CSV로 내보내기 권장
  {% endhint %}

***

### 문제 해결

#### Q: 커스텀 필드를 추가할 수 없어요

**확인사항**:

1. ✅ **관리자 또는 기기 수정 권한**이 있는지 확인하세요.
2. ✅ 같은 카테고리에 **동일한 필드명**이 없는지 확인하세요.
3. ✅ 필드명이 **2\~30자** 사이인지 확인하세요.

**해결 방법**:

* 권한이 없으면 관리자에게 요청하세요.
* 중복된 이름은 다른 이름으로 변경하세요.

#### Q: 필드 유형을 변경하고 싶어요

**커스텀 필드의 유형은 변경할 수 없습니다.**

**해결 방법**:

1. 기존 데이터를 CSV로 내보내기합니다.
2. 기존 필드를 삭제합니다.
3. 새 유형으로 필드를 다시 생성합니다.
4. CSV 데이터를 수정하여 다시 입력합니다.

{% hint style="warning" %}
**데이터 손실 주의** 필드를 삭제하면 모든 데이터가 사라지므로 반드시 백업하세요.
{% endhint %}

#### Q: 필드 순서를 변경할 수 있나요?

네, 테이블에서 드래그 앤 드롭으로 순서를 변경할 수 있습니다.

**방법**:

1. 기기 리스트로 이동합니다.
2. 필드 오른쪽 끝 **드래그 핸들**을 클릭합니다.
3. 원하는 위치로 드래그합니다.
4. 자동 저장됩니다.

{% hint style="danger" %}
브라우저 캐쉬에 저장되므로 다른 기기의 브라우저나 강력 새로고침시 순서가 초기화 됩니다.
{% endhint %}

#### Q: 제한 선택 필드의 옵션을 추가/삭제하고 싶어요

**옵션 추가**:

1. 관리자가 실제 필드에 새로운 옵션 값을 추가합니다.
2. 일반 구성원은 새롭게 추가할 수 없습니다.

#### Q: 필수 필드를 설정했는데 기존 기기에는 어떻게 되나요?

**기존 기기는 영향받지 않습니다.**

* 필수 필드는 **신규 등록 또는 수정 시**만 적용됩니다.
* 기존 기기는 해당 필드가 비어있어도 됩니다.

**기존 기기에 일괄 입력하려면**:

1. **기기** 목록에서 CSV 내보내기를 합니다.
2. Excel에서 해당 필드 값을 입력합니다.
3. CSV 일괄 업로드로 다시 업로드합니다.

#### Q: 커스텀 필드를 CSV 내보내기에 포함할 수 있나요?

네, **기기 목록의 CSV 내보내기**에 커스텀 필드가 자동으로 포함됩니다.

**내보내기 방법**:

1. **기기** 메뉴로 이동합니다.
2. **CSV 내보내기** 버튼을 클릭합니다.
3. 내보낼 필드를 선택합니다 (기본으로 모든 필드 포함).
4. **내보내기**를 클릭합니다.

CSV 파일에 모든 커스텀 필드 값이 포함됩니다.

#### Q: 커스텀 필드는 최대 몇 개까지 만들 수 있나요?

**공통 필드**: 최대 **30개** **기기 유형별 필드**: 유형당 최대 **20개**

{% hint style="info" %}
**권장 개수**: 10\~15개 이내 너무 많은 필드는 UI를 복잡하게 만들고 입력 부담을 증가시킵니다.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smply.one/it-device/custom_field.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
