App Pairing으로 앱 상태 연결

App Pairing은 지원 앱의 선택 및 열린 데이터 상태를 연결합니다. Workshop 모듈을 Gaia, Graph 또는 Vertex와 연결할 수 있으며, AIP Chatbot의 명령 도구나 Notepad의 inline command와 함께 사용할 수도 있습니다. 앱 상태 동기화와 온톨로지 데이터를 수정하는 액션은 구분합니다.

Graph와 Workshop이 같은 객체 선택 상태를 공유하는 예

Workshop 위젯 추가

Workshop의 새 모듈 또는 기존 모듈에 App Pairing 위젯을 넣습니다. 위젯이 보이는 동안 동작하므로 항상 보이는 모듈 헤더에 두는 것이 좋습니다.

다른 앱이 식별하고 발견할 수 있도록 사용자에게 보이는 이름을 지정해야 합니다. 나머지 고급 설정은 선택 사항입니다.

공유 상태 변수

Widget setup에서 Selection 또는 Open data 상태를 구성합니다.

상태	공유하는 내용	방향과 범위
Selection	선택한 객체와 해당 메타데이터	연결 앱의 선택이 Workshop 변수를 갱신하고 Workshop 변수 변경도 연결 앱으로 전송
Open data	앱에서 열어 둔 데이터	Graph만 지원. 연결한 Graph에 객체 10개가 열려 있으면 pairing 시 그 10개를 Workshop에 반영

Selection과 Open data 변수를 연결하는 설정

기본으로 선택 객체 변수가 미리 구성됩니다. Gaia 또는 Graph와 pairing하면 그 앱에서 현재 선택한 객체를 기록합니다. Add Variable로 필요한 종류의 Selection 또는 Open data 변수를 여러 개 추가할 수 있습니다.

연결과 해제

연결할 지원 앱을 열면 App Pairing 메뉴의 Discovered에 나타납니다. Pair를 선택하면 Paired로 이동하고 공유 상태가 갱신됩니다.

지원 앱을 찾지 못하면 발견한 앱이 없다는 안내를 표시합니다.

연결 가능한 지원 앱을 발견하지 못한 안내

Iframe 위젯으로 연동을 지원하는 앱을 삽입한 경우 자동 발견과 pairing을 사용할 수 있습니다. 임의의 외부 사이트가 iframe 안에 있다는 사실만으로 상태 공유 기능을 갖는 것은 아닙니다.

연결을 해제하려면 위젯 메뉴의 Paired 앱을 선택하고 Unpair합니다.

연결한 앱을 선택해 Unpair하는 메뉴

표시와 알림

설정	동작
Display name	다른 앱이 발견할 때 사용하는 이름. 기본은 Workshop 앱 이름
Auto open mode: Disabled	기본값. 선택할 때만 메뉴 표시
Enabled	처음과 pairing 변경 때 표시
Only initially	앱을 처음 로드할 때만 표시
Only on pairing change	현재 pairing이 바뀔 때마다 표시
Enable toasts	기본으로 꺼짐. 다른 앱이 연결되었을 때 알림을 켤 수 있음
Enable toggle to pause updates	기본으로 꺼짐. 상태 송수신을 일시 중지/재개하는 제어 제공

오류와 문제 해결 안내 toast는 Enable toasts를 꺼도 표시합니다. 상태 갱신을 재개하면 최신 상태로 동기화합니다.

변수 변경으로 명령을 실행하려면 Trigger commands on variable update를 사용합니다. 명령 구성에서 Listener와 실행 조건을 정합니다.

사용자 정의 상태

기본 상태 유형이 맞지 않으면 Shared state variables에서 Custom을 추가하고 Media type string에 서로 교환할 미디어 유형을 지정합니다.

사용자 정의 공유 상태 변수 추가

지원 Workshop 변수 타입은 Boolean, Date, Numeric, Numeric array, String과 String array입니다.

사용자 정의 상태와 Workshop 변수 타입 연결

양쪽 앱이 같은 미디어 유형과 값 계약을 구현해야 새 연동에서도 그 상태를 사용할 수 있습니다.

보강과 Scope Id

Advanced의 Disable data enrichment는 두 앱의 상태 페이로드가 직접 호환되는 경우에 사용합니다. Graph의 Object Synonym RIDs set을 Workshop과 동기화하려면 보강이 필요합니다. 동기화한 artifact와 객체 표현 사이를 변환하는 흐름도 보강을 유지해야 할 수 있습니다.

서로 호환되는 상태에 한해 데이터 보강을 끄는 설정

직접 pairing 범위를 조정하려면 Workshop이 생성한 Scope Id 변수를 사용합니다. 같은 scope에 들어온 앱과 위젯을 연결합니다. Workshop 위젯에는 해당 변수를 연결하고, 다른 앱의 URL에는 appPairingScopeId query parameter로 값을 전달합니다.

이미 query가 있는 URL에는 &appPairingScopeId=값, 없는 URL에는 ?appPairingScopeId=값을 사용하고 값을 URL 인코딩합니다. 수동 Pair 또는 Unpair도 scope를 바꾸므로 상태 변경을 함께 처리합니다.

Keyboard shortcuts