> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/it-device/custom_field.md).

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

기기 유형(카테고리)과 각 유형에서 관리할 추가 정보(커스텀 필드)는 **서로 다른 두 페이지**에서 설정합니다. 카테고리는 **설정 > 카테고리** 페이지에서, 커스텀 필드는 **설정 > 커스텀 필드** 페이지에서 관리합니다.

{% hint style="info" %}
**두 페이지의 역할 구분**

* **카테고리** (`/settings/device-category`): 노트북·모니터·휴대폰 같은 기기 유형을 추가/수정/삭제하고, 각 유형의 내용 연수(감가상각)·기기 수·연결된 커스텀 필드 수를 확인합니다.
* **커스텀 필드** (`/settings/device-custom-field`): 보증 기간·자산 태그 같은 추가 항목을 만들고, 각 항목을 어떤 카테고리의 기기 상세 화면에 어떤 순서로 보여줄지 구성합니다.

두 페이지는 서로 연결되어 있습니다. 카테고리 목록의 **커스텀 필드** 열을 클릭하면 해당 카테고리의 구성 화면으로 바로 넘어갑니다.
{% endhint %}

***

## 1. 카테고리 페이지

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

### 그리드 컬럼

| 컬럼         | 설명                                       |
| ---------- | ---------------------------------------- |
| **이름**     | 카테고리 이름 (예: 노트북 / 모니터 / 휴대폰)             |
| **설명**     | 카테고리 설명                                  |
| **내용 연수**  | 감가상각 계산 기준 연수. 비어 있으면 감가상각을 계산하지 않습니다    |
| **기기 수**   | 이 카테고리에 등록된 기기 수                         |
| **커스텀 필드** | 연결된 커스텀 필드 수. 비어 있으면 *"+ 필드 연결"* 이 표시됩니다 |

**커스텀 필드** 열의 숫자(또는 *"+ 필드 연결"*)를 클릭하면 커스텀 필드 페이지의 **카테고리 구성** 화면이 해당 카테고리로 열립니다. 숫자 위에 마우스를 올리면 실제 연결된 필드 이름이 툴팁으로 표시됩니다.

### 카테고리 추가

**단계 1: 추가 시작**

1. **설정 > 카테고리** 로 이동합니다.
2. 우측 상단 **`카테고리 추가하기`** 버튼을 클릭합니다.

**단계 2: 정보 입력**

* 카테고리 이름 (예: 노트북 / 모니터 / 휴대폰 / 태블릿)
* 설명(선택)

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

{% hint style="warning" %}
**삭제 제약** 기기가 등록된 카테고리는 삭제할 수 없습니다. 행 메뉴의 **`삭제하기`** 가 비활성화되며 *"기기가 등록된 카테고리는 삭제할 수 없습니다"* 안내가 표시됩니다. 먼저 기기를 다른 카테고리로 옮기거나 삭제한 뒤 다시 시도하세요.
{% endhint %}

***

## 2. 커스텀 필드 페이지

**설정 > 커스텀 필드**(`/settings/device-custom-field`) 페이지는 상단 탭으로 두 가지 모드를 제공합니다.

| 모드          | 무엇을 하나                                          |
| ----------- | ----------------------------------------------- |
| **필드 관리**   | 커스텀 필드를 만들고 수정·삭제합니다. 필드 자체를 다룹니다.              |
| **카테고리 구성** | 카테고리별 기기 상세 화면에 어떤 필드가 어떤 순서로 보일지 끌어다 놓아 설계합니다. |

{% hint style="info" %}
**주소로 바로 진입** 선택한 모드와 카테고리는 주소에 반영됩니다(`?mode=fields` 또는 `?mode=categories&categoryId=...`). 카테고리 페이지의 **커스텀 필드** 열을 클릭하면 이 주소를 통해 해당 카테고리의 **카테고리 구성** 화면으로 바로 이동합니다.
{% endhint %}

***

### 2-1. 필드 관리 모드

커스텀 필드 목록이 하나의 표로 표시됩니다. 이 표에는 조직이 직접 추가한 커스텀 필드만 나타납니다.

#### 그리드 컬럼

| 컬럼         | 설명                                                                            |
| ---------- | ----------------------------------------------------------------------------- |
| **이름**     | 필드 이름. 앞에 타입 글리프(`Aa` 텍스트 / `123` 숫자 / `YMD` 날짜 / `₩` 금액 / `▼` 선택지)가 함께 표시됩니다 |
| **타입**     | 필드 유형 (텍스트 / 숫자 / 날짜 / 금액 / 선택지)                                              |
| **커스텀 필드** | 이 필드가 적용되는 범위. **모든 카테고리** 이거나, 연결된 카테고리 이름 뱃지로 표시됩니다                         |
| **필수**     | 필수 항목이면 `*` 가 표시됩니다                                                           |

