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