Project Home에서 Report와 Flow 열기
Project는 Report, Flow와 실행 결과를 함께 담는 작업 공간이고, Project Home은 그 안의 항목을 찾는 시작 화면입니다. 문서를 작성할 때는 Report, 계산 흐름을 구성할 때는 PXFLOW를 엽니다.
현재 installed Component 범위
Project-scoped package 설치와 dependency 관리 화면은 계획 범위입니다. 현재 production Flow reader는 Component의 exact target, raw settings와 usage-derived 일부 port를 보존한 read-only unsupported Node를 표시합니다. 향후 다중 선언과 host presentation은 Node presentation과 third-party UI의 contract_only V2가 소유합니다.
두 화면은 같은 Project 안에서 동작합니다. Report Workbench는 Report 위치와 Flow public port의 연결을 편집하고, PXFLOW Studio는 Flow의 Node와 내부 연결을 편집합니다.
Project 만들거나 열기
- 로그인 뒤 My projects를 엽니다.
- 기존 Project를 선택하거나 New project로 이름과 설명을 입력합니다.
- 조직이 제공한 예제로 시작할 때는 예제 Project를 선택합니다.
- Project Home에서 현재 Project 이름과 자신의 권한을 확인합니다.
- 예제에 필요한 Function을 Definitions에서 확인합니다. 계획된 Component dependency 동선은 향후 Project dependencies가 소유합니다.
Project를 만들 권한이 없으면 조직 관리자가 공유한 Project를 열거나 접근 권한을 요청합니다.
Project Home 화면
| UI 위치 | 여기서 하는 일 | 열리는 화면 |
|---|---|---|
| My projects | 작업할 Project 선택 | Project Home |
| Report | Report 새로 만들기, 검색, 최근 문서 열기 | Report Workbench |
| PXFLOW | Flow 새로 만들기, 검색, 최근 Flow 열기 | PXFLOW Studio |
| Activity / Results | 현재 Project의 Run과 완료된 Result 확인 | Project Activity 또는 Result detail |
| Project dependencies · 계획 | Project에서 사용할 Component package 설치·업데이트 | Project dependencies |
| Project settings | 멤버, 권한, Local·Cloud와 공유 범위 확인 | Project settings |
Project Home의 Report와 PXFLOW 목록은 각각 원본 작업 항목을 보여 줍니다. 최근 항목을 선택하면 마지막으로 저장한 상태(revision)를 엽니다. 새 항목을 만들 때는 화면에 보일 이름과 함께, 다른 문서·코드가 이 항목을 가리킬 때 쓰는 고유 key를 확인합니다.
Report Workbench
Report를 열면 문서 작성에 필요한 화면이 바로 표시됩니다.
| 영역 | 여는 방법 | 여기서 하는 일 |
|---|---|---|
| Report 본문 | Report를 열면 표시 | 텍스트, 값, 표와 결과 위치 작성 |
| Outline | 상단 Outline | Section과 문서 위치 이동 |
| Connections | 상단 Connections | @ 연결 표시 켜기·숨기기 |
| @ Insert | 상단 @ Insert 또는 본문에서 @ 입력 | Report 값 → Flow input, Flow result → Report 위치 연결 |
| Project Activity | 오른쪽 activity 동작 | 연결된 Flow Run과 Result 상태 확인 |
| Report + PDF | 상단 화면 전환 | PDF를 Report 옆에 열어 비교·번역 |
Report Workbench 화면과 첫 연결 순서 보기
PXFLOW Studio
PXFLOW를 열면 Flow Canvas가 중심에 표시됩니다.
| 영역 | 여는 방법 | 여기서 하는 일 |
|---|---|---|
| Canvas | Flow를 열면 표시 | Node 배치, port 연결과 전체 Flow 확인 |
| Definitions | 메인 바의 Definitions | 공유 Function 목록, source·contract·사용처 확인 |
| Components dock · 계획 | 화면 아래 Components 펼치기 | 향후 installed Component 검색·배치 |
| Node 상세 | Node 더블클릭 | 연결·typed port·참조 계약 확인; 현재 Component target은 read-only unsupported, settings UI와 전용 editor는 계획 |
| 외부에 공개한 input/result | Flow 경계 | Report나 다른 화면에서 연결할 값의 type과 단위 정의 |
| Run·Result | Validate·Save 뒤 Run | 진행 상태, Result와 생성 근거 확인 |
PXFLOW Studio의 Canvas와 Node 편집 위치 보기
Report에서 PXFLOW Studio 열기
Report의 @ 표시나 result block을 더블클릭하면 연결 편집기가 열립니다.
- Overview에서 Report 위치부터 Flow public port까지의 경로를 확인합니다.
- 읽기 전용 Flow 보기에서 연결된 Node와 port를 찾습니다.
- Open in PXFLOW Studio를 선택합니다.
- 전체 Flow 화면에서 Node와 내부 연결을 편집합니다.
- Validate와 Save로 새 Flow revision을 만듭니다.
- Report Workbench로 돌아와 Review update를 엽니다. 바뀐 Flow revision과 기존 연결을 비교해 보여 주므로, 확인한 뒤 Apply로 새 revision을 사용합니다.
Report 안에서 Flow handoff 화면을 보고 있을 때는 Open standalone이 전체 PXFLOW Studio를 엽니다. Report의 연결 위치를 바꿀 때는 Report Workbench의 Connection 탭으로 돌아옵니다.
PXFLOW Studio에서 Report 연결 영향 확인하기
Report에서 사용 중인 public input/result를 변경하면 PXFLOW Studio가 Used by Reports와 영향받는 Report 연결을 보여 줍니다.
- 변경할 public port를 선택합니다.
- 연결된 Report와 type·unit·값의 형태 차이를 확인합니다.
- 새 key로 교체할지, 기존 key를 유지할지 결정합니다.
- 영향 계획을 적용하고 새 Flow revision을 저장합니다.
- 각 Report에서 Review update로 사용할 revision을 확인합니다.
이 경로를 통해 Flow 구조와 Report 문서 위치를 각 소유 화면에서 편집하면서 변경 영향은 한 번에 확인할 수 있습니다.
새 작업을 시작할 때 선택하기
| 목표 | 먼저 열 화면 | 이어서 할 일 |
|---|---|---|
| 계산 설명과 입력표부터 작성 | Report | @ Insert로 기존 Flow public input 연결 |
| 계산 로직부터 구성 | PXFLOW | public input/result 저장 뒤 Report에서 연결 |
| 기존 계산 결과를 문서에 표시 | Report | @ Insert → PXFLOW → Show result |
| Node와 연결 수정 | PXFLOW | Validate·Save 뒤 Report에서 Review update |
| 여러 계산 상태 확인 | Activity / Results | 해당 Report 또는 Flow 열기 |
Report와 Flow 중 어느 화면에서 시작해도 저장된 public port 계약으로 연결됩니다.
Project context 유지하기
- 상단 경로 표시(breadcrumb)에서 Project 이름을 선택하면 Project Home으로 돌아갑니다.
- Report 또는 Flow 이름을 선택하면 같은 종류의 항목 목록을 엽니다.
- 다른 Project의 Flow를 연결할 때는 Connection 화면에서 Project를 명시적으로 선택합니다.
- Report Workbench와 PXFLOW Studio를 오가도 선택한 Project와 revision이 breadcrumb에 표시됩니다.