표 위 검색창에서 이름으로 필드를 찾을 수 있습니다. 각 행 오른쪽 메뉴에서 **`수정하기`** / **`삭제하기`** 를 실행합니다.

***

### 2-2. 카테고리 구성 모드

왼쪽에 카테고리 목록(레일), 오른쪽에 선택한 카테고리의 **기기 상세 페이지 미리보기**(워크벤치)가 나란히 표시됩니다.

* **왼쪽 레일**: 카테고리를 클릭해 선택합니다. 각 카테고리 옆 숫자는 그 카테고리에 연결된 **특정 카테고리** 필드 수입니다. 레일 하단에는 *"모든 카테고리 공통 N개 — 자동 적용"* 안내가 표시됩니다.
* **오른쪽 워크벤치**: 선택한 카테고리의 기기 상세 화면이 어떻게 보일지 미리 보여줍니다. 라이브러리에서 필드를 끌어다 미리보기의 원하는 줄에 놓으면 그 카테고리에 연결되고 그 위치에 끼워집니다. 미리보기 안에서 필드를 끌어 순서를 바꿀 수 있고, 필드의 해제 버튼으로 카테고리 연결을 끊을 수 있습니다.

{% hint style="success" %}
**순서·연결 변경은 서버에 저장됩니다** 워크벤치에서 끌어다 놓은 순서와 카테고리 연결/해제는 즉시 서버에 저장되어 기기 상세 화면에 그대로 반영됩니다. 브라우저를 바꾸거나 새로고침해도 유지됩니다.
{% endhint %}

***

### 3. 적용 범위 — 모든 카테고리 vs 특정 카테고리

커스텀 필드는 **적용 범위**에 따라 두 종류로 나뉩니다. 적용 범위는 필드를 만들 때 정하며, 이후에는 바꿀 수 없습니다.

| 적용 범위       | 동작                                                       |
| ----------- | -------------------------------------------------------- |
| **모든 카테고리** | 카테고리와 상관없이 모든 기기 상세에 자동으로 적용됩니다. 별도로 카테고리를 연결할 필요가 없습니다. |
| **특정 카테고리** | 선택한 카테고리의 기기에만 노출됩니다. 하나의 필드를 여러 카테고리에 연결할 수 있습니다.       |

{% hint style="info" %}
**카테고리를 하나도 연결하지 않아도 됩니다** **특정 카테고리** 필드에 연결된 카테고리가 0개여도 저장됩니다. 이때는 어느 기기에도 노출되지 않으며, 나중에 카테고리 구성에서 다시 연결하면 됩니다.
{% endhint %}

***

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

**단계 1: 추가 다이얼로그 열기**

1. **설정 > 커스텀 필드** 로 이동합니다.
2. 우측 상단 **`필드 추가`** 버튼을 클릭합니다.
3. *"커스텀 필드 추가"* 다이얼로그가 열립니다.

**단계 2: 정보 입력**

| 항목           | 설명                       | 제약사항                                 |
| ------------ | ------------------------ | ------------------------------------ |
| **필드 이름**    | 필드를 식별할 이름               | 전사 안에서 중복 불가 (적용 범위·카테고리와 무관)        |
| **타입**       | 데이터 입력 방식                | 텍스트 / 숫자 / 날짜 / 금액 / 선택지. 저장 후 변경 불가 |
| **적용 범위**    | 모든 카테고리 또는 특정 카테고리       | 저장 후 변경 불가                           |
| **연결된 카테고리** | (특정 카테고리일 때) 노출할 카테고리 선택 | 0개도 허용                               |
| **선택 옵션**    | (선택지 타입일 때) 고를 수 있는 값    | 2개 이상 필요                             |
| **필수 입력 항목** | 기기 등록 시 반드시 입력해야 하는지     | 체크 시 신규 등록·수정에 필수                    |

* **적용 범위**를 *특정 카테고리*로 고르면 카테고리 라이브러리가 나타납니다. 검색해서 원하는 카테고리를 클릭하면 연결되고, 연결된 카테고리는 `x` 로 해제합니다.
* **타입**을 *선택지*로 고르면 옵션 입력란이 나타나고, 입력한 옵션이 *"미리보기 · 기기 추가 폼"* 으로 즉시 미리 보여집니다.

**단계 3: 저장**

**`추가`** 버튼을 클릭하여 필드를 만듭니다.

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

***

### 5. 필드 유형

커스텀 필드는 다섯 가지 유형으로 만들 수 있습니다.

#### 1. 텍스트

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

**예시**: 자산 태그 `ASSET-2024-001` · 관리 부서 `IT팀`

#### 2. 숫자

**용도**: 수치 정보 입력 (예: RAM 용량, 보증 기간(개월))

**표시**: 천 단위 콤마(,)가 자동으로 표시됩니다.

#### 3. 날짜

