Flow result를 Report 위치에 표시하기
용도
strength.show(...)는 strength = report.connect_flow(...)로 받은 Connected Flow handle의 메서드입니다. Flow 밖으로 공개한 result를 Report의 결과 위치에 표시하도록 연결합니다.
Report Workbench에서 보이는 것
Report Workbench의 Show result와 같은 작업입니다. Flow public result와 표시할 Report 위치가 연결 편집기에 함께 표시되고, 완료된 Run의 immutable Result가 slot에 나타납니다.
문법
python
strength.show(
mapping_key,
source,
*,
at,
fields=None,
row_key=None,
)예제
python
from pipelinexlab import px
from project_flows.girder_check import flow
report = px.Report("girder_report", title="Girder review")
summary = report.section("check_summary", title="Check result")
utilization_slot = summary.result_slot(
"utilization",
label="Utilization",
)
strength = report.connect_flow("strength_check", flow)
strength.show(
"utilization_result",
flow.results.utilization,
at=utilization_slot,
)매개변수
| 이름 | 설명 |
|---|---|
mapping_key | 이 connection에서 result mapping을 계속 찾는 stable lower_snake_case key |
source | 표시할 Flow result. flow.results.<result_key>로 선택 |
at | .result_slot(), .result_table() 또는 .artifact_slot()이 반환한 Report result 위치 handle |
fields | Record/Table result field → Report target field의 명시적 key mapping |
row_key | Table result row key → Report result table row key의 명시적 mapping |
반환
호출 결과는 connection의 result 연결에 반영됩니다. 표시할 계산 Result는 client.run(...)이 완료된 뒤 해당 slot에서 읽습니다.
규칙
- 한 Flow public result를 같은 Report의 여러 slot에 표시할 수 있습니다.
- 각 표시 위치에는 별도
mapping_key를 사용하며 key는 connection의 input/result mapping 전체에서 유일합니다. - 한 결과 위치에는 Flow result 하나를 연결합니다.
- Record/Table result는 field와 row key를 이름 또는 순서로 추측하지 않습니다.
- 표시값은 Run이 저장한 Result와 실행 근거를 참조하며 사용자가 직접 입력한 값과 구분됩니다.
- Report 원본, mapping 또는 Flow revision이 바뀌면 slot은 새 실행이 필요한 상태를 표시합니다.
- 연결 작성은 계산 Run을 시작하지 않습니다.