Set (세트) 노드 가이드

데이터 필드를 설정하거나 수정하는 노드입니다. 새로운 필드를 추가하거나, 기존 필드를 업데이트하거나, 필요한 필드만 선별하여 데이터 구조를 정리할 수 있습니다.
주요 기능
필요한 필드만 유지하고 나머지 제거 (데이터 정리)
기존 데이터에 새 필드 추가 또는 기존 필드 값 업데이트
여러 입력 아이템을 하나의 배열로 집계
표현식(
{{ $json.field }})을 사용한 동적 값 설정중첩 객체 필드 설정 (dot notation)
설정 항목
모드
모드 | 설명 |
|---|---|
설정한 필드만 유지 | 아래에서 정의한 필드만 출력하고 나머지 필드는 모두 제거합니다 |
추가 또는 업데이트 | 기존 입력 데이터를 유지하면서 새 필드를 추가하거나 기존 필드 값을 업데이트합니다 |
배열로 집계 | 모든 입력 아이템을 |
설정할 필드
필드 | 설명 | 예시 |
|---|---|---|
이름 | 설정할 필드의 이름 (dot notation으로 중첩 객체 지원) |
|
값 | 필드에 설정할 값 (표현식 사용 가능) |
|
사용 예시
필요한 필드만 추출
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 데이터 |
| 배열 인덱스 접근 |
| 모든 입력 아이템을 배열로 반환 |
| 특정 인덱스의 입력 아이템 참조 |
참고 사항
설정한 필드만 유지모드는 데이터를 정리하거나 민감한 정보를 제거할 때 유용합니다.표현식 안에서 JavaScript 코드를 사용할 수 있습니다 (예: 문자열 연결, 날짜 생성 등).
배열로 집계모드는 여러 아이템을 하나로 합쳐야 할 때 사용합니다. 결과는 항상items필드에 배열로 저장됩니다.필드 이름에 dot(.)을 사용하면 자동으로 중첩 객체가 생성됩니다.