가이드
솔라피 시작하기
가이드

If (조건분기) 노드 가이드

작성일 2026.03.20 | 수정일 2026.03.20
If (조건분기) 노드 가이드

조건에 따라 워크플로우의 실행 흐름을 두 갈래로 분기하는 노드입니다. 설정한 조건이 참이면 true 출력으로, 거짓이면 false 출력으로 데이터를 전달합니다.

주요 기능

  • 필드 값 기반 조건 비교 (필드명 방식)

  • 표현식 결과값 직접 비교 (표현식 방식)

  • 다양한 비교 연산자 지원 (같음, 포함, 크기 비교, 존재 여부 등)

  • 여러 조건의 AND/OR 결합

  • 중첩 객체 필드 접근 (dot notation)

출력 구조

출력

설명

true

조건이 참인 아이템이 전달됩니다

false

조건이 거짓인 아이템이 전달됩니다

조건이 하나도 설정되지 않은 경우, 모든 아이템은 true 출력으로 전달됩니다.

설정 항목

조건 타입

타입

설명

필드명 방식

입력 데이터의 특정 필드 값을 가져와 비교합니다

표현식 방식

두 표현식의 결과값을 직접 비교합니다

필드명 방식 설정

필드

설명

예시

필드명

비교할 필드의 이름 (dot notation 지원)

status, user.name

연산자

비교 연산자 선택

같음 (=)

비교 값

비교 대상 값

completed

표현식 방식 설정

필드

설명

예시

비교값 1

첫 번째 표현식

{{ $moment($json.동의일시).diff(moment(), "days") }}

연산자

비교 연산자 선택

크거나 같음 (>=)

비교값 2

두 번째 표현식

0

연산자 목록

연산자

설명

같음 (=)

필드 값이 지정된 값과 같은지 확인 (대소문자 무시)

같지 않음 (≠)

필드 값이 지정된 값과 다른지 확인

포함

문자열에 지정 문자열이 포함되는지 확인 (배열도 지원)

포함하지 않음

문자열에 지정 문자열이 포함되지 않는지 확인

크거나 같음 (>=)

숫자 비교

작거나 같음 (<=)

숫자 비교

큼 (>)

숫자 비교

작음 (<)

숫자 비교

존재함

필드가 null/undefined가 아닌지 확인

존재하지 않음

필드가 null 또는 undefined인지 확인

비어있음

null, undefined, 빈 문자열, 빈 배열, 빈 객체 여부 확인

비어있지 않음

비어있지 않은지 확인

조건 결합

옵션

설명

AND

모든 조건이 참이어야 true로 분기

OR

하나 이상의 조건이 참이면 true로 분기

사용 예시

주문 상태에 따른 분기

주문 데이터의 status 필드가 completed인 경우와 아닌 경우를 나누어 처리합니다.

  • 조건 타입: 필드명 방식

  • 필드명: status

  • 연산자: 같음 (=)

  • 비교 값: completed

중첩 객체 필드 비교

user.age 필드가 18 이상인지 확인합니다.

  • 조건 타입: 필드명 방식

  • 필드명: user.age

  • 연산자: 크거나 같음 (>=)

  • 비교 값: 18

여러 조건 결합 (AND)

이메일이 존재하고, 상태가 active인 경우에만 true로 분기합니다.

  • 조건 1: 필드명 email, 연산자 존재함

  • 조건 2: 필드명 status, 연산자 같음, 비교 값 active

  • 조건 결합: AND

참고 사항

  • 문자열 비교 시 대소문자를 무시하며, 양쪽 공백을 자동으로 제거(trim)합니다.

  • 숫자 비교 연산자(>, <, >=, <=)는 값을 숫자로 변환하여 비교합니다. 숫자로 변환할 수 없는 값은 false로 처리됩니다.

  • {{ $json.fieldName }} 형태의 표현식은 자동으로 필드명으로 변환됩니다.

  • 존재함/존재하지 않음/비어있음/비어있지 않음 연산자는 비교 값 입력이 필요 없습니다.

  • 배열 필드에 대해 포함 연산자를 사용하면 배열 내 값 존재 여부를 확인할 수 있습니다.