Slate 플랫폼 위젯
Platform 범주의 Object Card, Resource Selector, Time Series와 Action은 Foundry 리소스나 온톨로지 기능을 화면에 연결합니다.
Object Card
Object RID를 받아 온톨로지에 정의된 작은 객체 뷰인 카드를 표시합니다. 카드는 Object Explorer의 객체 상세 뷰로 연결됩니다.
| 속성 | 자료형 | 필수 | 역할 |
|---|---|---|---|
| cardStyles | Boolean | 예 | 그림자와 hover 등 카드 스타일을 사용합니다. |
| objectRid | String | 예 | 표시할 객체의 실제 RID입니다. |
| fixedHeader | Boolean | 예 | 내용이 넘칠 때 header를 고정합니다. |
RID 얻기
- Object Set 패널에서 객체를 조회하고 결과의 RID를 사용합니다.
- 객체 뷰의 Actions에서 링크를 복사한 뒤 URL의 objectId 매개변수값을 읽습니다. 예를 들어
?objectId=ri.phonograph2-objects.main.object.09d2e0e9-dd3c-49b2-8b96-0cb1bf005c1d에서 objectId 값 전체가 RID입니다. 자신의 실제 객체값을 사용합니다. - ObjectTypeId와 ObjectPrimaryKey만 있다면 Get Object by Locator 엔드포인트로 RID를 조회합니다. 플랫폼 인스턴스에 엔드포인트가 제공되고 데이터 소스로 구성되어 있어야 합니다.
여러 카드
RID 배열을 반환하는 f_function1이 있다면 Repeating Container 안에 Object Card를 넣습니다. Object RID 입력을 다음처럼 구성하여 각 반복 위치의 RID를 선택합니다.
{{lookup f_function1 w_repeating_container.index}}
Resource Selector
Compass 파일을 선택하는 대화상자입니다. 페이지 자체에 표시 요소를 만들지 않고 여는 액션과 결과 이벤트를 제공합니다.
| 이름 | 역할 |
|---|---|
w_resource_selector_1.open | 선택 대화상자를 엽니다. |
w_resource_selector_1.didClose | 대화상자가 닫히면 발생합니다. |
w_resource_selector_1.selectedRid.changed | 선택한 리소스의 RID를 {{slEventValue}}로 전달합니다. |
Time Series
Series ID로 여러 시계열을 같은 그래프에 넣을 수 있습니다. Title, Unit과 Color를 정하고 Crosshairs 및 Legends 표시를 끌 수 있습니다. Time Range를 동적으로 연결하여 표시 구간을 정하며 streaming mode도 사용할 수 있습니다.
Action
미리 만든 Foundry Action을 선택하고 입력을 연결하여 업무 로직을 제출합니다. 자신에게 접근 권한이 있는 액션을 선택해야 합니다.
- Action widget을 추가합니다.
- 액션을 선택하고 Default Parameters를 직접 입력하거나 Handlebars로 연결합니다.
- 폼의 Submit 버튼 또는
w_widget.submitSlate 액션으로 제출합니다.
폼 표시를 끄면 다른 위젯의 입력을 받아 이벤트로 제출할 수 있습니다. 쓰기 구성에서 폼과 Dialog의 연결을 설명합니다.
관련 이벤트
| 이벤트 | 역할 |
|---|---|
w_widget.success / w_widget.failure | 제출 성공 또는 실패입니다. |
w_widget.ValidationSuccess / w_widget.ValidationFailure | 검증 상태입니다. |
w_widget.transitioned / w_widget.cssClassesUpdated | Action widget의 렌더 변경 hook입니다. |
액션 자체의 생성과 규칙은 Action 유형을 따릅니다.
기본 매개변수
사용자가 폼에서 입력하거나 위젯 구성에서 기본값을 제공할 수 있습니다. 액션 유형 자체에도 기본값을 지정하여 그 액션을 사용하는 모든 앱에 적용할 수 있습니다. Slate 위젯에서 따로 지정한 기본값은 액션 유형의 기본값보다 우선합니다.
객체 locator
객체 참조는 typeId와 primaryKey 맵으로 제공합니다. typeId는 객체 유형 ID이고 primaryKey의 키는 기본 키 속성 ID, 값은 해당 객체의 실제 키값입니다. Ontology Manager에서 이 정의를 확인합니다.
예를 들어 demo-ticket 유형의 기본 키 속성이 ticketId라면 다음과 같이 지정합니다.
{"typeId":"demo-ticket","primaryKey":{"ticketId":"TICKET-123"}}
객체 매개변수가 여러 입력을 지원하면 locator 객체 배열을 사용합니다. 다음 구성에서 두 번째 티켓의 설명용 값은 TICKET-456입니다.
[
{"typeId":"demo-ticket","primaryKey":{"ticketId":"TICKET-123"}},
{"typeId":"demo-ticket","primaryKey":{"ticketId":"TICKET-456"}}
]
locator는 어느 객체를 대상으로 할지 식별하며 속성값을 바꾸는 규칙은 아닙니다. 예를 들어 Priority 매개변수가 P0, P1, P2를 받는 액션에서 Ticket에 locator를, Priority에 P0를 넣으면 액션의 수정 규칙이 해당 티켓의 Priority 속성에 P0를 기록합니다.
날짜와 타임스탬프
Date는 ISO 8601을 사용하며 1990-01-12 같은 YYYY-MM-DD 값이 가능합니다. Timestamp는 1990-01-12T23:00:00.000Z 같은 ISO 8601 값을 사용합니다. 표현 형식은 YYYY-MM-DD[T]HH:mm:ss.SSS[Z]입니다.