Button Group 위젯
Button Group은 액션과 이벤트를 실행하고 URL을 열거나 데이터를 내보내는 버튼을 구성합니다. 한 버튼, 선택 메뉴 또는 주요 버튼과 메뉴를 결합한 형태를 사용할 수 있습니다.
형태와 항목
| Button type | 구성 |
|---|---|
| Inline | 단일 동작 버튼 |
| Menu | 여러 선택지를 가진 메뉴 버튼 |
| Two-part | 주요 버튼과 추가 메뉴의 결합 |
Add button으로 버튼 또는 메뉴 항목을 추가하고 Duplicate button으로 기존 설정을 복사합니다.
표시와 조건
Button text는 표시 문구이며 Description은 포인터를 올렸을 때의 tooltip입니다. Button color는 none, primary(파랑), success(초록), warning(황색), danger(빨강) 또는 사용자 색을 사용합니다. Hex 코드도 지정할 수 있습니다.
Left icon과 Right icon은 양쪽 아이콘을 정하며 Blank로 숨깁니다.
Conditional visibility를 켜면 Boolean variable을 연결하고 State if false에서 변수값이 false일 때 Disabled로 둘지 Hidden으로 숨길지 선택합니다.
| Display & formatting | 동작 |
|---|---|
| Minimal style | 테두리를 제거합니다. 색을 지정한 버튼은 배경색과 글자색의 관계를 반전시킵니다. 예를 들어 파란 배경/흰 글자 대신 흰 배경/파란 글자를 사용할 수 있습니다. |
| Tag style | 더 좁은 태그 형태로 표시합니다. |
| Large style | 버튼 크기를 키웁니다. |
| Fill available horizontal space in row and column layouts | 포함한 섹션의 가로 공간을 채웁니다. |
On click
액션과 수명주기 이벤트
예를 들어 Modify Flight Destination 액션을 연결하여 선택한 Flight 객체의 Destination 속성을 바꾸는 업무를 실행할 수 있습니다.
액션과 함께 실행할 이벤트의 시점도 정할 수 있습니다. On start of action submission은 제출 시작, On successful completion of action submission은 성공 이후입니다. 새로고침, 화면 이동이나 변수 갱신을 적절한 시점에 연결합니다.
Apply to Scenario를 켜고 Scenario 변수를 선택하면 해당 시나리오에 액션을 적용합니다. 운영 온톨로지 적용과 시나리오 적용을 구분합니다.
이벤트와 명령
하나 이상의 Workshop 이벤트를 실행할 수 있습니다. 순차 실행이어도 앞 이벤트가 유발한 후속 변수 계산이 모두 끝날 때까지 기다리지는 않습니다.
다른 Palantir 앱의 기능을 실행하는 Commands도 Button Group에서 구성할 수 있습니다. 해당 앱의 명령과 입력을 연결합니다.
URL
Foundry의 다른 화면이나 외부 웹사이트를 열 수 있습니다. 외부 주소에는 https:// 접두어를 포함합니다.
객체 집합 내보내기
Export는 객체 집합 변수를 받아 Excel 또는 클립보드로 내보냅니다. 파일명과 포함할 속성을 선택적으로 지정할 수 있습니다.
Button Group의 이 내보내기는 정렬 순서를 보존하지 않습니다. 순서가 필요하면 구성한 정렬을 따르는 Object Table의 오른쪽 클릭 내보내기를 사용합니다.
함수 기반 열이나 연결 객체 열을 포함하면 Excel이 아닌 CSV로 내보냅니다.
Function-backed export
함수와 입력을 지정하고 결과를 선택한 형식으로 다운로드합니다. 지원 형식은 CSV, TXT, JSON, XML, PDF, DOCX와 XLSX입니다.
| 형식 | 함수 반환 내용 |
|---|---|
| CSV, TXT, JSON, XML | 파일 내용을 담은 일반 문자열 |
| PDF, DOCX, XLSX | 파일 바이트를 Base64로 인코딩한 문자열. Python은 bytes를 직접 반환하는 경로도 지원합니다. |
문자열 계약과 Python의 바이너리 반환 지원 범위를 구분합니다. 다른 반환 유형이나 지원하지 않는 ZIP 등의 다운로드는 이 선택기로 제공하지 않습니다. 필요한 경우 함수를 직접 호출하는 OSDK custom widget에서 iframe의 allow-downloads 허용을 구성하는 경로를 검토합니다.
Base64 문자열에는 data:application/pdf;base64, 같은 MIME 접두어를 넣지 않습니다. 넣으면 다운로드에 실패하며, MIME 유형은 선택한 파일 형식에서 정합니다.
실패 알림에는 원인이 표시됩니다. 함수가 UserFacingError를 던지면 해당 메시지를 보여 주고, 알 수 없는 오류 유형이면 일반 오류 메시지를 표시합니다.
Export media
Export media는 여러 내보내기 항목을 구성하여 해당 미디어들을 다운로드합니다.
각 항목에서 객체 집합, 미디어 유형, 미디어 속성과 다운로드할 최대 객체 수를 지정합니다.
사용자 파일명에는 현재 시각, 원래 파일명과 기본 키 이외의 객체 속성값을 치환해 넣을 수 있습니다. 별도 이름을 정하지 않으면 원래 파일명을 사용합니다.
이 버튼 설정과 실제 데이터 및 반출 권한은 별개입니다. 여러 단계를 고정된 탐색 항목으로 보여 주려면 Tabs, 입력 양식을 화면 안에 두려면 Inline Action을 사용합니다.
텍스트의 객체 참조나 주석에서 실행할 동작은 Markdown, 댓글 작성 뒤의 액션과 알림은 Comments에 구성합니다.