**용도**: 날짜 정보 입력 (예: 보증 만료일, 리스 계약 만료일)

**기능**: 캘린더 선택 UI 제공, 날짜 기준 정렬·필터 가능

#### 4. 금액

**용도**: 통화 금액 입력 (예: 구매 금액, 보증 연장 비용)

**표시**: 천 단위 콤마(,)와 통화 표기가 함께 표시됩니다.

#### 5. 선택지

**용도**: 미리 정한 옵션 중 하나를 고르게 함

**예시**: 구매 방법 `[직접 구매 | 리스 | 렌탈]` · 기기 상태 `[신규 | 양호 | 수리 필요 | 폐기 예정]`

**설정**: 옵션을 **2개 이상** 입력해야 저장됩니다. 입력한 옵션은 다이얼로그 안에서 즉시 미리 보여집니다. 옵션은 관리자만 추가/삭제할 수 있습니다.

***

### 6. 필드 수정 및 삭제

#### 필드 수정

1. **필드 관리** 모드에서 수정할 필드 행의 메뉴를 열어 **`수정하기`** 를 클릭합니다.
2. 정보를 수정하고 **`저장`** 을 클릭합니다.

{% hint style="warning" %}
**타입과 적용 범위는 변경할 수 없습니다** 수정 다이얼로그에서 타입과 적용 범위 칸은 비활성화되어 *"타입과 적용 범위는 변경할 수 없습니다"* 로 안내됩니다. 이름·필수 여부·선택지 옵션·연결된 카테고리는 수정할 수 있습니다. 타입이나 적용 범위를 바꾸려면 기존 필드를 삭제하고 새로 만들어야 합니다.
{% endhint %}

#### 필드 삭제

1. **필드 관리** 모드에서 삭제할 필드 행의 메뉴를 열어 **`삭제하기`** 를 클릭합니다.
2. 확인 메시지를 읽고 삭제를 실행합니다.

{% hint style="danger" %}
**데이터 손실 주의** 필드를 삭제하면 기존 기기에 입력된 해당 필드 값도 더 이상 노출되지 않습니다. 삭제 전 기기 목록 CSV 내보내기로 데이터를 백업하는 것을 권장합니다.
{% endhint %}

***

### 7. 문제 해결

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

**확인사항**:

1. ✅ **기기 설정 편집 권한**이 있는지 확인하세요. 권한이 없으면 **`필드 추가`** 버튼이 비활성화되고 *"권한이 필요합니다."* 가 표시됩니다.
2. ✅ 같은 이름의 필드가 이미 있는지 확인하세요. 이름은 적용 범위·카테고리와 무관하게 **전사에서 중복될 수 없습니다.** 중복이면 *"이미 사용 중인 이름입니다."* 인라인 에러가 표시됩니다.
3. ✅ 선택지 타입이라면 옵션을 **2개 이상** 입력했는지 확인하세요.

**해결 방법**: 권한이 없으면 관리자에게 요청하고, 중복된 이름은 다른 이름으로 바꾸세요.

#### Q: 필드의 타입이나 적용 범위를 바꾸고 싶어요

**타입과 적용 범위는 만든 뒤에는 변경할 수 없습니다.**

**해결 방법**:

1. 필요하면 기존 데이터를 기기 목록 CSV로 내보내 백업합니다.
2. 기존 필드를 삭제합니다.
3. 원하는 타입·적용 범위로 필드를 다시 만듭니다.

#### Q: 필드 순서를 바꿀 수 있나요

네. **커스텀 필드** 페이지의 **카테고리 구성** 모드에서 바꿉니다.

**방법**:

1. **설정 > 커스텀 필드** 로 이동해 **카테고리 구성** 탭을 엽니다.
2. 왼쪽에서 순서를 바꿀 카테고리를 선택합니다.
3. 오른쪽 미리보기에서 필드를 끌어 원하는 위치로 옮깁니다.
4. 변경은 서버에 저장되어 기기 상세 화면에 그대로 반영됩니다. 브라우저를 바꿔도 유지됩니다.

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

옵션은 관리자만 변경할 수 있습니다. **필드 관리** 모드에서 해당 필드를 **`수정하기`** 한 뒤 옵션을 추가하거나 삭제하고 저장하세요. 일반 구성원은 옵션을 직접 추가할 수 없습니다.

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

**기존 기기는 영향받지 않습니다.** 필수 여부는 **신규 등록 또는 수정 시**에만 적용되며, 기존 기기는 해당 필드가 비어 있어도 됩니다.

기존 기기에 일괄 입력하려면 기기 목록에서 CSV로 내보낸 뒤 값을 채워 다시 일괄 업로드하세요.

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

네. 기기 목록의 CSV 내보내기에 커스텀 필드 값이 함께 포함됩니다.

#### Q: 이 외의 문제

채널톡으로 문의해 주세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.