커스텀 리포트

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


커스텀 리포트 썸네일

주요 기능

  • SQL을 사용해 원하는 데이터를 조회할 수 있습니다.

  • 제품, 속성, 가격, 기간, 거래처 등 다양한 조건을 조합해 리포트를 만들 수 있습니다.

  • 필요한 리포트를 여러 개 저장해두고 언제든지 다시 조회할 수 있습니다.

  • 조회 결과를 Excel로 내려받아 추가 분석이나 보고 자료로 활용할 수 있습니다.

이 기능이 필요한 경우

재고 분석은 선택한 기간의 평균 재고량, 재고 회전율 등 주요 지표를 빠르게 확인할 수 있는 기능입니다. 다만 사용 가능한 변수와 수식이 정해져 있어, 팀에서 원하는 형태의 리포트를 만들기에는 제한이 있을 수 있습니다.

커스텀 리포트는 이런 한계를 보완해 SQL로 조회 조건과 데이터를 직접 선택할 수 있는 분석 기능입니다. 특히 아래와 같은 경우에 유용하게 사용하실 수 있습니다.

✔️ 기존의 분석 기능으로는 필요한 데이터를 확인하기 어려울 때

✔️ 일부 품목, 거래처, 담당자 등 세부 조건별로 데이터를 분리해서 보고 싶을 때

✔️ 월별, 분기별, 전년 대비 등 기간 단위로 비교가 필요할 때

✔️ 반복적으로 조회할 데이터를 저장해두고 싶을 때

✔️ 보고 자료나 의사 결정에 활용할 데이터가 필요할 때

사용 방법

1. 시작하기

분석 >커스텀 리포트로 이동한 뒤 새로 만들기 버튼을 눌러 새 쿼리를 생성합니다.

커스텀 리포트는 관리자와 멤버 모두 생성, 조회가 가능하며, 커스텀 권한은 접근할 수 없습니다.

커스텀 리포트 처음 접속 화면

2. 쿼리 작성하기

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

쿼리 작성 화면

ChatGPT 같은 AI 도구를 사용할 때 AI 프롬프트 파일을 함께 제공하면, 필요한 쿼리를 더 간편하게 생성할 수 있습니다.

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

조회된 결과는 엑셀 내보내기 버튼을 눌러 엑셀 파일로 내려받을 수 있습니다.

조회된 결과 확인하기

3. 저장하기

자주 사용하는 쿼리는 저장한 후 언제든지 조회할 수 있습니다. 쿼리 제목을 입력하고 우측 상단의 저장 버튼을 눌러주세요.

저장된 쿼리는 좌측 메뉴에서 선택해 언제든 불러올 수 있습니다.

쿼리 저장하는 방법

쿼리 변수

쿼리 안에 {{변수이름}}을 사용하면 쿼리를 실행할 때 변수 입력칸이 자동 생성됩니다. 사용자가 력칸에 값을 입력하면 해당 값이 쿼리 변수 위치에 적용됩니다.

쿼리를 저장해두면 다른 팀원들도 변수 입력칸에 원하는 값을 넣어 필요할 때마다 바로 조회할 수 있습니다.

예시

  1. 특정 키워드가 포함된 제품을 조회하고 싶을 때 아래 쿼리를 입력합니다.

select sku, name 
from items 
where name ilike '%' || {{제품명}} || '%';
  1. 해당쿼리를 실행하면 ‘제품명’이라는 변수 입력칸이 자동 생성됩니다.

쿼리 실행 시 쿼리 변수 입력창이 뜨는 화면
  1. 입력칸에 ‘니트’를 입력하면, 제품명에 ‘니트’가 포함된 모든 제품이 조회됩니다.

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

저장한 쿼리에서 검색할 수 있는 쿼리 변수

활용 예시

커스텀 리포트에는 바로 실행할 수 있는 기본 템플릿이 제공됩니다. 템플릿을 참고해 활용 방식을 먼저 살펴본 뒤, 필요에 맞게 수정하거나 새로운 쿼리를 만들어보세요.

기본 템플릿

  • 주별 입출고 리포트

  • 월별 구매/판매 추이

  • 제품별 마지막 출고일


FAQ

여러 팀 데이터를 통합해서 분석할 수 있나요?

커스텀 리포트는 팀 단위로 데이터가 분리되어 있으며 접속한 팀의 데이터만 분석할 수 있습니다.

멤버의 커스텀 리포트 접근을 제한할 수 있나요?

커스텀 리포트는 관리자와 멤버 모두 접근할 수 있습니다. 다만 커스텀 권한을 부여받은 멤버는 커스텀 리포트에 접근할 수 없습니다.

따라서 일반 멤버의 접근을 제한하려면, 해당 멤버에게 모든 권한이 선택된 커스텀 권한을 부여해 주세요.

참고로 커스텀 권한에는 커스텀 리포트 항목이 포함되어 있지 않아, 모든 권한을 선택하더라도 해당 기능에 접근할 수 없습니다.

Last updated