공유·내보내기·미리 보기
완성된 대시보드를 다른 사용자·그룹과 공유하고, 다른 환경으로 이관하며, 미리 보기로 확인하는 방법을 설명합니다.
공유 및 권한 (ACL)
대시보드는 ACL 기반 공유를 지원합니다. 컬렉션 Ceiling 모델(공유 및 권한)과 동일한 역할 체계를 사용합니다.
공유 다이얼로그 열기
- 목록 페이지에서 대시보드
⋯메뉴 → 공유 - 편집·뷰어 모드에서 상단 헤더 공유 버튼
- 컬렉션 트리에서 대시보드 leaf 우클릭 → 공유
역할
| 역할 | 허용 |
|---|---|
| 소유자 (Owner) | 모든 권한 — 설정 변경, 공유 부여/회수, 삭제 |
| 편집자 (Writer) | 편집·저장·위젯 추가/삭제·DRS 변경 |
| 뷰어 (Reader) | 미리 보기·필터·새로고침 |
위젯 단위 접근 가드
위젯이 참조하는 데이터셋 권한이 사용자에게 없으면 해당 위젯은 뷰어에 빈 카드 + 안내 문구로 표시되며 쿼리는 실행되지 않습니다. 같은 대시보드라도 사용자마다 다른 위젯이 보일 수 있습니다(데이터셋 권한이 다르면).
Ceiling 모델과의 정합
대시보드의 소속 컬렉션 권한이 상한선입니다. 컬렉션에 뷰어인 사용자는 그 컬렉션의 대시보드에서도 뷰어를 초과할 수 없습니다.
단독 Export / Import
대시보드는 컬렉션 단위 ZIP 이외에 대시보드 1개 단위로도 내보낼 수 있습니다.
내보내기
- 목록 페이지에서 대시보드
⋯메뉴 → 내보내기를 선택합니다. (편집·뷰어 화면에는 별도 내보내기 버튼이 없으며, 내보내기는 목록 메뉴에서만 제공됩니다.) manifest.json과 위젯 구성(dashboards/<이름>.json)을 담은 ZIP 파일이 다운로드됩니다.
내보낸 ZIP은 대시보드 정의만 포함하며, 위젯이 참조하는 컬렉션·데이터셋·SQL은 포함하지 않습니다. 가져오는 환경에 해당 리소스가 없으면 가져오기 후 위젯별 오류로 표시됩니다.
가져오기
- 대시보드 목록 페이지 우상단 가져오기를 클릭하고 ZIP 파일을 드롭존에 업로드합니다.
- 업로드하면 검토 단계가 열리고, 백엔드가 다음을 검사해 보고합니다.
- 이름 충돌: 같은 이름의 대시보드가 이미 있는 경우
- 이름 규칙 위반: 이름에 허용되지 않는 문자(예: 비-ASCII)가 포함된 경우
- 충돌·위반 항목은 새 이름을 직접 입력해 해결합니다. 기존 항목 건너뛰기(skip)는 제공되지 않아 이름 변경만 가능하며, 미해결 항목이 하나라도 있으면 가져오기가 진행되지 않습니다.
이 가져오기는 단일 대시보드 ZIP 전용이며, 컬렉션 전체 ZIP과는 독립적입니다(컬렉션 ZIP은 컬렉션 가져오기에서 진행).
미리 보기
미리 보기(/dashboard/:id)는 읽기 전용 환경으로, 위젯 편집 없이 데이터를 확인하고 분석하는 데 최적화되어 있습니다.
미리 보기 접근 방법
- 대시보드 목록에서 카드/행을 클릭합니다.
- 편집 모드에서 미리 보기 버튼을 클릭합니다.
미리 보기에서 가능한 작업
| 기능 | 설명 |
|---|---|
| DRS 범위 변경 | 상단 DRS로 조회 기간 조정 (프리셋 또는 사용자 지정) |
| 편집 모드 전환 | 편집 버튼 클릭 시 대시보드 빌더로 이동 (편집자/소유자) |
| 데이터 새로고침 | 새로고침 버튼으로 최신 데이터 즉시 조회 |
| 자동 새로고침 | Settings의 주기에 따라 자동 갱신 (DRS 고정 범위 잠금 시 비활성화) |
| 테이블 정렬 / 페이지네이션 | 데이터 테이블 위젯 내 동작 |
| 위젯 액션 메뉴 | 위젯 우상단 ⋯ 메뉴의 새 탭에서 열기(External Site Embed) 등 |
미리 보기에서는 위젯의 추가, 삭제, 이동, 크기 변경이 불가능합니다. 수정이 필요한 경우 편집 버튼으로 전환하세요.
대시보드 복사
기존 대시보드를 복제하여 새 대시보드의 시작점으로 활용할 수 있습니다.
복사 방법
- 대시보드 목록에서 복제할 대시보드의
⋯메뉴를 클릭합니다. - 복제를 선택합니다.
- 원본 대시보드의 모든 위젯, 데이터 설정, 레이아웃이 그대로 복사됩니다.
유사한 대시보드를 여러 개 만들어야 할 때 복제 기능을 활용하면 반복 작업을 크게 줄일 수 있습니다. 예를 들어, 부서별로 동일한 구조의 KPI 대시보드가 필요한 경우 하나를 만들고 복제한 뒤 데이터 소스만 변경하면 됩니다.