# 커스텀 리포트
***
***
{% 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
### 여러 팀 데이터를 통합해서 분석할 수 있나요?
커스텀 리포트는 팀 단위로 데이터가 분리되어 있으며 **접속한 팀의 데이터만 분석**할 수 있습니다.
### 멤버의 커스텀 리포트 접근을 제한할 수 있나요?
커스텀 리포트는 관리자와 멤버 모두 접근할 수 있습니다. 다만 커스텀 권한을 부여받은 멤버는 커스텀 리포트에 접근할 수 없습니다.
따라서 일반 멤버의 **접근을 제한하려면, 해당 멤버에게 모든 권한이 선택된 커스텀 권한을 부여**해 주세요.
참고로 커스텀 권한에는 커스텀 리포트 항목이 포함되어 있지 않아, 모든 권한을 선택하더라도 해당 기능에 접근할 수 없습니다.
.png?alt=media)
