콘텐츠로 이동
📣 인포그랩에서 OpenAI 기술 기반으로 자체 개발한 자동화 번역 프로그램을 통해 n8n 공식 문서의 한글판을 국내 최초로 제공합니다.

커스텀 실행 데이터#

Code 노드 또는 Execution Data node를 사용하여 워크플로우에 커스텀 데이터를 설정할 수 있습니다. n8n은 각 실행 시 이를 기록합니다. 그런 다음 실행 목록을 필터링할 때 또는 Code 노드를 사용하여 워크플로우에서 이 데이터를 가져올 수 있습니다.

기능 사용 가능 여부

사용자 지정 실행 데이터(Custom executions data)는 다음 플랜에서 사용할 수 있습니다:

  • Cloud: Pro, Enterprise
  • 자체 호스팅(Self-Hosted): Enterprise, 등록된 커뮤니티(Community) 사용자

버전 0.222.0 이상에서 지원됩니다.

Code 노드를 사용하여 커스텀 데이터 설정 및 접근#

이 섹션에서는 Code 노드를 사용하여 데이터를 설정하고 접근하는 방법을 설명합니다. 데이터를 설정하기 위해 Execution Data node를 사용하는 방법에 대한 정보는 Execution Data node를 참조하세요. Execution Data node를 사용하여 커스텀 데이터를 검색할 수는 없습니다.

커스텀 실행 데이터 설정#

단일 추가 데이터를 설정합니다:

1
$execution.customData.set("key", "value");
1
_execution.customData.set("key", "value");

모든 추가 데이터를 설정합니다. 이는 해당 실행에 대한 전체 커스텀 데이터 객체를 덮어씁니다:

1
$execution.customData.setAll({"key1": "value1", "key2": "value2"})
1
_execution.customData.setAll({"key1": "value1", "key2": "value2"})

제한 사항이 있습니다:

  • 값은 문자열이어야 합니다.
  • key는 최대 50자까지 허용됩니다.
  • value는 최대 255자까지 허용됩니다.
  • n8n은 최대 10개의 커스텀 데이터 항목을 지원합니다.

실행 중 커스텀 데이터 객체 접근#

실행 중 커스텀 데이터 객체 또는 그 안의 특정 값을 검색할 수 있습니다:

1
2
3
4
5
// 실행 중 객체의 현재 상태에 접근
const customData = $execution.customData.getAll();

// 이 실행 중 설정된 특정 값에 접근
const customData = $execution.customData.get("key");
1
2
3
4
5
# 실행 중 객체의 현재 상태에 접근
customData = _execution.customData.getAll();

# 이 실행 중 설정된 특정 값에 접근
customData = _execution.customData.get("key");
인포레터에서 최신 DevOps 트렌드를 격주로 만나보세요!