> 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/qr/custom-template.md).

# 라벨 템플릿 직접 만들기 (P-touch Editor)

심플리가 제공하는 빌트인 템플릿(18·24·36mm)으로 충분하지 않을 때는, 브라더 **P-touch Editor**로 라벨 레이아웃을 직접 디자인해 쓸 수 있습니다. 로고 위치, 표시할 항목, 라벨 텍스트, 용지 크기를 원하는 대로 바꾼 `.lbx` 파일을 만들어 인쇄 창의 **`로컬 파일 선택`** 으로 불러오면 됩니다.

{% hint style="info" %}
**먼저 빌트인으로 충분한지 확인하세요**

폭(18·24·36mm) × 항목 수 × 로고 유무 조합은 대부분 빌트인 템플릿으로 해결됩니다. 인쇄 흐름 전체는 [브라더 프린터로 QR 라벨 인쇄하기](/it-device/qr/brother.md)를 참고하세요. 이 문서는 빌트인으로 부족해 **직접 디자인**해야 할 때만 필요합니다.
{% endhint %}

***

## 핵심 — 개체 이름 규약

심플리는 인쇄할 때 `.lbx` 안에 있는 **개체 이름(object name)** 을 키로 삼아 값을 채워 넣습니다. 즉 라벨에 QR이나 관리번호, 항목 값을 넣으려면, **그 개체의 이름을 심플리가 약속한 이름과 정확히 똑같이** 지어야 합니다. 이름이 맞지 않으면 그 칸은 **에러 없이 그냥 빈 칸**으로 인쇄됩니다.

P-touch Editor에서 개체를 선택한 뒤 **\[더 보기]** 탭의 **개체 이름** 칸에 아래 이름을 입력합니다.

### 이름을 지정해야 하는 개체 — 이게 전부입니다

| 개체 이름                             | P-touch 개체 타입 | 필수 | 들어가는 값          |
| --------------------------------- | ------------- | -- | --------------- |
| `qr`                              | 바코드(QR)       | 필수 | 기기 QR URL       |
| `management_number`               | 텍스트           | 권장 | 관리번호            |
| `logo`                            | 이미지           | 선택 | 로고 (쓸 때만)       |
| `field_1_value` … `field_5_value` | 텍스트           | 선택 | 표시 항목 값 (최대 5개) |

규칙은 세 가지입니다.

* **정확히 일치해야 합니다.** 대소문자와 언더스코어(`_`)까지 똑같이 입력하세요. 이름이 조금이라도 다르면 그 칸은 빈 칸으로 출력됩니다.
* **`field_*_value` 는 1번부터 순서대로** 쓰는 만큼만 넣습니다. 항목이 3개면 `field_1_value`·`field_2_value`·`field_3_value`까지 만들면 됩니다. **최대 5개**입니다.
* **QR은 바코드(QR) 개체, 로고는 이미지 개체**로 만들어야 합니다. 텍스트 개체에 `qr` 이름만 붙인다고 QR이 그려지지 않습니다.

***

## 제목 글자는 직접 입력하세요

라벨에 들어가는 "모델명", "사용자" 같은 **제목 글자**는 심플리가 채워 넣지 않습니다. 직접 만든(로컬) 템플릿에서는 심플리가 **값만** 주입하고 제목은 건드리지 않으므로, 제목으로 보일 글자는 P-touch Editor에서 **그냥 텍스트로 직접 입력**해 두면 됩니다.

{% hint style="info" %}
**빌트인과 다른 점**

심플리가 만든 빌트인 템플릿은 제목까지 자동으로 채우지만, **직접 만든 로컬 템플릿은 값만** 채웁니다. 그래서 제목 글자는 디자인할 때 직접 적어 두어야 합니다.
{% endhint %}

***

## 어떤 항목이 어느 칸에 들어가나요

`field_1_value` 는 "모델명 자리"처럼 의미가 고정된 게 아니라 **위치 슬롯**입니다. 1번 슬롯에 실제로 무엇이 들어갈지는 **인쇄 창의 표시 항목 선택**에서 정해집니다. 템플릿에는 자리만 만들어 두고, 의미는 인쇄할 때 고릅니다.

예를 들어 `field_1_value`·`field_2_value` 두 칸을 만든 템플릿이라면, 인쇄 창에서 1번 칸에 "모델명", 2번 칸에 "위치"를 고르는 식으로 그때그때 다르게 쓸 수 있습니다. 표시 항목 매핑 방법은 [브라더 프린터로 QR 라벨 인쇄하기](/it-device/qr/brother.md)의 *표시 항목 매핑* 단계를 참고하세요.

***

## 만드는 순서

### 1. 빈 화면이 아니라 빌트인 템플릿부터 시작하세요 (권장)

가장 안전하고 빠른 방법은 **빌트인 `.lbx`를 받아서 편집**하는 것입니다. 개체 이름이 이미 올바르게 들어가 있어, 위치만 옮기거나 용지 크기만 바꿔도 값이 그대로 채워집니다. 처음부터 빈 화면에서 만들면 위 개체 이름을 **하나하나 직접 지정**해야 합니다.

### 2. 용지·테이프 크기 설정

사용하는 라벨 테이프 폭(예: 36mm)에 맞춰 용지 크기를 설정합니다.

### 3. 데이터 개체 배치 + 개체 이름 지정

QR·관리번호·항목·로고 개체를 배치하고, 각 개체를 선택해 **\[더 보기]** 탭의 **개체 이름** 칸에 위 표의 이름을 정확히 입력합니다.

### 4. 제목 글자 직접 입력

"모델명" 같은 제목 텍스트는 직접 입력해 둡니다(위 *제목 글자는 직접 입력하세요* 참고).

### 5. 저장

파일을 저장합니다. 경로는 **한글·공백이 없는 영문 경로**를 권장합니다(예: `C:\labels\custom.lbx`). 비-ASCII 경로는 환경에 따라 파일을 못 여는 경우가 있습니다.

### 6. 인쇄

인쇄 창에서 **`로컬 파일 선택`** 을 고르고 저장한 파일 경로를 입력합니다. **미리보기로 값이 제대로 들어갔는지 꼭 확인**한 뒤 인쇄하세요.

***

## 함정·주의

{% hint style="warning" %}
**개체가 하나도 없는 빈 템플릿은 만들지 마세요**

데이터 개체가 없는 `.lbx`는 빈 라벨이 나오거나, 파일이 열리지 않을 때 *"Cannot connect to b-PAC"* 처럼 **원인과 다른 오해성 메시지**가 뜰 수 있습니다. 반드시 위 데이터 개체를 넣어 저장하세요.
{% endhint %}

{% hint style="warning" %}
**개체 이름이 틀리면 조용히 빈 칸이 됩니다**

이름이 약속과 다르면 **에러 없이** 그 칸만 비어서 인쇄됩니다. 값이 안 들어간 것 같으면 개체 이름의 철자·대소문자·언더스코어를 다시 확인하고, **인쇄 전 미리보기**로 점검하세요.
{% endhint %}

{% hint style="info" %}
**경로에 한글·공백을 피하세요**

`.lbx` 파일은 한글이나 공백이 없는 영문 경로(예: `C:\labels\custom.lbx`)에 저장하기를 권장합니다.
{% endhint %}

***

## 더 알아보기

* 인쇄 창 사용법·설치 준비물·문제 해결 — [브라더 프린터로 QR 라벨 인쇄하기](/it-device/qr/brother.md)
* QR 다운로드·라벨 발주 — [QR코드로 기기 관리하기](/it-device/qr.md)

이 외의 문제는 채널톡으로 문의해 주세요.