> ## Documentation Index
> Fetch the complete documentation index at: https://make.edicus.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 상품 설정 한눈에 보기
> Edicus Manager의 상품 설정이 편집기 동작을 어떻게 정하는지
같은 템플릿이라도 어떤 상품으로 띄우느냐에 따라 편집기가 다르게 동작합니다. 탭 구성, 페이지를 늘릴 수 있는지, 재단선을 어디에 그릴지, 썸네일을 어떻게 만들지가 전부 **상품 설정**에서 나옵니다. 이 페이지는 그 설정이 어디에 있고, 어떤 순서로 적용되는지 정리합니다.
## 배우는 것
* 상품을 등록해 판매하기까지의 전체 순서
* 설정한 결과를 Edicus Manager에서 확인하는 방법
* 상품, 사이즈, `ps_code`의 관계
* 편집기 동작을 정하는 네 층과 우선순위
* 설정을 바꾼 뒤 언제 반영되는지
## 전체 순서
새 상품을 등록해 판매하기까지는 아래 순서로 진행합니다. 각 단계의 자세한 방법은 링크한 페이지에 있습니다.
카테고리, 상품, 사이즈를 만들고 `ps_code`를 얻습니다. [상품과 ps\_code 만들기](/docs/products/create), [사이즈와 페이지 정보](/docs/products/sizes)
템플릿과 편집기에서 쓸 폰트를 등록합니다. [폰트](/docs/products/fonts)
InDesign으로 디자인하고 익스포터로 그 `ps_code`에 올립니다. [템플릿 제작 시작하기](/docs/templates/overview)
사진인화 상품(상품 설정의 편집기 종류 `editor`가 `print`)은 템플릿이 없으므로 이 단계와 Demo, Test Order를 건너뜁니다. 설정은 [사진인화 상품](/docs/products/photo-print)을 보고, 확인은 내 서비스에서 편집기를 띄워 합니다.
탭, 페이지, 사진과 글자 편집 범위 등을 정합니다. 상품 유형이 정해져 있으면 [포토카드](/docs/products/photocard), [스티컷 상품](/docs/products/sticut), [달력 상품](/docs/products/calendar)처럼 유형별 페이지의 순서를 따르세요.
아래 "설정 확인하는 법"을 보세요.
필요하면 [렌더 옵션](/docs/products/render-options)을 만들고, 테스트 주문을 렌더링해 인쇄 파일을 확인합니다. [테스트 주문과 렌더링](/docs/templates/test-render)
판매 페이지에 편집기를 붙이는 담당자에게 `ps_code`와 템플릿의 리소스 URI(`resUri`)를 전달합니다. [템플릿 업로드와 수정](/docs/templates/upload)
## 설정 확인하는 법
Edicus Manager만으로 결과를 확인하는 방법은 둘입니다.
| 확인하려는 것 | 방법 |
| - | - |
| 탭, 버튼, 페이지 구성처럼 화면만 보면 되는 것 | **Resource**에서 템플릿을 고르고 **Demo**를 누릅니다. 체험 모드라 저장과 사진 업로드는 되지 않습니다 |
| 사진 업로드, 경고, 저장, 썸네일, 인쇄 파일 | 같은 화면의 **Test Order**로 테스트 주문을 만듭니다. [테스트 주문과 렌더링](/docs/templates/test-render) |
설정을 바꾼 뒤에는 **Update**로 저장하고 편집기를 새로 띄워야 반영됩니다. 문서에서 "파트너 권한에 따라 잠금으로 표시될 수 있습니다"라고 적은 항목은 이 파트너 계정에 권한이 열려 있지 않으면 잠금으로 보이고 바꿀 수 없습니다. 필요하면 모션원에 권한을 요청합니다. 띄우기 옵션이나 편집기 이벤트로만 확인할 수 있는 항목은 각 페이지에 확인할 개발자 문서를 링크했습니다.
## 상품과 사이즈와 ps\_code
템플릿은 특정 상품의 디자인입니다. 그래서 템플릿을 올리기 전에 Edicus Manager에서 **상품**부터 만듭니다.
| 단위 | 무엇 | 예 |
| - | - | - |
| 카테고리 | 상품을 묶는 내부 분류입니다. 쇼핑몰의 상품 분류와는 관계없습니다 | `BC - 명함` |
| 상품 | 편집기 동작 대부분을 정하는 단위입니다. `prodCode`로 구분합니다 | `NAMECARD - 명함` |
| 사이즈 | 한 상품 안의 규격입니다. 크기, 재단 여백, 페이지 수 규칙이 여기에 붙습니다 | `90x50` |
| `ps_code` | 사이즈 코드와 상품 코드를 `@`로 붙인 값입니다. 편집기가 상품을 찾는 열쇠입니다 | `90x50@NAMECARD` |
한 상품은 사이즈를 여러 개 가질 수 있습니다. 명함을 가로형 `90x50`, 세로형 `50x90`으로 함께 판다면 사이즈도 둘, `ps_code`도 둘입니다.
편집기를 띄울 때 넘기는 `ps_code`가 이 상품과 사이즈를 고릅니다. `@`가 정확히 하나 들어 있지 않으면 편집기가 상품을 찾지 못합니다.
## 편집기 동작을 정하는 네 층
편집기는 한 곳이 아니라 네 곳에서 설정을 모읍니다.
| 층 | 어디서 바꾸나 | 무엇을 정하나 |
| - | - | - |
| **상품 설정** | Edicus Manager **Product** 화면의 **상품 설정** | 탭, 페이지, 레이아웃, 사진과 글자 편집 범위, 썸네일 등 편집 기능 대부분 |
| **사이즈 설정** | 같은 화면에서 사이즈를 고른 뒤 | 크기와 재단 여백, 저해상도 경고 기준, 페이지 수 규칙, 사이즈별 덮어쓰기 |
| **파트너 설정** | Edicus Manager **Customize** 화면 | 편집기 스타일(CSS), 안내 문구, 업로드 방식처럼 모든 상품에 공통인 것. [파트너 공통 설정](/docs/products/style)에 있습니다 |
| **띄우기 옵션** | 편집기를 띄우는 코드 | 이번 세션에만 적용할 값. [띄우기 옵션](/docs/reference/launch-options)에 있습니다 |
렌더 설정은 이 네 층과 별개입니다. 편집기가 아니라 주문 뒤 인쇄용 파일을 만드는 단계에서 쓰입니다. [렌더 옵션](/docs/products/render-options)에 따로 정리했습니다.
## 어느 값이 이기나
대부분의 항목은 같은 항목이 여러 층에 있으면 아래쪽이 이깁니다.
```mermaid theme={null}
flowchart TD
A["상품 설정"] --> B["사이즈의 product override"]
B --> C["사이즈의 edicus options와 띄우기 옵션 options"]
C --> D["띄우기 옵션 option_string"]
D --> E["편집기에 적용되는 최종 값"]
```
사이즈의 edicus options와 띄우기 옵션 `options`가 같은 키를 가지면 맨 위 키 단위로 합치고 겹치는 키는 띄우기 옵션이 이깁니다. 몇몇 키는 통째로 바뀌거나 뒤에 붙습니다. 키마다 합치는 방식은 [options 키](/docs/reference/launch-options#options-키)에 있습니다.
파트너 설정은 이 순서 밖에 있습니다. 상품 설정과 같은 기능을 함께 다루는 항목은 둘 다 켜져야 동작합니다. 예를 들어 기존 모바일 UI의 저장 버튼은 상품의 `save-ui`와 파트너 Mobile Settings의 `save-ui`가 모두 켜져야 보입니다. 띄우기 옵션과 겹치는 CSS와 플러그인은 덮어쓰지 않고 이어 붙입니다. 띄우기 옵션 `private_css`는 파트너 CSS 뒤에, `options.plugins`는 파트너 플러그인 뒤에 붙습니다.
아래 항목은 위 순서를 따르지 않거나, 자주 부딪힙니다.
| 항목 | 이기는 쪽부터 |
| - | - |
| 내지 페이지 수 한도 | 띄우기 옵션 `max_page`, `min_page` → 사이즈의 페이징 규칙 → 상품의 `max-page`, `min-page` |
| 페이지 추가와 삭제 메뉴 | `option_string`에 `num_page`를 넣으면 상품의 `page-menu`가 켜져 있어도 꺼집니다. URL로 넘기는 띄우기 옵션 `num_page`는 장수만 정하고 메뉴는 그대로 둡니다 |
| 썸네일 옵션 | 띄우기 옵션 `options.tn_upload.thumbnail_option` → 상품의 `tn-option` |
| 프로모션 창 | 띄우기 옵션 `options.promo` → `option_string`의 `promo` → 상품의 `promoInfo` → 사이즈 edicus options의 `promo` |
| 스티컷 상품의 탭 | `sticut-mode`가 `keyhole`, `stand`, `talk`이고 사이즈의 sticut option에서 `allow_editing`이 켜져 있으면 사진 탭과 텍스트 탭이 켜집니다. 상품 설정, product override, `option_string`으로 꺼도 다시 켜집니다. [스티컷 상품](/docs/products/sticut)을 보세요 |
| 다시 여는 프로젝트 | 처음 만들 때 저장된 `option_string`이 이번에 넘긴 값보다 우선합니다. 프로젝트가 자기 설정을 기억하기 때문입니다 |
## 바꾼 설정은 언제 반영되나
Edicus Manager에서 **Update**를 누르면 Edicus 서버가 설정을 저장하고, 편집기가 읽는 사본을 함께 갱신합니다.
* 편집기는 **띄울 때** 상품 설정을 한 번 읽습니다. 이미 열려 있는 편집기에는 반영되지 않습니다. 편집기를 새로 띄워 확인하세요.
* 저장 뒤 "목록 반영 실패" 같은 경고가 뜨면 사본 갱신이 실패한 것입니다. 한 번 더 저장하세요.
### 이미 만든 프로젝트에는 소급되지 않습니다
프로젝트는 처음 만들 때의 템플릿 내용과 일부 설정을 문서 안에 기록해 둡니다. 그래서 상품 설정이나 템플릿을 바꿔도 이미 편집을 시작한 프로젝트와 들어온 주문에는 반영되지 않습니다.
* 바꾼 설정은 **새로 만드는 프로젝트**부터 적용됩니다.
* 기존 프로젝트를 복사(`clone`)해 다시 주문하면 복사본도 원본이 만들어질 때의 내용을 그대로 가져갑니다.
* 렌더 옵션도 같습니다. 바꾼 뒤에 렌더링하는 주문부터 새 설정이 쓰입니다.
이미 판매 중인 상품의 `sticut-mode`나 `size-code`를 바꾸면, 예전 설정으로 만든 프로젝트를 다시 열 때 맞지 않을 수 있습니다. 동작이 크게 달라지는 변경은 새 상품이나 새 사이즈를 만들어 적용하세요.
## 상품 설정과 연동 개발
상품 설정은 대부분 편집기 안에서 끝나지만, 연동 개발자가 알아 둘 것이 두 가지 있습니다.
* 상품의 **user data**(`userData`)는 편집기가 해석하지 않고 저장할 때 `save-doc-report`의 `docInfo.userData`로 그대로 돌려줍니다. 상품마다 내 서비스에서 쓸 값을 실어 두는 자리입니다. 최대 65,535바이트입니다.
* 주문은 `ps_code`에서 상품 코드와 사이즈 코드만 떼어 기록합니다. 상품 설정이 주문 처리 방식을 바꾸지는 않습니다.
## 됐는지 확인
편집기를 띄울 `ps_code`를 Edicus Manager의 상품 화면 위쪽에서 확인할 수 있으면 준비가 끝난 것입니다. 클릭하면 복사됩니다. 설정한 결과가 인쇄 파일까지 맞는지는 [테스트 주문과 렌더링](/docs/templates/test-render)으로 확인합니다.
## 다음 단계
카테고리와 상품과 사이즈를 차례로 만듭니다.
InDesign 템플릿을 만들어 올리는 흐름을 봅니다.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.