선언형 스타일 node의 node 기본 파일에서 사용 가능한 파라미터입니다.

이 문서는 코드 구조와 개념을 이해하는 데 도움이 되는 짧은 코드 스니펫을 제공합니다. 실제 코드 예시를 포함한 node 빌드의 전체 안내는 선언형 스타일 node 빌드를 참고하세요.

모든 node에서 사용 가능한 파라미터는 표준 파라미터를 참고하세요.

methods 및 loadOptions#

오브젝트 | 선택적

methods에는 loadOptions 오브젝트가 포함됩니다. loadOptions를 사용하여 서비스를 쿼리해 사용자별 설정을 가져온 다음, GUI에 렌더링하여 사용자가 후속 쿼리에 포함시킬 수 있습니다. 오브젝트는 서비스를 쿼리하는 방법에 대한 라우팅 정보와 반환된 옵션을 처리하는 방법을 정의하는 출력 설정을 포함해야 합니다. 예:

methods : {
	loadOptions: {
		routing: {
			request: {
				url: '/webhook/example-option-parameters',
				method: 'GET',
			},
			output: {
				postReceive: [
					{
						// 반환된 데이터가 다른 속성 아래에 중첩된 경우
						// 해당 속성 키를 지정합니다
						type: 'rootProperty',
						properties: {
							property: 'responseData',
						},
					},
					{
						type: 'setKeyValue',
						properties: {
							name: '={{$responseItem.key}} ({{$responseItem.value}})',
							value: '={{$responseItem.value}}',
						},
					},
					{
						// 들어오는 데이터가 오브젝트 배열인 경우 키별로 알파벳순 정렬
						type: 'sort',
						properties: {
							key: 'name',
						},
					},
				],
			},
		},
	}
},

routing#

오브젝트 | 필수

routing은 작업 및 입력 필드 오브젝트의 options 배열 내에서 사용되는 오브젝트입니다. API 호출의 세부 정보를 포함합니다.

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

description: INodeTypeDescription = {
  // 다른 node 정보가 여기에 있습니다
  requestDefaults: {
			baseURL: 'https://api.nasa.gov',
			url: '',
			headers: {
				Accept: 'application/json',
				'Content-Type': 'application/json',
			},
		},
    properties: [
      // 리소스가 여기에 있습니다
      {
        displayName: 'Operation'
        // 다른 작업 세부 정보
        options: [
          {
            name: 'Get'
            value: 'get',
            description: '',
            routing: {
              request: {
                method: 'GET',
                url: '/planetary/apod'
              }
            }
          }
        ]
      }
    ]
}

version#

숫자 또는 배열 | 선택적

node의 버전이 하나인 경우 숫자가 될 수 있습니다. 여러 버전을 지원하려면 각 node 버전의 숫자를 포함하는 배열로 변환합니다.

n8n은 두 가지 node 버전 관리 방법을 지원하지만, 선언형 스타일 node는 가벼운 버전 관리 방식을 사용해야 합니다. 자세한 내용은 node 버전 관리를 참고하세요.

features#

오브젝트 | 선택적

node 버전에 대해 평가된 명명된 기능 플래그를 정의합니다. displayOptions에서 @feature를 사용하여 파라미터 가시성을 제어하는 데 기능을 사용합니다.

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