가이드

Print (출력) 노드 가이드

작성일 2026.03.20 | 수정일 2026.03.20

Print (출력) 노드 가이드

이전 노드에서 전달받은 입력 데이터를 확인하고 출력하는 노드입니다. 워크플로우 개발 및 디버깅 시 데이터 흐름을 확인하는 데 유용합니다.

주요 기능

  • 입력 데이터를 그대로 통과시키면서 내용 확인

  • 모든 데이터 출력 또는 요약 정보만 출력

  • 커스텀 텍스트/JSON 데이터 추가 가능

  • 서버 콘솔 로깅 (선택)

설정 항목

기본 설정

필드

설명

기본값

출력 모드

데이터 출력 방식을 선택합니다

모든 데이터

커스텀 데이터 추가

추가로 출력할 커스텀 데이터 입력 여부

false

콘솔 로깅

서버 콘솔에도 데이터를 출력할지 여부

true

접두어

콘솔 로그에 표시될 접두어

[Print]

출력 모드

모드

설명

모든 데이터

입력된 모든 JSON 및 바이너리 데이터를 그대로 출력합니다. 다음 노드에도 원본 데이터가 전달됩니다

요약 정보

데이터 개수, JSON 키 목록, 각 필드의 타입, 바이너리 정보 등 구조 정보만 출력합니다

커스텀 데이터 설정

필드

설명

커스텀 데이터 형식

텍스트 또는 JSON 선택

커스텀 텍스트

출력할 텍스트를 입력합니다. {{ $json.fieldName }} 표현식 사용 가능

커스텀 JSON

출력할 JSON 데이터를 입력합니다. 표현식 사용 가능

사용 예시

데이터 흐름 디버깅

워크플로우 중간에 삽입하여 현재 데이터 상태를 확인합니다.

[API 호출] → [Print] → [데이터 가공] → [Print] → [최종 처리]

설정:

  • 출력 모드: 모든 데이터

  • 콘솔 로깅: true

  • 접두어: [API 응답 확인]

요약 정보로 구조 파악

대용량 데이터의 구조만 빠르게 확인합니다.

설정:

  • 출력 모드: 요약 정보

요약 정보 출력 예시:

{
  "itemIndex": 0,
  "totalItems": 5,
  "jsonKeys": ["id", "name", "email", "items"],
  "jsonKeysCount": 4,
  "jsonTypes": {
    "id": "number",
    "name": "string",
    "email": "string",
    "items": "array"
  }
}

커스텀 텍스트 추가

데이터에 설명 텍스트를 추가하여 확인합니다.

설정:

  • 커스텀 데이터 추가: true

  • 커스텀 데이터 형식: 텍스트

  • 커스텀 텍스트: 처리 대상: {{ $json.name }}, 상태: {{ $json.status }}

출력 데이터에 _customText 필드가 추가됩니다.

커스텀 JSON 추가

JSON 형식의 부가 데이터를 추가합니다.

설정:

  • 커스텀 데이터 추가: true

  • 커스텀 데이터 형식: JSON

  • 커스텀 JSON:

{
  "checkpoint": "step-3",
  "processedBy": "{{ $json.handler }}"
}

출력 데이터에 _customData 필드가 추가됩니다.

참고 사항

  • 모든 데이터 모드에서는 입력 데이터가 그대로 다음 노드로 전달되므로, 워크플로우 흐름에 영향을 주지 않고 중간에 삽입할 수 있습니다.

  • 요약 정보 모드에서는 원본 데이터 대신 구조 정보가 출력됩니다. 이 모드는 디버깅 전용으로 사용하고, 데이터가 필요한 후속 노드가 있다면 모든 데이터 모드를 사용하세요.

  • 커스텀 텍스트 추가 시 _customText, 커스텀 JSON 추가 시 _customData 필드명으로 원본 데이터에 병합됩니다.

  • 콘솔 로깅을 비활성화하면 서버 콘솔 출력 없이 데이터만 전달됩니다.