이는 선언적 스타일 노드의 노드 base 파일에서 사용할 수 있는 매개변수입니다.

이 문서는 코드 구조와 개념을 이해하는 데 도움이 되는 짧은 코드 스니펫을 제공합니다. 실제 코드 예제를 포함하여 노드를 빌드하는 전체 과정을 확인하려면 선언적 스타일 노드 빌드하기를 참고하세요.

모든 노드에서 사용할 수 있는 매개변수는 표준 매개변수를 참고하세요.

methods 및 loadOptions#

Object | Optional

methods에는 loadOptions 객체가 포함됩니다. loadOptions를 사용하면 서비스에 사용자별 설정을 조회한 다음, 이를 반환하여 GUI에 렌더링함으로써 사용자가 이후 쿼리에 해당 설정을 포함할 수 있습니다. 이 객체에는 서비스를 조회하는 방법에 대한 라우팅 정보와, 반환된 옵션을 처리하는 방법을 정의하는 출력 설정이 반드시 포함되어야 합니다. 예를 들면 다음과 같습니다.

methods : {
	loadOptions: {
		routing: {
			request: {
				url: '/webhook/example-option-parameters',
				method: 'GET',
			},
			output: {
				postReceive: [
					{
						// When the returned data is nested under another property
						// Specify that property key
						type: 'rootProperty',
						properties: {
							property: 'responseData',
						},
					},
					{
						type: 'setKeyValue',
						properties: {
							name: '={{$responseItem.key}} ({{$responseItem.value}})',
							value: '={{$responseItem.value}}',
						},
					},
					{
						// If incoming data is an array of objects, sort alphabetically by key
						type: 'sort',
						properties: {
							key: 'name',
						},
					},
				],
			},
		},
	}
},

routing#

Object | Required

routing은 오퍼레이션과 입력 필드 객체의 options 배열 내에서 사용되는 객체입니다. API 호출에 대한 세부 정보를 포함합니다.

아래 코드 예제는 선언적 스타일 튜토리얼에서 가져온 것입니다. 이 예제는 NASA API와의 통합을 설정합니다. requestDefaults를 사용해 기본 API 호출 세부 정보를 설정하는 방법과, 각 오퍼레이션에 대한 정보를 추가하기 위해 routing을 사용하는 방법을 보여줍니다.

description: INodeTypeDescription = {
  // Other node info here
  requestDefaults: {
			baseURL: 'https://api.nasa.gov',
			url: '',
			headers: {
				Accept: 'application/json',
				'Content-Type': 'application/json',
			},
		},
    properties: [
      // Resources here
      {
        displayName: 'Operation'
        // Other operation details
        options: [
          {
            name: 'Get'
            value: 'get',
            description: '',
            routing: {
              request: {
                method: 'GET',
                url: '/planetary/apod'
              }
            }
          }
        ]
      }
    ]
}

version#

Number 또는 Array | Optional

노드 버전이 하나라면 숫자로 지정할 수 있습니다. 두 개 이상의 버전을 지원하려면, 각 노드 버전에 대한 숫자를 담은 배열로 만드세요.

n8n은 두 가지 노드 버전 관리 방식을 지원하지만, 선언적 스타일 노드는 반드시 light 버전 관리 방식을 사용해야 합니다. 자세한 내용은 노드 버전 관리를 참고하세요.

features#

Object | Optional

노드 버전에 따라 평가되는 이름이 지정된 기능 플래그를 정의합니다. displayOptions에서 @feature를 사용하여 매개변수 가시성을 제어할 때 features를 사용합니다.

자세한 내용은 기능 기반 버전 관리를 참고하세요.