탐색기

컬렉션 탐색기의 왼쪽 트리에서 컬렉션과 자산을 찾습니다. 가운데 목록에서 항목을 고르면 오른쪽 패널에 상세 정보가 표시됩니다.

컬렉션 범위 구분

왼쪽 트리 맨 위는 컬렉션을 세 가지 범위로 나눠 표시합니다.

• 내 컬렉션: 내가 소유한 컬렉션이 표시됩니다.
• 공유받은 컬렉션: 다른 사용자나 그룹이 공유한 컬렉션이 표시됩니다.
• 기타 컬렉션 (관리자 전용, 없으면 표시되지 않음): 나머지 컬렉션이 관리자에게만 표시됩니다.

각 범위 오른쪽에는 그 안에 든 컬렉션 개수가 배지로 표시됩니다. 범위 이름 자체는 선택할 수 없으며 그 아래의 컬렉션을 골라 작업을 이어갑니다. 일반 사용자에게는 내 컬렉션과 공유받은 컬렉션 두 개만 보입니다. 기타 컬렉션은 관리자에게만 표시되며 항목이 있을 때만 나타납니다.

범위 링크로 바로 가기 (필터 모드)

주소 끝에 ?scope=my 또는 ?scope=shared를 붙이면 해당 범위의 컬렉션만 화면에 표시되고 나머지는 숨겨집니다. 이 두 값만 쓸 수 있습니다. 다른 값을 넣으면 무시되어 주소에서 자동으로 사라집니다.

• 지정한 범위는 자동으로 펼쳐집니다.
• 검색 바 위에 **필터: 내 자산 ×**처럼 현재 범위 이름이 담긴 칩이 나타납니다. 이 칩을 누르면 범위 필터만 풀리고 선택해 둔 자산 등 다른 상태는 그대로 유지됩니다.
• 감사나 링크 공유처럼 특정 범위만 표시할 때 사용합니다.

선택 항목 링크 (?selected=)

트리나 목록에서 컬렉션이나 항목을 선택하면 그 선택이 주소창의 ?selected= 값에 그대로 담깁니다. 유효한 범위 필터(?scope=)와 선택 상태(?selected=)는 모두 주소에 유지됩니다. 범위 칩을 닫으면 ?scope=만 사라지고 선택 상태는 유지됩니다.

• 공유·복원: 지금 보고 있는 항목의 주소를 복사해 전달하거나 북마크합니다. 링크를 열거나 새로고침해도 같은 항목이 선택된 상태로 유지됩니다.
• 경로 자동 펼침: 링크를 열면 대상 항목까지 이르는 경로(범위 → 컬렉션 → 상위 폴더)가 자동으로 펼쳐지고 해당 항목이 강조됩니다.
• 주소 정리: 선택을 해제하면 이 값이 사라집니다. 이미 삭제된 컬렉션처럼 알아볼 수 없는 값은 자동으로 지워져 기본 화면으로 돌아갑니다.
• 범위 필터(?scope=)와 선택 항목(?selected=)을 함께 적용합니다. 항목을 선택해도 브라우저의 뒤로 가기 기록에는 추가되지 않습니다.

컬렉션 트리 구조

트리는 컬렉션 아래에 폴더와 개별 자산을 함께 표시합니다. 트리에는 다음 8종 자산 항목이 나타납니다.

자산 항목 (8종)	트리에 표시 안 함
데이터셋 / 소스 / 뷰 / 코드 / 파이프라인 / 지식 / 대시보드 / 에이전트	온톨로지 엔티티·관계 (의미 계층), 도구·액터 (에이전트 부품)

자산 정렬

컬렉션이나 폴더 아래에서는 유형별 그룹을 만들지 않고 다음 순서로 자산을 정렬합니다.

1. 폴더            (별칭 오름차순)
2. 데이터셋        (별칭 오름차순)
3. 소스
4. 뷰
5. 코드
6. 파이프라인
7. 지식
8. 대시보드
9. 에이전트

항목 수 표시

