# 커스텀 리포트
***
***
{% hint style="success" %}
커스텀 리포트은 현재 베타 운영 중이며 정식 출시 이후에는 유료 기능으로 제공될 예정입니다.
{% endhint %}
## 주요 기능
* SQL을 사용해 원하는 데이터를 조회할 수 있습니다.
* 제품, 속성, 가격, 기간, 거래처 등 다양한 조건을 조합해 리포트를 만들 수 있습니다.
* 필요한 리포트를 여러 개 저장해두고 언제든지 다시 조회할 수 있습니다.
* 조회 결과를 Excel로 내려받아 추가 분석이나 보고 자료로 활용할 수 있습니다.
#### 이 기능이 필요한 경우
`재고 분석`은 선택한 기간의 평균 재고량, 재고 회전율 등 **주요 지표를 빠르게 확인할 수 있는 기능**입니다. 다만 사용 가능한 변수와 수식이 정해져 있어, 팀에서 원하는 형태의 리포트를 만들기에는 제한이 있을 수 있습니다.
`커스텀 리포트`는 이런 한계를 보완해 **SQL로 조회 조건과 데이터를 직접 선택**할 수 있는 분석 기능입니다. 특히 아래와 같은 경우에 유용하게 사용하실 수 있습니다.
✔️ 기존의 분석 기능으로는 필요한 데이터를 확인하기 어려울 때
✔️ 일부 품목, 거래처, 담당자 등 세부 조건별로 데이터를 분리해서 보고 싶을 때
✔️ 월별, 분기별, 전년 대비 등 기간 단위로 비교가 필요할 때
✔️ 반복적으로 조회할 데이터를 저장해두고 싶을 때
✔️ 보고 자료나 의사 결정에 활용할 데이터가 필요할 때
## **사용 방법**
### 1. 시작하기
`분석` >`커스텀 리포트`로 이동한 뒤 `새로 만들기` 버튼을 눌러 새 쿼리를 생성합니다.
커스텀 리포트는 **관리자와 멤버 모두 생성, 조회가 가능**하며, 커스텀 권한은 접근할 수 없습니다.
### 2. 쿼리 작성하기
쿼리 작성은 [**DuckDB SQL**](https://duckdb.org/docs/stable/sql/introduction)을 기준으로 합니다. 사용 가능한 테이블과 컬럼은 **AI 프롬프트 파일**을 내려받아 확인할 수 있습니다.
{% hint style="info" %}
ChatGPT 같은 AI 도구를 사용할 때 AI 프롬프트 파일을 함께 제공하면, 필요한 쿼리를 더 간편하게 생성할 수 있습니다.
{% endhint %}
`실행` 버튼을 눌러 쿼리가 정상적으로 동작하는지 확인해 주세요. 결과는 사용자가 설정한 조건에 따라 달라질 수 있으므로, **출력된 데이터가 의도한 내용과 맞는지 검토한 후 활용**해 주세요.
조회된 결과는 `엑셀 내보내기` 버튼을 눌러 엑셀 파일로 내려받을 수 있습니다.
### 3. 저장하기
자주 사용하는 쿼리는 저장한 후 언제든지 조회할 수 있습니다. 쿼리 제목을 입력하고 우측 상단의 `저장` 버튼을 눌러주세요.
저장된 쿼리는 좌측 메뉴에서 선택해 언제든 불러올 수 있습니다.
{% hint style="warning" %}
데이터는 하루 1회 자동으로 동기화됩니다. 좌측 하단의 동기화 버튼을 누르면 즉시 동기화할 수 있습니다.
{% endhint %}
## 쿼리 변수
쿼리 안에 `{{변수이름}}`을 사용하면 **쿼리를 실행할 때 변수 입력칸이 자동 생성**됩니다. 사용자가 력칸에 값을 입력하면 해당 값이 쿼리 변수 위치에 적용됩니다.
쿼리를 저장해두면 다른 팀원들도 변수 입력칸에 원하는 값을 넣어 필요할 때마다 바로 조회할 수 있습니다.
#### 예시
1. 특정 키워드가 포함된 제품을 조회하고 싶을 때 아래 쿼리를 입력합니다.
```sql
select sku, name
from items
where name ilike '%' || {{제품명}} || '%';
```
2. 해당쿼리를 실행하면 ‘제품명’이라는 변수 입력칸이 자동 생성됩니다.
3. 입력칸에 ‘니트’를 입력하면, 제품명에 ‘니트’가 포함된 모든 제품이 조회됩니다.
4. 반복해서 조회해야 할 경우 쿼리를 저장해두고 팀원들이 함께 사용할 수 있습니다.
## 활용 예시
커스텀 리포트에는 바로 실행할 수 있는 기본 템플릿이 제공됩니다. 템플릿을 참고해 활용 방식을 먼저 살펴본 뒤, 필요에 맞게 수정하거나 새로운 쿼리를 만들어보세요.
{% embed url="" %}
#### 기본 템플릿
* 주별 입출고 리포트
* 월별 구매/판매 추이
* 제품별 마지막 출고일
* FIFO 재고 자산 평가
* 가용재고
***
## FAQ
### 여러 팀 데이터를 통합해서 분석할 수 있나요?
커스텀 리포트는 팀 단위로 데이터가 분리되어 있으며 **접속한 팀의 데이터만 분석**할 수 있습니다.
### 멤버의 커스텀 리포트 접근을 제한할 수 있나요?
커스텀 리포트는 관리자와 멤버 모두 접근할 수 있습니다. 다만 커스텀 권한을 부여받은 멤버는 커스텀 리포트에 접근할 수 없습니다.
따라서 일반 멤버의 **접근을 제한하려면, 해당 멤버에게 모든 권한이 선택된 커스텀 권한을 부여**해 주세요.
참고로 커스텀 권한에는 커스텀 리포트 항목이 포함되어 있지 않아, 모든 권한을 선택하더라도 해당 기능에 접근할 수 없습니다.
---
# 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://www.boxhero.io/docs/documentation/ko/key-features/custom-analytics.md?ask=
```
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.
.png?alt=media)
