$()

설명: 지정된 노드의 데이터를 반환합니다.

구문: $(nodeName)

반환값: NodeData

출처: Custom n8n functionality

파라미터:

• nodeName (String) - 데이터를 가져올 노드의 이름

$binary#

설명: 현재 아이템에 대해 현재 노드로 전달된 바이너리 입력 데이터를 반환합니다. $input.item.binary의 단축 표현입니다.

구문: $binary

반환값: Array

출처: Custom n8n functionality

$execution#

설명: 현재 실행에 대한 메타데이터를 조회하거나 설정합니다.

구문: $execution

반환값: ExecData

출처: Custom n8n functionality

$fromAI()#

설명: 대규모 언어 모델이 노드 파라미터의 값을 제공해야 할 때 사용합니다. 더 나은 결과를 위해 설명을 제공하는 것을 권장합니다.

구문: $fromAI(key, description?, type?, defaultValue?)

반환값: any

출처: Custom n8n functionality

파라미터:

• key (String) - 가져올 필드의 이름. 영문자, 숫자, 밑줄, 하이픈만 포함할 수 있습니다.
• description (String) - 선택 사항 - 모델에게 반환해야 할 값에 대한 추가 컨텍스트를 제공하는 데 사용합니다.
• type (String) - 선택 사항 - 반환할 값의 유형. string, number, boolean, json, date, datetime 중 하나입니다. 기본값은 string입니다.
• defaultValue (any) - 선택 사항 - 모델이 해당 키를 반환하지 않을 때 사용할 값

예제:

// 모델에게 이름을 제공하도록 요청하고 여기서 사용
$fromAI('name')

// 모델에게 사람의 나이(기본값 18의 숫자)를 제공하도록 요청하고 여기서 사용
$fromAI('age', 'The age of the person', 'number', 18)

// 모델에게 사람이 학생인지 여부를 나타내는 boolean(기본값 false)을 제공하도록 요청하고 여기서 사용
$fromAI('isStudent', 'Is the person a student', 'boolean', false)

$if()#

설명: condition에 따라 두 값 중 하나를 반환합니다. JavaScript의 ? 연산자와 유사합니다.

구문: $if(condition, valueIfTrue, valueIfFalse)

반환값: any

출처: Custom n8n functionality

파라미터:

• condition (Boolean) - 수행할 검사. true 또는 false로 평가되어야 합니다.
• valueIfTrue (any) - 조건이 참일 때 반환할 값
• valueIfFalse (any) - 조건이 거짓일 때 반환할 값

예제:

// 오후 5시 이전이면 "Good day", 그렇지 않으면 "Good evening" 반환
$if($now.hour < 17, "Good day", "Good evening")

// $if() 호출은 중첩 가능:
// 오전 10시 이전이면 "Good morning", 오후 5시 이전이면 "Good day", 그렇지 않으면 "Good evening" 반환
$if($now.hour < 10, "Good morning", $if($now.hour < 17, "Good day", "Good evening"))

$ifEmpty()#

설명: 첫 번째 파라미터가 비어 있지 않으면 반환하고, 비어 있으면 두 번째 파라미터를 반환합니다. 빈 값으로 간주되는 것: "", [], {}, null, undefined

구문: $ifEmpty(value, valueIfEmpty)

반환값: any

출처: Custom n8n functionality

파라미터:

• value (any) - 비어 있지 않은 경우 반환할 값
• valueIfEmpty (any) - value가 비어 있는 경우 반환할 값

예제:

"Hi " + $ifEmpty(name, "there") // 예: "Hi Nathan" 또는 "Hi there"

$input#

설명: 현재 노드의 입력 데이터

구문: $input

반환값: NodeData

출처: Custom n8n functionality

$itemIndex#

설명: 입력 아이템 목록에서 현재 처리 중인 아이템의 위치

구문: $itemIndex

반환값: Number

출처: Custom n8n functionality

$jmespath()#

설명: JMESPath 표현식을 사용하여 객체(또는 객체 배열)에서 데이터를 추출합니다. 복잡하게 중첩된 객체를 쿼리하는 데 유용합니다. 표현식이 유효하지 않으면 undefined를 반환합니다.

구문: $jmespath(obj, expression)

반환값: any

출처: Custom n8n functionality

파라미터:

• obj (Object|Array) - 데이터를 가져올 객체 또는 객체 배열
• expression (String) - 객체에서 가져올 데이터를 정의하는 JMESPath 표현식

예제:

data = {
  "people": [
    {
      "age": 20,
      "other": "foo",
      "name": "Bob"
    },
    {
      "age": 25,
      "other": "bar",
      "name": "Fred"
    },
    {
      "age": 30,
      "other": "baz",
      "name": "George"
    }
  ]
}

