커스텀 리포트
박스히어로 데이터를 SQL로 직접 조회하고 분석할 수 있는 기능입니다. 기존 분석 기능에서 확인하기 어려웠던 데이터를 원하는 조건으로 불러와 팀 상황에 맞게 분석할 수 있습니다.

커스텀 리포트은 현재 베타 운영 중이며 정식 출시 이후에는 유료 기능으로 제공될 예정입니다.
주요 기능
SQL을 사용해 원하는 데이터를 조회할 수 있습니다.
제품, 속성, 가격, 기간, 거래처 등 다양한 조건을 조합해 리포트를 만들 수 있습니다.
필요한 리포트를 여러 개 저장해두고 언제든지 다시 조회할 수 있습니다.
조회 결과를 Excel로 내려받아 추가 분석이나 보고 자료로 활용할 수 있습니다.
이 기능이 필요한 경우
재고 분석은 선택한 기간의 평균 재고량, 재고 회전율 등 주요 지표를 빠르게 확인할 수 있는 기능입니다. 다만 사용 가능한 변수와 수식이 정해져 있어, 팀에서 원하는 형태의 리포트를 만들기에는 제한이 있을 수 있습니다.
커스텀 리포트는 이런 한계를 보완해 SQL로 조회 조건과 데이터를 직접 선택할 수 있는 분석 기능입니다. 특히 아래와 같은 경우에 유용하게 사용하실 수 있습니다.
✔️ 기존의 분석 기능으로는 필요한 데이터를 확인하기 어려울 때
✔️ 일부 품목, 거래처, 담당자 등 세부 조건별로 데이터를 분리해서 보고 싶을 때
✔️ 월별, 분기별, 전년 대비 등 기간 단위로 비교가 필요할 때
✔️ 반복적으로 조회할 데이터를 저장해두고 싶을 때
✔️ 보고 자료나 의사 결정에 활용할 데이터가 필요할 때
사용 방법
1. 시작하기
분석 >커스텀 리포트로 이동한 뒤 새로 만들기 버튼을 눌러 새 쿼리를 생성합니다.
커스텀 리포트는 관리자와 멤버 모두 생성, 조회가 가능하며, 커스텀 권한은 접근할 수 없습니다.

2. 쿼리 작성하기
쿼리 작성은 DuckDB SQL을 기준으로 합니다. 사용 가능한 테이블과 컬럼은 AI 프롬프트 파일을 내려받아 확인할 수 있습니다.

실행 버튼을 눌러 쿼리가 정상적으로 동작하는지 확인해 주세요. 결과는 사용자가 설정한 조건에 따라 달라질 수 있으므로, 출력된 데이터가 의도한 내용과 맞는지 검토한 후 활용해 주세요.
조회된 결과는 엑셀 내보내기 버튼을 눌러 엑셀 파일로 내려받을 수 있습니다.

3. 저장하기
자주 사용하는 쿼리는 저장한 후 언제든지 조회할 수 있습니다. 쿼리 제목을 입력하고 우측 상단의 저장 버튼을 눌러주세요.
저장된 쿼리는 좌측 메뉴에서 선택해 언제든 불러올 수 있습니다.

데이터는 하루 1회 자동으로 동기화됩니다. 좌측 하단의 동기화 버튼을 누르면 즉시 동기화할 수 있습니다.
쿼리 변수
쿼리 안에 {{변수이름}}을 사용하면 쿼리를 실행할 때 변수 입력칸이 자동 생성됩니다. 사용자가 력칸에 값을 입력하면 해당 값이 쿼리 변수 위치에 적용됩니다.
쿼리를 저장해두면 다른 팀원들도 변수 입력칸에 원하는 값을 넣어 필요할 때마다 바로 조회할 수 있습니다.
예시
특정 키워드가 포함된 제품을 조회하고 싶을 때 아래 쿼리를 입력합니다.
select sku, name
from items
where name ilike '%' || {{제품명}} || '%';해당쿼리를 실행하면 ‘제품명’이라는 변수 입력칸이 자동 생성됩니다.

입력칸에 ‘니트’를 입력하면, 제품명에 ‘니트’가 포함된 모든 제품이 조회됩니다.

반복해서 조회해야 할 경우 쿼리를 저장해두고 팀원들이 함께 사용할 수 있습니다.

활용 예시
커스텀 리포트에는 바로 실행할 수 있는 기본 템플릿이 제공됩니다. 템플릿을 참고해 활용 방식을 먼저 살펴본 뒤, 필요에 맞게 수정하거나 새로운 쿼리를 만들어보세요.
기본 템플릿
주별 입출고 리포트
월별 구매/판매 추이
제품별 마지막 출고일
FAQ
여러 팀 데이터를 통합해서 분석할 수 있나요?
커스텀 리포트는 팀 단위로 데이터가 분리되어 있으며 접속한 팀의 데이터만 분석할 수 있습니다.
멤버의 커스텀 리포트 접근을 제한할 수 있나요?
커스텀 리포트는 관리자와 멤버 모두 접근할 수 있습니다. 다만 커스텀 권한을 부여받은 멤버는 커스텀 리포트에 접근할 수 없습니다.
따라서 일반 멤버의 접근을 제한하려면, 해당 멤버에게 모든 권한이 선택된 커스텀 권한을 부여해 주세요.
참고로 커스텀 권한에는 커스텀 리포트 항목이 포함되어 있지 않아, 모든 권한을 선택하더라도 해당 기능에 접근할 수 없습니다.
Last updated