앱 간 명령 구성
명령(Command)은 앱이 제공하는 클라이언트 측 작업의 실행 단위입니다. 해당 앱, 다른 앱, 작업공간 구성 요소 또는 AIP Chatbot이 실행할 수 있습니다. 사용자가 화면에서 하던 작업을 앱이 선언한 명령으로 연결합니다.
Workshop에서 삽입한 앱을 조작하거나 AIP Chatbot 도구, Notepad inline 명령으로 사용할 수 있습니다. Commands는 App Pairing과 함께 사용하거나 별도로 구성할 수 있습니다.
실행 진입점
| 위젯 | 시작 조건 |
|---|---|
| Button Group | 버튼의 On click |
| Metric Card | Interactive metric 선택 |
| App Pairing | Listener로 지정한 변수 갱신 |
Button Group
- 위젯을 추가하고 Widget setup의 Button configuration에서 Button 1을 선택합니다.
- Text에 이름을, Description에 마우스를 올릴 때 보여 줄 설명을 적습니다.
- 필요한 Color, Left icon과 Right icon을 정합니다. 명령에 연결한 아이콘이 있으면 색과 아이콘을 기본으로 채웁니다.
Conditional visibility를 켜고 Boolean 변수를 연결하면 State if false가 그 값이 false일 때 버튼을 숨길지 비활성화할지를 정합니다.
- On click에서 Command를 선택합니다.
- Add command > Browse all commands...를 열어 명령을 검색하고 Select합니다. Draw polygon 같은 명령을 선택하면 오른쪽에서 사용 설명을 볼 수 있습니다.
- Parameters defaults에서 Fill color나 Fill pattern 같은 선택 매개변수를 정합니다.
- Specify target app을 정합니다. 기본은 Paired app입니다. 여러 앱이 pairing되어 있으면 실행 시 대상을 선택하라는 안내가 나타납니다. Gaia 예에서는 New map 또는 Open existing map...으로 새 지도나 기존 지도를 지정할 수 있습니다.
- 필요하면 명령 출력을 새 또는 기존 Workshop 변수에 연결합니다.
명령 체인
Output variables 아래 Add command로 여러 명령을 추가합니다. 추가한 순서로 실행하며 앞 명령의 출력을 뒤 명령 입력으로 전달할 수 있습니다.
체인 안의 명령은 모두 Gaia 또는 Graph처럼 같은 source application에서 온 명령이어야 합니다. 명령 하나가 실패해도 체인 전체를 중단하지 않고 다음 명령을 계속 실행합니다. 전체 체인을 원자적인 작업으로 간주하지 않습니다.
입력 확인 대화상자
| Prompt command input dialog 옵션 | 동작 |
|---|---|
| Always prompt | 실행할 때마다 입력 확인/수정 양식 표시 |
| Never prompt, skip if missing required inputs | 양식을 표시하지 않음. 필요한 입력이 없거나 유효하지 않으면 그 명령을 건너뛰고 다음 명령 실행. App Pairing 체인의 기본값 |
| Prompt missing any inputs | 필수 또는 선택 입력 중 하나라도 빠지면 양식 표시 |
| Only prompt when missing required inputs | 필수 입력이 빠졌을 때만 표시. Button Group 체인의 기본값 |
완료 뒤 On completion of command(s)에서 Workshop 이벤트 또는 온톨로지 액션을 실행하도록 구성할 수 있습니다.
Metric Card
Metric configuration의 Metric 1에서 Interactive metric을 Command로 선택합니다. 이후 명령 검색, 기본 매개변수, 대상 앱과 출력 변수는 위 흐름과 같습니다. 사용자가 해당 지표를 선택하면 실행하며 명령 체인과 완료 동작도 구성할 수 있습니다.
App Pairing의 변수 Listener
- 위젯의 Trigger commands on variable update에서 Add command trigger를 선택합니다.
- Listener에 실행 계기가 될 변수를 지정합니다.
- 선택적으로 Boolean Conditional trigger를 지정합니다. false이면 실행을 건너뜁니다.
- Add command로 명령 또는 같은 앱의 명령 체인을 구성합니다.
명령은 Listener 변수가 바뀌면 즉시 시작합니다. 파생 변수 값을 사용한다면 그 파생 변수 자체를 Listener로 지정하여 갱신 전의 값을 보내지 않도록 합니다.
구성을 마치면 Save and publish합니다. 지도나 연결 앱을 변경하는 명령과 완료 후 실행하는 액션의 효과를 확인한 뒤 게시합니다.