커스텀 변수

n8n 워크플로에서 값을 저장하고 재사용하기 위한 커스텀 변수의 생성, 편집, 사용 방법을 설명합니다.

기능 가용성 Self-hosted Enterprise 및 Pro Cloud 플랜에서 사용 가능합니다. 인스턴스 소유자와 관리자만 변수를 생성할 수 있습니다. 커스텀 변수는 n8n 워크플로에서 값을 저장하고 재사용할 수 있는 읽기 전용 변수입니다. 변수 범위와 가용성 전역 변수 는 모든 프로젝트에서 n8n 인스턴스의 모든 사용자가 사용할 수 있습니다. 프로젝트 범위 변수 는 해당 변수가 생성된 특정 프로젝트 내에서만 사용 가능합니다. 프로젝트 범위 변수는 1.118.0 이상 버전에서 사용 가능합니다. 이전 버전은 왼쪽 사이드 메뉴에서 접근 가능한 전역 변수만 지원합니다. 변수 생성 # 개요 페이지 또는 특정 프로젝트에서 Variables 탭에 접근할 수 있습니다. 새 변수를 생성하려면: Variables 탭에서 Add Variable 을 선택합니다. Key 와 Value 를 입력합니다. 최대 키 길이는 50자이고, 최대 값 길이는 1000자입니다. n8n은 키와 값에 사용할 수 있는 문자를 소문자 및 대문자, 숫자, 밑줄( A-Z , a-z , 0-9 , _ )로 제한합니다. Scope 를 선택합니다(개요 페이지에서 생성할 때만 사용 가능): Global : 변수가 n8n 인스턴스의 모든 프로젝트에서 사용 가능합니다. Project : 변수가 특정 프로젝트 내에서만 사용 가능합니다(어떤 프로젝트인지 선택할 수 있습니다). 프로젝트 페이지에서 생성할 경우, 범위는 자동으로 해당 프로젝트로 설정됩니다. Save 를 선택합니다. 이제 변수는 범위에 따라 워크플로에서 사용 가능합니다. 변수 편집 및 삭제 # 변수를 편집하거나 삭제하려면: Variables 탭에서 변경하려는 변수 위에 마우스를 올립니다. Edit 또는 Delete 를 선택합니다. 워크플로에서 변수 사용 # Code 노드와 표현식 에서 변수에 접근할 수 있습니다: // 변수 접근 $vars.<variable-name> 모든 변수는 문자열입니다. 워크플로 실행 중에 n8n은 변수를 변수 값으로 교체합니다. 변수에 값이 없으면 n8n은 해당 값을 undefined 로 처리합니다. 이 경우 워크플로가 자동으로 실패하지는 않습니다. 변수 우선순위 프로젝트 범위 변수가 전역 변수와 동일한 키를 가지면, 프로젝트 범위 변수 값이 우선하며 해당 프로젝트의 워크플로 내에서 전역 변수 값을 재정의합니다. 변수는 읽기 전용입니다. UI를 사용하여 값을 변경해야 합니다. 워크플로 내에서 커스텀 데이터를 설정하고 접근해야 하는 경우, 워크플로 정적 데이터 를 사용하십시오.