선언적 스타일 매개변수

이 문서에서는 선언적 스타일 노드의 node base file에서 사용할 수 있는 매개변수를 제공합니다.

이 문서는 코드 구조와 개념을 이해하는 데 도움이 되는 짧은 코드 스니펫을 제공합니다. 실제 코드 예제를 포함하여 노드 빌딩에 대한 전체 워크스루는 Build a declarative-style node를 참조하세요.

모든 노드에서 사용 가능한 매개변수는 Standard parameters를 참조하세요.

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 호출의 세부 정보를 포함합니다.

아래 코드 예제는 Declarative-style tutorial에서 가져온 것입니다. NASA API와의 통합을 설정하는 방법을 보여줍니다. 기본 API 호출 세부 정보를 설정하기 위한 requestDefaults의 사용과 각 작업에 대한 정보를 추가하기 위한 routing의 사용을 보여줍니다.

description: INodeTypeDescription = {
  // 여기에 다른 노드 정보
  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

숫자 또는 배열 | 선택 사항

노드의 버전이 하나만 있다면, 이는 숫자가 될 수 있습니다. 하나 이상의 버전을 지원하고 싶다면 이것을 배열로 만들어 각 노드 버전의 숫자를 포함하세요.

n8n은 두 가지 방법의 노드 버전 관리를 지원하지만, 선언적 스타일 노드는 라이트 버전 관리 방법을 사용해야 합니다. 자세한 내용은 Node versioning를 참조하세요.