n8n 메타데이터

요약

n8n 메타데이터 작업을 위한 메서드입니다. Code 노드에서 Python을 사용할 수 있습니다.

n8n 메타데이터 작업을 위한 메서드입니다.

다음이 포함됩니다:

셀프 호스팅 n8n을 위한 n8n 환경 변수 접근.
워크플로, 실행, 노드에 대한 메타데이터.
인스턴스 Variables 및 External secrets 정보.

Python 지원

Code 노드에서 Python을 사용할 수 있습니다. 표현식에서는 사용할 수 없습니다.

메서드	설명	Code 노드에서 사용 가능?
`$env`	n8n 인스턴스 구성 환경 변수를 포함합니다.	:white_check_mark:
`$execution.customData`	사용자 정의 실행 데이터를 설정하고 가져옵니다. 자세한 내용은 사용자 정의 실행 데이터를 참조하세요.	:white_check_mark:
`$execution.id`	현재 워크플로 실행의 고유 ID입니다.	:white_check_mark:
`$execution.mode`	실행이 자동으로 트리거되었는지, 아니면 워크플로를 수동으로 실행하여 트리거되었는지를 나타냅니다. 가능한 값은 `test`와 `production`입니다.	:white_check_mark:
`$execution.resumeUrl`	Wait 노드에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL입니다.	:white_check_mark:
`$getWorkflowStaticData(type)`	예시를 참조하세요. 정적 데이터는 워크플로를 테스트할 때 유지되지 않습니다. 정적 데이터를 저장하려면 워크플로가 활성화되어 있고 트리거 또는 웹훅으로 호출되어야 합니다. 정적 워크플로 데이터에 접근합니다.	:white_check_mark:
`$("<node-name>").isExecuted`	노드가 이미 실행되었는지 확인합니다.	:white_check_mark:
`$itemIndex`	항목 목록에서 항목의 인덱스입니다.	:x:
`$nodeVersion`	현재 노드의 버전을 가져옵니다.	:white_check_mark:
`$prevNode.name`	현재 입력이 온 노드의 이름입니다. Merge 노드를 사용할 때, `$prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.	:white_check_mark:
`$prevNode.outputIndex`	현재 입력이 온 출력 커넥터의 인덱스입니다. 이전 노드에 여러 출력이 있는 경우(예: If 또는 Switch 노드) 이를 사용하세요. Merge 노드를 사용할 때, `$prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.	:white_check_mark:
`$prevNode.runIndex`	현재 입력을 생성한 이전 노드의 실행 횟수입니다. Merge 노드를 사용할 때, `$prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.	:white_check_mark:
`$runIndex`	n8n이 현재 노드를 실행한 횟수입니다. 0부터 시작합니다(첫 번째 실행은 0, 두 번째는 1, 순서대로).	:white_check_mark:
`$secrets`	External secrets 설정에 대한 정보를 포함합니다.	:x:
`$vars`	활성 환경에서 사용 가능한 Variables를 포함합니다.	:white_check_mark:
`$version`	노드 버전입니다.	:x:
`$workflow.active`	워크플로가 활성화(true) 또는 비활성화(false) 상태인지 나타냅니다.	:white_check_mark:
`$workflow.id`	워크플로 ID입니다.	:white_check_mark:
`$workflow.name`	워크플로 이름입니다.	:white_check_mark:

메서드	설명
`_items`	"Run once for all items" 모드에서 수신 항목을 포함합니다.
`_item`	"Run once for each item" 모드에서 반복 중인 항목을 포함합니다.

메서드	설명
`_env`	n8n 인스턴스 구성 환경 변수를 포함합니다.
`_execution.customData`	사용자 정의 실행 데이터를 설정하고 가져옵니다. 자세한 내용은 사용자 정의 실행 데이터를 참조하세요.
`_execution.id`	현재 워크플로 실행의 고유 ID입니다.
`_execution.mode`	실행이 자동으로 트리거되었는지, 아니면 워크플로를 수동으로 실행하여 트리거되었는지를 나타냅니다. 가능한 값은 `test`와 `production`입니다.
`_execution.resumeUrl`	Wait 노드에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL입니다.
`_getWorkflowStaticData(type)`	예시를 참조하세요. 정적 데이터는 워크플로를 테스트할 때 유지되지 않습니다. 정적 데이터를 저장하려면 워크플로가 활성화되어 있고 트리거 또는 웹훅으로 호출되어야 합니다. 정적 워크플로 데이터에 접근합니다.
`_("<node-name>").isExecuted`	노드가 이미 실행되었는지 확인합니다.
`_nodeVersion`	현재 노드의 버전을 가져옵니다.
`_prevNode.name`	현재 입력이 온 노드의 이름입니다. Merge 노드를 사용할 때, `_prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.
`_prevNode.outputIndex`	현재 입력이 온 출력 커넥터의 인덱스입니다. 이전 노드에 여러 출력이 있는 경우(예: If 또는 Switch 노드) 이를 사용하세요. Merge 노드를 사용할 때, `_prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.
`_prevNode.runIndex`	현재 입력을 생성한 이전 노드의 실행 횟수입니다. Merge 노드를 사용할 때, `_prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.
`_runIndex`	n8n이 현재 노드를 실행한 횟수입니다. 0부터 시작합니다(첫 번째 실행은 0, 두 번째는 1, 순서대로).
`_secrets`	External secrets 설정에 대한 정보를 포함합니다.
`_vars`	활성 환경에서 사용 가능한 Variables를 포함합니다.
`_workflow.active`	워크플로가 활성화(true) 또는 비활성화(false) 상태인지 나타냅니다.
`_workflow.id`	워크플로 ID입니다.
`_workflow.name`	워크플로 이름입니다.

n8n 메타데이터

원문 보기