• 컬렉션·폴더: 바로 아래에 든 항목 수를 (N)으로 표시합니다. 하위 항목이 없으면 펼침 화살표(▶)가 표시되지 않습니다.
• 폴더: 옆의 보조 표기 · M은 하위 폴더를 포함해 그 폴더 아래에 든 자산의 전체 개수입니다.
• 자산 항목: 개수를 표시하지 않습니다.

행 클릭 동작

클릭 위치	동작
컬렉션 행	컬렉션 상세 패널 표시 + 트리 펼침
폴더 행	폴더 목록(폴더 페이지) 표시 + 트리 펼침
펼침 화살표(▶)	펼치기만 (선택은 바뀌지 않음)
자산 항목 행	해당 자산의 상세 패널 표시

폴더 구조와 제한

폴더는 컬렉션 안에서 자산을 계층적으로 정리하는 도구입니다.

• 담는 자산: 데이터셋·소스·뷰·코드·파이프라인·지식·대시보드·에이전트를 함께 둡니다.
• 최대 깊이: 폴더는 최대 5단계까지 만듭니다.
• 만들기: 컬렉션이나 폴더를 선택한 뒤 마우스 오른쪽 버튼을 클릭하고 하위 폴더 생성을 고릅니다. 컬렉션 헤더의 항목 추가 메뉴에서도 새 폴더를 선택할 수 있습니다.
• 이름 변경·이동·삭제: 폴더를 선택한 뒤 마우스 오른쪽 버튼을 클릭해 메뉴를 엽니다. 끌어다 놓거나 **폴더로 이동…**을 선택해 폴더를 옮깁니다.
• 자동 선택: 새로 만든 폴더가 자동으로 선택됩니다.
• 권한: 폴더에 공유를 설정하면 그 안의 자산에 한꺼번에 적용됩니다.
• 폴더를 다른 컬렉션으로 이동: 지원하지 않습니다. 자산은 하나씩 옮깁니다.

경로 표시: 폴더나 자산을 선택하면 화면 위쪽에 컬렉션 → 폴더 경로가 표시됩니다. 별칭이 있으면 별칭을, 없으면 시스템 이름을 표시합니다.

폴더명 규칙

검사 항목	결과
빈 이름 또는 공백만 있음	거부
. 또는 ..	거부
앞뒤에 .이 붙음	거부
/ 포함	거부
\ 포함	거부
제어 문자 포함	거부
보이지 않는 특수 문자	거부
255자를 넘김	거부
같은 컬렉션 안에 같은 이름이 이미 있음	거부

한 컬렉션 안에서는 폴더 이름이 서로 겹칠 수 없습니다. 이름 앞뒤의 공백은 저장할 때 자동으로 지워집니다.

마우스 오른쪽 버튼 메뉴

선택한 항목의 종류에 따라 적용되는 작업만 메뉴에 나타납니다.

항목 종류	표시되는 작업
컬렉션	새 폴더 / 만들기 (빠른 추가… 포함) / 이름 변경 / 공유 / 내보내기 / 삭제
폴더	새 폴더 / 만들기 / 이름 변경 / 이동 / 공유 / 삭제
자산 항목	삭제

트리의 자산 항목에서 마우스 오른쪽 버튼을 클릭하면 삭제만 표시됩니다. 열기·이름 변경·복제·공유·이동은 가운데 목록의 행 또는 행 메뉴에서 실행합니다. 트리의 빈 영역에서는 마우스 오른쪽 버튼 메뉴가 열리지 않습니다.

폴더 페이지

폴더를 선택하면 오른쪽 화면에 그 폴더에 바로 들어 있는 자산 목록이 표시됩니다. 컬렉션 상세 패널의 아이템 탭과 같은 역할을 합니다.

소스와 뷰는 왼쪽 트리에서 선택해 상세 정보를 엽니다. 이 가운데 항목 표와 유형별 그룹에는 표시되지 않습니다. 두 자산의 생성·설정 방법은 소스와 뷰에서 확인합니다.

이 화면은 위에서부터 필터 바, 일괄 작업 바, 표 순서로 구성됩니다. 일괄 작업 바는 항목을 선택할 때만 나타납니다.

