제품 연결과 화면 위치

Report Workbench는 Report 본문·작성값·Flow 연결·결과 위치를 다룹니다. SDK와 PXFLOW Studio는 그 연결이 가리키는 Flow의 public port, Node와 내부 연결을 다룹니다.

현재 installed Component 범위

현재 production Flow reader는 installed Component의 exact target, raw settings와 usage-derived 일부 port를 보존한 read-only unsupported Node를 표시합니다. Project dependency 설치, Components dock, settings UI와 전용 editor는 계획 범위입니다. 향후 다중 선언과 host presentation은 Node presentation과 third-party UI의 contract_only V2가 소유합니다.

Report와 Flow는 Project 안의 나란한 문서입니다. Workbench 또는 SDK로 작성한 Report 값을 Flow input에 연결하고, SDK 또는 Studio에서 구성한 Flow의 Result를 Report 위치에 표시할 수 있습니다.

화면별 역할

화면	어디서 여나요?	여기서 하는 일
Project Home	로그인 뒤 첫 화면	Project의 Report와 Flow를 찾고 각 Workbench로 이동
Report Workbench	Project Home → Report	Report 작성, connected input·table → Flow input, Flow result → Report 위치 연결·실행
PXFLOW Studio	Project Home → PXFLOW	Node 배치·연결·Validate·Save·Run
Definitions	PXFLOW Studio 메인 바 → Definitions	공유 Function과 사용처 확인·배치
Components · 계획	PXFLOW Studio 하단 Components	installed·third-party Component를 찾아 Canvas에 배치하는 목표 동선
Run·Result	PXFLOW Studio 또는 Report Workbench의 Run, Project Activity	실행 상태, 값, 근거와 복구 동작 확인

화면 사이를 이동하는 동작

시작 화면	사용자 동작	화면에서 확인할 결과
Report Workbench	빈 caret 또는 text·number 선택 → @ Insert → PXFLOW → Use report input	connected input·table과 Flow input binding이 함께 생김
Report Workbench	결과 위치 → @ Insert → PXFLOW → Show result	Run Result를 표시할 위치가 생김
Report Workbench	Report 저장 → Connected Flow Run	저장된 mapping으로 Flow Run이 시작됨
Report 연결 Overview	Open in PXFLOW Studio	연결된 Flow를 Studio에서 열고 내부 경로를 편집
Definitions → Functions	Function을 골라 Place Node	Function Reference Node가 Canvas에 생김
Components · 계획	Component에서 Add	해당 Component의 Node를 Canvas에 배치하는 목표 동선
PXFLOW Studio Canvas	앞 Node result를 다음 Node input으로 드래그	typed 연결이 생기고 Validate 상태가 표시됨
Component Node · 계획	Node 더블클릭	Node settings 또는 Component 전용 편집기를 여는 목표 동선
PXFLOW	Validate → Save → Run	Run 상태와 새 Result가 표시됨

Function은 Place Node로 현재 Flow에 배치합니다. installed Component를 Add로 배치하는 동선은 계획이며, 현재 Component target은 read-only unsupported Node로 열립니다.

Report와 Flow를 함께 사용하는 순서

Report와 Flow 연결Report에서 작성한 값을 Flow에 보내고 Result를 다시 Report에 표시합니다.

1. 1Flow 준비Studio 또는 SDK에서 Validate·Save
2. 2Report 작성본문·값·표·결과 위치 작성
3. 3input 연결Use report input
4. 4result 연결Show result
5. 5Report 저장·Run선택한 Connected Flow 실행
6. 6Result 확인Report 위치와 Activity에서 확인

Report 문서가 input·result mapping을 소유하고, Flow 문서가 내부 Node 연결을 소유합니다. Workbench와 Python SDK는 같은 문서를 편집합니다.

1. 사용할 Flow 준비하기

