Workshop 위젯의 구성과 데이터 연결
위젯은 모듈의 사용자 인터페이스를 구성하는 요소입니다. Filter List는 대상 조건을 선택하고, Object Table은 객체를 보여 주며, Button Group은 이벤트나 업무 동작을 실행하도록 연결합니다. 위젯을 레이아웃에 배치한 뒤 입출력 변수, 화면 옵션과 필요한 액션을 구성합니다.
위젯 추가
빈 섹션에 포인터를 올리고 + Add widget을 선택합니다. 섹션 또는 모듈 머리글의 + 버튼으로도 선택기를 열 수 있습니다. 필요한 위젯을 선택하면 해당 영역에 추가합니다.
추가한 위젯을 선택하면 오른쪽에 구성 패널이 나타납니다.
Widget setup
Widget setup에서 처음 들어갈 데이터와 위젯이 만들어 내보낼 데이터, 추가 동작 및 표시 옵션을 정합니다. 다음은 아직 연결하지 않은 Filter List입니다.
| 설정 | 역할 |
|---|---|
| Object Set | 필터를 구성할 입력 객체 집합입니다. 기존 변수를 선택하거나 새 객체 집합 변수를 만듭니다. |
| Filter List | 표시할 필터를 정합니다. 입력 집합을 지정하면 해당 속성 유형, 전체 속성의 키워드 검색과 연결 객체 존재 여부를 이용한 필터를 구성할 수 있습니다. |
| Allow Users to Add and Remove Filters | 사용자가 표시할 필터를 추가하거나 제거하는 조작을 제공합니다. |
| Filter Output | Object Set Filter 유형의 출력 변수입니다. 다른 객체 집합 변수에 적용하여 대상을 좁힙니다. Filter List를 추가할 때 기본적으로 출력 변수를 만듭니다. |
Filter Output은 객체 집합 자체가 아니라 그 집합에 적용할 조건입니다. 입력과 출력의 자료형을 맞춰 연결합니다.
Metadata
Widget Name은 Layout 패널 등에서 위젯을 찾을 때 표시하는 이름과 기본 변수 이름에 영향을 줍니다. 목적을 알아볼 수 있게 이름을 정합니다.
Raw Widget Configuration에서는 현재 위젯 설정을 저장한 JSON을 볼 수 있습니다. 고급 사용자는 이를 직접 편집하거나 복사하여 구성에 사용할 수 있습니다.
Display
Display는 위젯 크기를 정합니다.
| 방식 | 동작 |
|---|---|
| Auto (max) | 콘텐츠에 따라 높이를 조정하되 최대 높이를 정합니다. Columns layout에서 위젯의 너비를 설정하는 용도로는 사용할 수 없습니다. |
| Absolute | 픽셀 단위의 고정 크기를 지정합니다. |
| Flex | 다른 위젯에 대한 높이 또는 너비 비율을 정하여 화면 크기와 해상도가 달라질 때 함께 조정합니다. |
Display optimization은 이동 중 위젯을 언제 마운트하거나 언마운트할지 제어합니다. 로컬 상태를 가진 사용자 정의 위젯, 초기 로드 비용이 큰 위젯이나 자주 다시 여는 위젯에서 이 설정을 검토합니다. 위젯의 생명주기 설정과 변수의 지연 계산은 구분하여 구성합니다.
복사와 재사용
구성한 위젯을 선택하여 macOS에서는 Cmd+C, Windows에서는 Ctrl+C로 복사합니다. Cmd+V 또는 Ctrl+V로 붙여 넣으면 왼쪽 Layouts 영역 아래의 Unused widgets에 들어갑니다.
그 위젯을 배치하려면 + Add widget을 열고 Unused widgets 탭에서 선택합니다.
섹션과 위젯의 잘라내기, 복사 및 붙여넣기 메뉴도 사용할 수 있습니다. 레이아웃에서 같은 입력 변수를 재사용하거나 입력 변수까지 복제하는 두 방식을 설명합니다.
여러 위치에서 반복하고 앞으로 자주 바꿀 구성이라면 위젯 사본을 각각 관리하는 대신 별도 Workshop 모듈로 분리하여 삽입하는 방식을 검토합니다.
입력과 출력 변수
입력 변수는 위젯에 들어갈 데이터입니다. 객체 집합을 Object Table, Filter List, 차트와 지도에 제공하는 방식이 한 예입니다.
출력 변수는 위젯의 결과를 다른 변수나 위젯에 전달합니다. Object Table의 Selected Objects는 객체 집합이며 String Dropdown의 Selected Value는 문자열입니다. 출력이 바뀌면 이를 사용하는 후속 계산과 표시가 영향을 받습니다.
변수는 이러한 의존성을 정의하고 이벤트는 사용자의 조작으로 값을 바꾸거나 동작을 실행합니다. 모듈과 연결 기능에 필요한 권한도 각각 적용됩니다.
기능별 위젯
개별 객체의 내용을 확인하려면 표시 위젯을, 집계값이나 변화 추이를 비교하려면 시각화 위젯을 선택합니다. 사용자가 조건을 정하는 입력과 그 조건에 맞는 결과를 보여 주는 위젯은 변수를 통해 연결합니다. 실제 객체 편집이나 다른 화면 이동은 액션과 이벤트를 지원하는 위젯에 구성합니다.
객체와 속성 표시
| 위젯 | 역할과 선택 기준 |
|---|---|
| Object Table | 객체 하나를 한 행으로 보여 주어 여러 객체의 속성을 열 단위로 비교합니다. |
| Object List | 객체마다 카드를 표시하는 목록입니다. |
| Object View | 객체의 상세 내용을 전체 뷰 또는 패널로 표시합니다. 패널의 Adaptive 모드는 입력 객체 수에 따라 객체 상세 뷰와 객체 집합 뷰를 전환합니다. |
| Property List | 입력 집합의 첫 번째 객체에서 표시할 속성과 배치를 정합니다. |
| Links | 링크 유형과 연결된 객체를 접고 펼칠 수 있는 섹션으로 보여 줍니다. |
| Object Set Title | 객체 집합의 요약을 제목으로 표시합니다. |
| Header text | 머리글에 맞춘 두 행의 텍스트를 표시합니다. |
여러 객체 유형을 공통 속성으로 다루려면 온톨로지 인터페이스를 지원하는 위젯을 선택합니다.
시각화와 분석
| 위젯 | 역할과 선택 기준 |
|---|---|
| Chart: Pie | 객체 데이터를 원형 또는 도넛 차트로 보여 줍니다. |
| Chart: XY | 여러 데이터 계열과 축 및 스타일을 가진 막대, 선 또는 산점도를 구성합니다. |
| Chart: Vega | Vega나 Vega-Lite 문법으로 사용자 차트를 구성합니다. |
| Map | 객체 집합을 지리공간에 표시하고 지도 선택과 탐색을 연결합니다. |
| Free-form Analysis | 사용자가 Workshop 안에서 분석 카드를 구성하여 객체 데이터를 탐색합니다. |
| Time Series Analysis | 시계열 데이터와 파생 계산을 조사합니다. |
| Gantt Chart | 시간 속성이 있는 객체를 수평 시간 구간으로 표시합니다. |
| Image Annotation | 이미지의 관심 영역에 사각형 주석을 그립니다. |
| Linked Compass Resources | 객체에 연결된 Compass 리소스를 보여 줍니다. |
| Markdown | 서식 있는 텍스트를 표시하고 필요하면 텍스트의 객체 참조를 구성합니다. |
| Media Preview | URL, Foundry RID나 Base64 데이터의 PNG, JPEG, PDF 등을 미리 봅니다. 함수가 Base64 문자열로 반환하는 시각화도 표시할 수 있습니다. |
| Metric Card | 설정한 지표값을 카드로 표시합니다. |
| PDF Viewer | PDF와 키워드 검색을 제공합니다. |
| Pivot Table | 객체 데이터를 동적으로 그룹화하고 집계하여 표로 보여 줍니다. |
| Resource List | 여러 유형의 Foundry 리소스를 표시합니다. |
| Status Tracker | 한 프로세스의 상태를 타임라인에 표시합니다. |
| Stepper | 순서대로 또는 비선형으로 완료하는 여러 단계의 진행 상태를 표시합니다. |
| Timeline | 시간 데이터가 있는 객체를 타임라인의 이벤트로 표시합니다. |
| Chart: Waterfall | 객체 데이터를 폭포 차트로 표시합니다. |
| Action Log Timeline | 객체의 액션 로그를 시간 순서로 보여 줍니다. |
Status Tracker는 프로세스 상태, Stepper는 단계 완료, Timeline은 시간에 놓인 객체 이벤트를 다룹니다. 표시하려는 대상에 맞춰 선택합니다.
필터와 입력
여러 필터 위젯은 현재 조건을 Object Set Filter 변수에 출력합니다. 이 조건을 객체 집합 변수에 적용하거나 다른 위젯 구성에서 재사용할 수 있습니다. 초기 필터와 선택값 추출은 객체 집합 필터 변수에서 구성합니다. 문자열이나 숫자를 직접 입력받는 위젯은 해당 값의 변수를 출력하므로 이후 계산이나 필터의 입력으로 연결합니다.
| 위젯 | 역할과 선택 기준 |
|---|---|
| Filter List | 속성별 히스토그램, 분포 차트, 날짜 선택기와 자동완성 선택기를 제공합니다. 객체 유형이나 키워드로도 필터링합니다. |
| Object Dropdown | 목록에서 객체 하나를 선택합니다. |
| Object Selector | 목록에서 여러 객체를 선택합니다. |
| String Selector | 문자열 목록에서 값을 선택합니다. 단일 또는 다중 선택의 출력 유형을 맞춥니다. |
| Checkbox | 이진값을 켜거나 끄는 체크박스입니다. |
| Date and Time Picker | 날짜와 시간을 입력받습니다. |
| Date Input | 단일 날짜 또는 날짜 구간을 입력받습니다. |
| Text Input | 텍스트를 입력받습니다. |
| Numeric Input | 숫자를 입력받습니다. |
| Exploration Filter Pills | 객체 집합에 적용할 필터를 표시하고 수정합니다. |
| Exploration Search Bar | 속성과 연결된 객체 유형으로 객체 집합 필터를 구성합니다. |
| Prominent Terms | 입력 객체 집합에서 주요 용어와 일치하는 객체 수를 보여 줍니다. |
| User Select | Palantir 사용자를 드롭다운에서 선택합니다. |
이벤트와 탐색
| 위젯 | 역할과 선택 기준 |
|---|---|
| Button Group | 액션, Workshop 이벤트, Commands, URL 열기, 객체 집합 내보내기, 함수 기반 내보내기와 미디어 내보내기를 버튼에 연결합니다. |
| Comments | 모듈 안에서 객체를 대상으로 댓글을 읽고 게시하며 협업합니다. |
| Media Uploader | 미디어를 Foundry에 올리고 업로드한 파일을 입력으로 액션을 실행하도록 구성합니다. |
| Tabs | 탭 선택에 이벤트를 연결하여 모듈의 페이지와 레이아웃 사이를 이동합니다. |
| Inline Action | 온톨로지 액션 유형에 맞춘 폼이나 표로 객체의 생성, 수정과 삭제 및 링크의 생성과 제거를 수행합니다. |
이벤트 실행은 위 목록에만 한정되지 않습니다. 예를 들어 Metric Card의 Interactive metric을 구성하면 Commands, 액션 또는 이벤트를 실행할 수 있습니다. 각 위젯의 상호작용 설정과 대상 액션의 권한을 함께 구성합니다.
다른 Foundry 앱 삽입
다른 앱에서 만든 분석, 문서나 지도를 Workshop 안에서 재사용하는 경우에는 저장 리소스의 유형과 입력 계약에 맞는 삽입 위젯을 선택합니다.
| 위젯 | 역할과 선택 기준 |
|---|---|
| Iframe | 사용자 앱 URL 또는 Slate 앱을 iframe으로 삽입합니다. |
| Derived series | 파생 시계열을 생성하고 갱신하며 찾아볼 수 있는 관리 화면을 삽입합니다. |
| Map Application Template | Map 앱에서 만든 기존 지리공간 템플릿을 표시합니다. |
| Notepad - Embedded Document | Notepad 문서를 읽기 전용 또는 편집 모드로 삽입합니다. |
| Quiver Dashboard | Quiver에서 구성하고 게시한 대시보드를 표시합니다. |
| Vertex Graph | Vertex에서 만든 기존 그래프, 그래프 템플릿 또는 다이어그램을 표시합니다. |
| Workshop: Embedded Module | 다른 Workshop 모듈을 위젯으로 삽입합니다. |
삽입하는 앱과 데이터에는 원래의 접근 권한이 적용됩니다. 변수 연결이나 로딩 방식도 각 삽입 위젯의 계약을 따릅니다.
모바일용 탐색과 기기 입력은 Workshop 모바일, AI 대화와 생성 결과는 AIP 위젯, 실행 수와 지연시간은 Observability Chart에서 구성합니다.