// 모든 이름을 배열로 가져오기
{{ $jmespath(data, '[*].name') }} //=> ["Bob", "Fred", "George"]

// 20세 이상인 모든 사람의 이름과 나이 가져오기
$jmespath(data, '[?age > `20`].[name, age]') //=> [ ["Fred",25], ["George",30] ]

// 20세 이상인 첫 번째 사람의 이름 가져오기
$jmespath($json.people, '[?age > `20`].name | [0]') //=> Fred

data = {
    "reservations": [
      {
        "id": 1,
        "guests": [
          {
            "name": "Nathan",
            "requirements": {
              "room": "double",
              "meal": "vegetarian"
            }
          },
          {
            "name": "Meg",
            "requirements": {
              "room": "single"
            }
          }
        ]
      },
      {
        "id": 2,
        "guests": [
          {
            "name": "Lex",
            "requirements": {
              "room": "double"
            }
          }
        ]
      }
    ]
  }

// 더블룸이 필요한 각 예약의 모든 투숙객 이름 가져오기
$jmespath(data, 'reservations[].guests[?requirements.room==`double`].name')

$json#

설명: 현재 아이템에 대해 현재 노드로 전달된 JSON 입력 데이터를 반환합니다. $input.item.json의 단축 표현입니다. 자세히 보기

구문: $json

반환값: Object

출처: Custom n8n functionality

$max()#

설명: 주어진 숫자 중 가장 큰 값을 반환합니다.

구문: $max(num1, num2, …, numN)

반환값: Number

출처: Custom n8n functionality

파라미터:

• num1 (Number) - 비교할 첫 번째 숫자
• num2 (Number) - 비교할 두 번째 숫자

$min()#

설명: 주어진 숫자 중 가장 작은 값을 반환합니다.

구문: $min(num1, num2, …, numN)

반환값: Number

출처: Custom n8n functionality

파라미터:

• num1 (Number) - 비교할 첫 번째 숫자
• num2 (Number) - 비교할 두 번째 숫자

$nodeVersion#

설명: 현재 노드의 버전 (노드 설정 창 하단에 표시됨)

구문: $nodeVersion

반환값: String

출처: Custom n8n functionality

$now#

설명: 현재 시각을 나타내는 DateTime입니다.

워크플로우의 시간대를 사용합니다(워크플로우 설정에서 변경 가능).

구문: $now

반환값: DateTime

출처: Custom n8n functionality

$pageCount#

설명: 노드가 가져온 결과 페이지 수. 'HTTP Request' 노드에서만 사용 가능합니다.

구문: $pageCount

반환값: Number

출처: Custom n8n functionality

$parameter#

설명: 현재 노드의 구성 설정. 노드 UI 내에서 입력하는 파라미터(예: 작업)입니다.

구문: $parameter

반환값: NodeParams

출처: Custom n8n functionality

$prevNode#

설명: 현재 입력이 전달된 노드에 대한 정보입니다.

'Merge' 노드에서는 항상 첫 번째 입력 커넥터를 사용합니다.

구문: $prevNode

반환값: PrevNodeData

출처: Custom n8n functionality

$request#

설명: 노드의 마지막 실행 중에 전송된 요청 객체. 'HTTP Request' 노드에서만 사용 가능합니다.

구문: $request

반환값: Object

출처: Custom n8n functionality

$response#

설명: 마지막 HTTP 호출에서 반환된 응답. 'HTTP Request' 노드에서만 사용 가능합니다.

구문: $response

반환값: HTTPResponse

출처: Custom n8n functionality

$runIndex#

설명: 현재 노드 실행의 현재 실행 인덱스. 0부터 시작합니다.

구문: $runIndex

반환값: Number

출처: Custom n8n functionality

$secrets#

설명: 설정된 경우 외부 시크릿 저장소의 시크릿 값. 시크릿 값은 사용자에게 표시되지 않습니다. 자격 증명 필드에서만 사용 가능합니다.

구문: $secrets

반환값: Object

출처: Custom n8n functionality

$today#

설명: 현재 날짜 시작 시각(자정)을 나타내는 DateTime입니다.

인스턴스의 시간대를 사용합니다(워크플로우 설정에서 재정의하지 않은 경우).

구문: $today

반환값: DateTime

출처: Custom n8n functionality

$vars#

설명: 워크플로우에서 사용 가능한 변수

구문: $vars

반환값: Object

출처: Custom n8n functionality

$workflow#

설명: 현재 워크플로우에 대한 정보

구문: $workflow

반환값: WorkflowData

출처: Custom n8n functionality