기존 Flow를 선택하거나 PXFLOW Studio 또는 Python SDK에서 Flow를 만듭니다. Report에서 연결할 input과 result를 공개하고 Validate → Save로 사용할 Flow revision을 준비합니다.

2. Report 작성하기

Project Home에서 Report를 열고 본문, 계산에 사용할 값과 결과가 표시될 위치를 작성합니다. 새 table input을 연결할 위치에는 빈 문단을 준비합니다.

3. input과 result 연결하기

새 input이나 connected table은 빈 caret에서 @ Insert → PXFLOW를 열고 Project, Flow와 public input을 고른 뒤 Use report input을 확정해 만듭니다. 기존 text나 number를 초기값으로 사용할 때만 해당 내용을 먼저 선택합니다. 기존 ordinary 표 범위를 직접 승격하는 경로는 계획 단계이며, 새 connected table의 field·row mapping은 Connection → Table mapping에서 편집합니다. 결과 위치에서는 같은 메뉴의 Show result로 Flow result를 고릅니다.

4. 필요할 때 Flow 편집하기

Flow 계산 구조를 확인하거나 바꿀 때만 연결 Overview의 Open in PXFLOW Studio를 선택합니다. 공유 계산은 Definitions → Functions에서 고릅니다. 설치형 기능을 Components → Installed에서 고르는 동선은 계획입니다. 변경했다면 다시 Validate → Save한 뒤 Report에서 Review update를 확인합니다.

5. Report 저장하고 Connected Flow 실행하기

연결 편집기의 Apply로 변경을 반영하고 Report를 Save합니다. 그런 다음 실행할 Connected Flow에서 Run을 선택합니다. 여러 connection을 골랐다면 Run selected가 각 connection의 독립 Run을 시작합니다.

6. Result 확인하기

Project Activity에서 Run 상태를 확인합니다. 완료된 Result는 앞에서 고른 Report 위치에 값·표·artifact 형태로 표시되며 직접 덮어쓰지 않습니다. 입력이나 Flow가 바뀌면 Stale을 확인하고 Run again으로 갱신합니다.

원본과 화면 표시 구분

화면에서 보이는 것	실제로 바꾸는 위치
Report authored value와 Flow input mapping	Report Workbench의 연결 modal
Flow result를 표시하는 Report 위치	Report Workbench의 result projection 설정
Project Function Reference Node의 읽기 전용 source	Open Function → Definitions에서 사용처·영향 확인 후 Function 편집
현재 Node만 다른 계산을 사용	Duplicate / Branch Function 후 해당 Node의 target 교체
설치한 Component Node	현재 exact target·raw settings·usage-derived 일부 port를 read-only unsupported로 표시
Component 전용 editor·viewer · 계획	향후 해당 Component Node의 Open editor / Open viewer
Component artifact 미리 보기	upstream input·Node·setting을 변경하고 다시 Run해 새 결과 생성

개발자·운영자 참고

core 실행 객체와 Extension-owned 객체를 각각의 소유 계층으로 구분합니다.

범위	기술 객체 예
Report	ReportDocument, ReportFlowConnection, semantic value/table address
Core SDK·PXFLOW	FunctionDescriptor, ComponentDescriptor, FlowDocument, FlowGroup
Core Runtime	Run, ResultSnapshot, Diagnostic
설치한 Extension · 계획	향후 package가 정의할 setting schema, editor·viewer와 artifact 계약

core 객체 표에는 공통 core 객체를 담고, Extension-owned 객체의 정확한 schema는 해당 Extension 문서에서 안내합니다.

문제가 생겼을 때

1. Validate에서 표시한 Node와 input을 먼저 확인합니다.
2. Report 연결이 Incompatible이면 Report source와 public Flow input의 type·unit·shape를 확인합니다.
3. Component Node의 unsupported 진단에서는 보존된 exact target과 raw settings를 확인합니다.
4. Result가 Stale이면 Flow를 저장하고 다시 Run합니다.

자세한 복구 방법은 실행·결과·오류 복구를 참고하세요.