Workflow Input
워크플로우의 입구. 외부 API 입력 또는 사용자 정의 노드 호출자의 매개변수를 주입한다.
개요
워크플로우의 공식 진입 인터페이스(Ingress Interface)를 정의한다. 워크플로우를 API 컨테이너로 배포하거나 재사용 가능한 커스텀 노드(서브태스크)로 캡슐화할 때, 이 노드에 선언된 출력 포트들이 외부 호출자가 값을 주입하는 입력 파라미터/포트가 된다.
캔버스에서 단독으로 직접 실행할 때는 각 출력 포트마다 설정한 기본값(또는 난수)을 내보내므로 외부 호출기 없이도 그래프를 바로 시험할 수 있다.
사용 시점
- 커스텀 노드로 저장할 서브 워크플로우의 외부 입력 포트와 타입·길이·범위 제약을 정의할 때 사용한다.
- REST/API 엔드포인트로 배포할 워크플로우의 요청 페이로드 필드를 정의할 때 사용한다.
파라미터 설정
Workflow Input은 속성창에서 각 출력 포트 항목을 추가·편집하여 구성한다. 각 포트마다 이름, 데이터 타입(Bytes, String, Int, Bool), 단독 실행용 기본값(Fixed 또는 Random), 그리고 선택적인 입력 제약(Input Constraints: 허용 바이트 길이 또는 정수 최소/최대 범위)을 설정할 수 있다.
포트 입출력 명세
포트 연결 규칙, 데이터 타입별 색상, 가변 포트 생성 방식은 포트 및 연결 문서를 참고한다.
입력 포트
이 노드는 입력 포트가 없다.
출력 포트
| 항목 | 명세 |
|---|---|
| 포트 성격 | 가변 출력 포트(사용자 정의 인터페이스 스키마) |
| 캔버스 초기 기본값 | 출력 포트 1개(Input 1, ID out_1, 타입 Bytes). |
| 포트 개수 범위 | 출력 포트 1개 이상. |
| 허용 데이터 타입 | Bytes, String, Int, Bool. |
| 포트 추가 및 관리 | 노드 카드나 속성창에서 출력 포트를 추가·삭제·이름 변경·타입 변경·제약 설정할 수 있다. |
| 평가 및 순서 규칙 | 정의된 위→아래 순서대로 외부 커스텀 노드의 입력 포트 및 API 입력 필드로 매핑된다. |
오류 케이스
실행 중 아래 조건이 발생하면 이 노드는 ERROR 상태가 되며, 출력 포트에 연결된 하위 노드는 실행되지 않는다.
| 오류 코드 | 기본 엔진 메시지 | 발생 조건 |
|---|---|---|
INPUT_CONSTRAINT_VIOLATION |
입력 포트 값이 선언한 제약(길이·범위)을 어겼다 | 외부 호출자나 기본값이 해당 포트에 선언된 바이트 길이 또는 정수 범위 제약을 위반했을 때 발생한다. |
활용 예시
커스텀 암호화 노드용 입력 인터페이스 정의하기
32바이트 Key와 가변 길이 Plaintext를 받는 워크플로우 진입점을 구성한다.
- Workflow Input 노드를 배치하고 첫 번째 포트의 이름을
Key(타입Bytes, 길이 제약32)로 설정한다. - 두 번째 포트
Plaintext(타입Bytes)를 추가하고 하위 암호화 노드로 연결한다.