OSDK 기반 React 애플리케이션
Developer Console에서 React 사용자 인터페이스를 만들고 온톨로지 SDK(Ontology SDK, OSDK)로 Foundry의 객체 조회와 편집 기능을 호출할 수 있습니다. 화면 구성은 React에서 담당하고, 데이터 접근과 변경은 온톨로지의 권한 통제를 따릅니다.
개발 과정
- Developer Console 애플리케이션을 만듭니다.
- 개발 환경에서 코드를 작성하고 릴리스를 배포합니다.
- 작업 공간이나 패키지 설치에 문제가 생기면 문제 해결을 확인합니다.
플랫폼 안에서는 VS Code 작업 공간을 사용할 수 있습니다. 이 작업 공간은 Code Workspaces 인프라를 사용합니다. 로컬 편집기를 쓰거나 저장소를 플랫폼 밖에서 관리하는 경우에도 Developer Console의 웹 호스팅을 사용할 수 있습니다.
데이터와 화면 라이브러리
- @osdk/react는 타입이 있는 훅과 공유 캐시를 제공합니다. 객체, 액션, 함수와 연결한 화면에서 데이터와 요청 상태를 관리합니다.
- @osdk/react-components는 객체 표, 필터, 액션 폼, 미디어 뷰어 같은 구성 요소를 제공합니다. 데이터 처리는
@osdk/react를 사용하며, 직접 만든 React 컴포넌트와 함께 사용할 수 있습니다.
OSDK는 React나 TypeScript에만 한정되지 않습니다. TypeScript에는 npm 패키지, Python에는 pip와 Conda 패키지, Java에는 Maven 패키지를 제공하며 다른 언어에는 OpenAPI 명세를 사용할 수 있습니다. 언어별 시작점은 OSDK 개요, 서버 TypeScript, Python에 있습니다.
앱과 사용자가 데이터에 접근하는 조건은 Developer Console 권한을 따릅니다. 화면에서 기능을 제공하더라도 해당 데이터와 액션에 대한 권한이 필요합니다.
예제 활용
플랫폼의 Examples 또는 Developer Console 홈에서 OSDK 예제를 설치할 수 있습니다.
| 예제 | 다루는 내용 |
|---|---|
| Getting started with Ontology SDK (OSDK): Build a to-do application | 개발 환경 준비부터 작업 목록 앱 배포까지의 기본 과정 |
| Ontology SDK (OSDK) with AIP Logic: Build a to-do application powered by AIP Logic | React나 Python에서 AIP Logic 함수를 호출하는 작업 목록 앱 |
| Create custom Workshop widgets using the Ontology SDK (OSDK) | 웹 호스팅한 React 앱을 Workshop Iframe 위젯에 삽입하고 양방향으로 상태를 전달하는 방식 |
| Advanced to-do application with the Ontology SDK (OSDK) | 인터페이스, 미디어 집합, 파생 속성, 구독과 사용자 정보 처리를 사용하는 작업 목록 앱 |
Iframe 방식의 연결은 Workshop Iframe에서 다룹니다. 별도 위젯 집합을 사용하는 방식은 Custom Widgets에서 다룹니다.