Pilot 사용자 정의 위젯 제작

사용자 정의 위젯은 Workshop 안에서 실행되는 샌드박스 프런트엔드입니다. 독립 서브도메인의 웹앱과 배포 방식이 다르지만 제작은 같은 대화형 과정을 사용합니다.

생성과 입출력

시작 화면에서 Custom widget set을 선택하고 목적을 설명한 뒤 Create widget set을 누릅니다. Pilot이 격리 컨테이너를 만들고 위젯을 생성합니다. 모델, Act/Plan과 문맥 첨부를 앱과 같은 방식으로 사용합니다.

하나의 프로젝트에 여러 위젯을 넣어 하나의 위젯 집합으로 게시할 수 있습니다. Parameters는 Workshop에서 받는 객체 집합, 문자열, 숫자 같은 자료형이 있는 입력입니다. Events는 사용자 상호작용에 따라 Workshop 변수 등을 갱신하도록 위젯이 내보내는 출력입니다. Pilot이 제작 중 이 계약을 정의합니다.

샌드박스와 미리보기

위젯은 어두운 테마를 포함한 Workshop 테마와 자동 크기 규칙을 따릅니다. 브라우저 기능과 외부 네트워크 요청은 제한되며 추가 iframe 기능은 지원되는 속성 설정을 별도로 검토해야 합니다.

Preview는 실제 삽입 때와 같은 위젯 샌드박스를 사용합니다. 크기와 매개변수는 Workshop 배치에 따라 달라집니다. 기본은 로컬 seed data이고 Notional data / Production data로 실제 데이터에 전환할 수 있습니다.

Configure widget에서 대표 입력값을 넣어 확인합니다. 매개변수나 이벤트를 바꾸면 Reload widget dev mode를 선택해야 실행 중인 미리보기에 반영됩니다.

온톨로지와 권한

위젯은 Workshop 열람자의 권한으로 OSDK를 통해 조회하고 씁니다. Ontology 탭에서 기존 정의를 사용하거나 허용된 경우 새 정의를 제안합니다. 위젯 환경이 자체적으로 정의 변경을 제한할 수도 있습니다. 이 편집 설정이 실제 레코드 접근 권한을 부여하지는 않습니다.

운영 미리보기를 켜는 것만으로 레코드를 앱 제작 에이전트에 전달하지 않습니다. 별도 production-data viewer의 분석 공유는 검토를 거칩니다. 다만 운영 미리보기에서 실행한 액션은 실제 레코드를 바꿀 수 있습니다.

코드를 브랜치 제안으로 검토하고 Widget Registry 게시 후 Workshop에 삽입합니다.