번역일: 2026-03-12

요약

n8n 메타데이터 작업을 위한 메서드입니다. Code 노드에서 Python을 사용할 수 있습니다.

n8n 메타데이터 작업을 위한 메서드입니다.

다음이 포함됩니다:

셀프 호스팅 n8n을 위한 n8n 환경 변수 접근.
워크플로, 실행, 노드에 대한 메타데이터.
인스턴스 Variables 및 External secrets 정보.

Python 지원

Code 노드에서 Python을 사용할 수 있습니다. 표현식에서는 사용할 수 없습니다.

메서드	설명	Code 노드에서 사용 가능?
`$env`	n8n 인스턴스 구성 환경 변수를 포함합니다.	:white_check_mark:
`$execution.customData`	사용자 정의 실행 데이터를 설정하고 가져옵니다. 자세한 내용은 사용자 정의 실행 데이터를 참조하세요.	:white_check_mark:
`$execution.id`	현재 워크플로 실행의 고유 ID입니다.	:white_check_mark:
`$execution.mode`	실행이 자동으로 트리거되었는지, 아니면 워크플로를 수동으로 실행하여 트리거되었는지를 나타냅니다. 가능한 값은 `test`와 `production`입니다.	:white_check_mark:
`$execution.resumeUrl`	Wait 노드에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL입니다.	:white_check_mark:
`$getWorkflowStaticData(type)`	예시를 참조하세요. 정적 데이터는 워크플로를 테스트할 때 유지되지 않습니다. 정적 데이터를 저장하려면 워크플로가 활성화되어 있고 트리거 또는 웹훅으로 호출되어야 합니다. 정적 워크플로 데이터에 접근합니다.	:white_check_mark:
`$("<node-name>").isExecuted`	노드가 이미 실행되었는지 확인합니다.	:white_check_mark:
`$itemIndex`	항목 목록에서 항목의 인덱스입니다.	:x:
`$nodeVersion`	현재 노드의 버전을 가져옵니다.	:white_check_mark:
`$prevNode.name`	현재 입력이 온 노드의 이름입니다. Merge 노드를 사용할 때, `$prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.	:white_check_mark:
`$prevNode.outputIndex`	현재 입력이 온 출력 커넥터의 인덱스입니다. 이전 노드에 여러 출력이 있는 경우(예: If 또는 Switch 노드) 이를 사용하세요. Merge 노드를 사용할 때, `$prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.	:white_check_mark:
`$prevNode.runIndex`	현재 입력을 생성한 이전 노드의 실행 횟수입니다. Merge 노드를 사용할 때, `$prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.	:white_check_mark:
`$runIndex`	n8n이 현재 노드를 실행한 횟수입니다. 0부터 시작합니다(첫 번째 실행은 0, 두 번째는 1, 순서대로).	:white_check_mark:
`$secrets`	External secrets 설정에 대한 정보를 포함합니다.	:x:
`$vars`	활성 환경에서 사용 가능한 Variables를 포함합니다.	:white_check_mark:
`$version`	노드 버전입니다.	:x:
`$workflow.active`	워크플로가 활성화(true) 또는 비활성화(false) 상태인지 나타냅니다.	:white_check_mark:
`$workflow.id`	워크플로 ID입니다.	:white_check_mark:
`$workflow.name`	워크플로 이름입니다.	:white_check_mark:

메서드	설명
`_items`	"Run once for all items" 모드에서 수신 항목을 포함합니다.
`_item`	"Run once for each item" 모드에서 반복 중인 항목을 포함합니다.

메서드	설명
`_env`	n8n 인스턴스 구성 환경 변수를 포함합니다.
`_execution.customData`	사용자 정의 실행 데이터를 설정하고 가져옵니다. 자세한 내용은 사용자 정의 실행 데이터를 참조하세요.
`_execution.id`	현재 워크플로 실행의 고유 ID입니다.
`_execution.mode`	실행이 자동으로 트리거되었는지, 아니면 워크플로를 수동으로 실행하여 트리거되었는지를 나타냅니다. 가능한 값은 `test`와 `production`입니다.
`_execution.resumeUrl`	Wait 노드에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL입니다.
`_getWorkflowStaticData(type)`	예시를 참조하세요. 정적 데이터는 워크플로를 테스트할 때 유지되지 않습니다. 정적 데이터를 저장하려면 워크플로가 활성화되어 있고 트리거 또는 웹훅으로 호출되어야 합니다. 정적 워크플로 데이터에 접근합니다.
`_("<node-name>").isExecuted`	노드가 이미 실행되었는지 확인합니다.
`_nodeVersion`	현재 노드의 버전을 가져옵니다.
`_prevNode.name`	현재 입력이 온 노드의 이름입니다. Merge 노드를 사용할 때, `_prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.
`_prevNode.outputIndex`	현재 입력이 온 출력 커넥터의 인덱스입니다. 이전 노드에 여러 출력이 있는 경우(예: If 또는 Switch 노드) 이를 사용하세요. Merge 노드를 사용할 때, `_prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.
`_prevNode.runIndex`	현재 입력을 생성한 이전 노드의 실행 횟수입니다. Merge 노드를 사용할 때, `_prevNode`는 항상 첫 번째 입력 커넥터를 사용합니다.
`_runIndex`	n8n이 현재 노드를 실행한 횟수입니다. 0부터 시작합니다(첫 번째 실행은 0, 두 번째는 1, 순서대로).
`_secrets`	External secrets 설정에 대한 정보를 포함합니다.
`_vars`	활성 환경에서 사용 가능한 Variables를 포함합니다.
`_workflow.active`	워크플로가 활성화(true) 또는 비활성화(false) 상태인지 나타냅니다.
`_workflow.id`	워크플로 ID입니다.
`_workflow.name`	워크플로 이름입니다.