가이드

Set (세트) 노드 가이드

작성일 2026.03.20 | 수정일 2026.03.20

Set (세트) 노드 가이드

데이터 필드를 설정하거나 수정하는 노드입니다. 새로운 필드를 추가하거나, 기존 필드를 업데이트하거나, 필요한 필드만 선별하여 데이터 구조를 정리할 수 있습니다.

주요 기능

  • 필요한 필드만 유지하고 나머지 제거 (데이터 정리)

  • 기존 데이터에 새 필드 추가 또는 기존 필드 값 업데이트

  • 여러 입력 아이템을 하나의 배열로 집계

  • 표현식({{ $json.field }})을 사용한 동적 값 설정

  • 중첩 객체 필드 설정 (dot notation)

설정 항목

모드

모드

설명

설정한 필드만 유지

아래에서 정의한 필드만 출력하고 나머지 필드는 모두 제거합니다

추가 또는 업데이트

기존 입력 데이터를 유지하면서 새 필드를 추가하거나 기존 필드 값을 업데이트합니다

배열로 집계

모든 입력 아이템을 items 배열 하나로 묶어 단일 아이템으로 출력합니다

설정할 필드

필드

설명

예시

이름

설정할 필드의 이름 (dot notation으로 중첩 객체 지원)

userName, meta.tag

필드에 설정할 값 (표현식 사용 가능)

고정값, {{ $json.name }}

사용 예시

필요한 필드만 추출

API 응답에서 필요한 필드만 선별합니다.

입력:

{ "id": 1, "name": "홍길동", "email": "hong@test.com", "내부코드": "X123", "비밀번호": "***" }

설정:

  • 모드: 설정한 필드만 유지

  • 필드 1: 이름 id, 값 {{ $json.id }}

  • 필드 2: 이름 name, 값 {{ $json.name }}

  • 필드 3: 이름 email, 값 {{ $json.email }}

출력:

{ "id": 1, "name": "홍길동", "email": "hong@test.com" }

기존 데이터에 필드 추가

기존 데이터를 유지하면서 가공된 필드를 추가합니다.

설정:

  • 모드: 추가 또는 업데이트

  • 필드 1: 이름 fullName, 값 {{ $json.firstName + " " + $json.lastName }}

  • 필드 2: 이름 processedAt, 값 {{ new Date().toISOString() }}

중첩 객체 필드 설정

dot notation으로 중첩된 구조의 필드를 설정합니다.

설정:

  • 필드: 이름 meta.source, 값 workflow

출력:

{ "meta": { "source": "workflow" } }

배열로 집계

여러 아이템을 하나의 배열로 묶습니다.

입력 (3개 아이템):

{ "name": "A" }
{ "name": "B" }
{ "name": "C" }

설정:

  • 모드: 배열로 집계

출력 (1개 아이템):

{ "items": [{ "name": "A" }, { "name": "B" }, { "name": "C" }] }

표현식 참조

표현식

설명

{{ $json.fieldName }}

현재 아이템의 필드 값 참조

{{ $json }}

현재 아이템의 전체 JSON 데이터

{{ $json.items[0] }}

배열 인덱스 접근

{{ $input.all() }}

모든 입력 아이템을 배열로 반환

{{ $item(0) }}

특정 인덱스의 입력 아이템 참조

참고 사항

  • 설정한 필드만 유지 모드는 데이터를 정리하거나 민감한 정보를 제거할 때 유용합니다.

  • 표현식 안에서 JavaScript 코드를 사용할 수 있습니다 (예: 문자열 연결, 날짜 생성 등).

  • 배열로 집계 모드는 여러 아이템을 하나로 합쳐야 할 때 사용합니다. 결과는 항상 items 필드에 배열로 저장됩니다.

  • 필드 이름에 dot(.)을 사용하면 자동으로 중첩 객체가 생성됩니다.