• 필터 바: 이름 검색, 자산 유형 여러 개 고르기, 수정일 필터가 있습니다.
• 여러 개 선택: 체크박스로 여러 자산을 한꺼번에 선택합니다(폴더 행은 선택 대상이 아닙니다).
• 일괄 작업 바: 항목을 선택하면 표 위쪽에 나타납니다. 선택한 자산을 한꺼번에 이동하거나 삭제합니다. 공유는 개별 행을 선택한 뒤 마우스 오른쪽 버튼을 클릭해 실행합니다.
• 표 구성: 표에는 이름, 유형, 생성일, 수정일 열이 있습니다. 이름 열을 기준으로 정렬하며 한 페이지에 최대 50개를 표시합니다.
• 세부 유형 배지: 유형 열 배지에는 같은 유형 안의 세부 구분(예: 데이터셋 delta / kafka / rest / object, 코드 sql / python)이 함께 표시됩니다.
• 소유자 정보: 이 폴더 목록 표에는 소유자 열이 따로 없습니다. 소유자·구성원과 마우스를 올려 보는 미리보기는 컬렉션을 선택했을 때 나오는 컬렉션 개요 화면에서 확인합니다.

유형별 그룹화

필터 바 오른쪽의 탐색 보기 방식에서 기본 또는 유형별을 선택합니다.

• 기본: 모든 자산을 하나의 목록에 표시합니다.
• 유형별: 자산을 데이터셋·코드·파이프라인 같은 유형별로 묶고 각 묶음 위에 유형 (N) 형식의 머리글을 표시합니다. 머리글을 누르면 해당 묶음을 접거나 펼칩니다.

컬렉션 간 이동

선택한 자산을 다른 컬렉션이나 폴더로 옮깁니다.

1. 표에서 옮길 자산을 선택합니다. 자산 하나만 옮길 때는 행을 선택한 뒤 마우스 오른쪽 버튼을 클릭하고 이동을 고르거나 트리에서 끌어다 놓습니다.
2. 일괄 작업 바의 이동을 누르거나, 대상 폴더·컬렉션 위로 끌어다 놓습니다.
3. 경로 선택 창의 검색 입력과 컬렉션 → 폴더 트리에서 옮길 위치를 고릅니다. 자산이 이미 있는 위치는 비활성화되어 고를 수 없습니다.
4. 이동을 누르면 자산이 하나씩 옮겨집니다. 권한이 없는 자산은 실패로 표시됩니다. 일부 자산만 실패하면 창이 남아 있어 해당 항목을 다시 시도합니다.

폴더 자체를 다른 컬렉션으로 옮기는 것은 지원하지 않습니다. 자산 단위로만 옮길 수 있습니다.

전역 이름 검색

왼쪽 트리의 검색 바에서 컬렉션과 자산을 이름·별칭으로 찾습니다. 내가 속하지 않은 컬렉션의 자산도 결과에 표시됩니다. 사이드바의 검색… 메뉴(⌘K(macOS) / Ctrl+K(Windows))도 같은 검색 결과를 사용합니다.

둘러보기

컬렉션 탐색기를 처음 사용한다면 헤더 오른쪽 더 보기(⋯)에서 둘러보기를 선택해 5단계 안내를 실행합니다. 둘러보기는 같은 메뉴의 가져오기 옆에 있습니다.

1. 새 컬렉션 만들기: 헤더의 생성 버튼을 안내합니다.
2. 탐색 트리: 왼쪽 트리와 검색을 안내합니다.
3. 유형 필터: 유형 필터와 검색 바를 안내합니다.
4. 항목 목록: 선택한 위치의 자산 목록을 안내합니다.
5. 상세 보기: 오른쪽 상세 패널을 안내합니다.

둘러보기는 직접 실행할 때만 열리며 화면에 표시된 영역만 안내합니다. 컬렉션이 없는 빈 화면에서는 생성 버튼과 탐색 트리만 안내합니다.

처음 시작 화면 (빈 상태)

컬렉션이 하나도 없을 때는 가운데 화면과 오른쪽 패널 모두 같은 시작 안내 화면을 표시합니다. 컬렉션 만들기 버튼과 함께 "작업 공간 만들기 → 자산 추가 → 운영 흐름 연결"의 3단계 안내를 제공합니다.