다음은 노드 베이스 파일의 표준 파라미터입니다. 모든 노드 유형에 공통으로 적용됩니다.

displayName#

String | Required

사용자가 n8n GUI에서 보는 이름입니다.

name#

String | Required

객체의 내부 이름입니다. 노드 내 다른 위치에서 이를 참조할 때 사용됩니다.

icon#

String 또는 Object | Required

특정 노드에 대한 아이콘을 지정합니다. n8n에서는 자체 이미지 파일을 업로드하는 것을 권장합니다.

아이콘 파일 이름을 문자열로 제공하거나, 라이트 모드와 다크 모드에 각각 다른 아이콘을 사용하도록 객체로 제공할 수 있습니다. 아이콘이 라이트 모드와 다크 모드 모두에서 동작한다면 아이콘 파일 경로를 나타내는 file:로 시작하는 문자열을 사용하세요. 예를 들면 다음과 같습니다.

icon: 'file:exampleNodeIcon.svg'

라이트 모드와 다크 모드에 각각 다른 아이콘을 제공하려면 light와 dark 속성을 가진 객체를 사용하세요. 예를 들면 다음과 같습니다.

icon: { 
  light: 'file:exampleNodeIcon.svg', 
  dark: 'file:exampleNodeIcon.dark.svg' 
}

group#

Array of strings | Required

워크플로가 실행될 때 노드가 어떻게 동작할지 n8n에 알려줍니다. 옵션은 다음과 같습니다.

• trigger: 노드가 트리거를 기다립니다.
• schedule: 노드가 타이머 만료를 기다립니다.
• input, output, transform: 현재 아무런 효과가 없습니다.
• 빈 배열 []. trigger나 schedule이 필요하지 않다면 이 값을 기본 옵션으로 사용하세요.

description#

String | Required

노드에 대한 간단한 설명입니다. n8n은 이를 GUI에서 사용합니다.

defaults#

Object | Required

필수 브랜드 및 이름 설정을 포함합니다.

객체는 다음을 포함할 수 있습니다.

• name: String. displayName이 너무 길 경우 캔버스에서 노드 이름으로 사용됩니다.
• color: String. n8n 1.52.0부터 지원 중단되었으며 n8n 3.0에서 제거됩니다. Font Awesome 아이콘에만 색을 입혔습니다. 대신 파일 아이콘을 사용하세요.

forceInputNodeExecution#

Boolean | Optional

다중 입력 노드를 만들 때, 모든 브랜치의 선행 노드가 실행되기 전에는 이 노드가 실행되지 않도록 강제할 수 있습니다. 기본값은 false이며(하나의 입력 브랜치만 실행되면 됨).

inputs#

Array of strings | Required

입력 커넥터의 이름을 지정합니다. 노드가 입력 쪽에 갖는 커넥터 수를 제어합니다. 커넥터가 하나만 필요하다면 inputs: [NodeConnectionTypes.Main]을 사용하세요.

outputs#

Array of strings | Required

출력 커넥터의 이름을 지정합니다. 노드가 출력 쪽에 갖는 커넥터 수를 제어합니다. 커넥터가 하나만 필요하다면 outputs: [NodeConnectionTypes.Main]을 사용하세요.

requiredInputs#

Integer 또는 Array | Optional

다중 입력 노드에 사용됩니다. 노드가 실행되기 전에 데이터가 있어야(즉, 해당 브랜치가 실행되어야) 하는 입력을 번호로 지정합니다.

credentials#

Array of objects | Required

이 파라미터는 자격 증명 옵션을 n8n에 알려줍니다. 각 객체는 하나의 인증 유형을 정의합니다.

객체는 다음을 반드시 포함해야 합니다.

• name: 자격 증명 이름입니다. 자격 증명 파일의 name 속성과 일치해야 합니다. 예를 들어, Asana.node.ts의 name: 'asanaApi'는 AsanaApi.credential.ts의 name = 'asanaApi'와 연결됩니다.
• required: Boolean. 이 노드를 사용하는 데 인증이 필요한지 여부를 지정합니다.

requestDefaults#

Object | Required

노드가 수행하는 API 호출에 대한 기본 정보를 설정합니다.

이 객체는 다음을 반드시 포함해야 합니다.

• baseURL: API 기본 URL입니다.

다음을 추가로 포함할 수도 있습니다.

• headers: 콘텐츠 유형과 같은 API 호출 헤더를 설명하는 객체입니다.
• url: string. baseURL에 덧붙여집니다. 보통은 생략해도 됩니다. operations에서 이 값을 제공하는 것이 더 일반적입니다.

properties#

Array of objects | Required

노드 동작을 정의하는 resource 및 operations 객체와, 사용자 입력을 받을 수 있는 필수/선택 필드를 설정하는 객체를 포함합니다.

Resource 객체#

resource 객체는 다음 파라미터를 포함합니다.

• displayName: String. 항상 Resource여야 합니다.
• name: String. 항상 resource여야 합니다.
• type: String. 어떤 UI 요소를 사용할지, 어떤 입력 유형을 기대할지 n8n에 알려줍니다. 예를 들어, options는 n8n이 사용자가 하나의 옵션을 선택할 수 있는 드롭다운을 추가하도록 합니다. 자세한 내용은 노드 UI 요소를 참고하세요.
• noDataExpression: Boolean. 파라미터에 표현식을 사용하지 못하도록 합니다. resource에서는 항상 true여야 합니다.

Operations 객체#

operations 객체는 resource에서 사용 가능한 작업들을 정의합니다.

• displayName: String. 항상 Options여야 합니다.
• name: String. 항상 option이어야 합니다.
• type: String. 어떤 UI 요소를 사용할지, 어떤 입력 유형을 기대할지 n8n에 알려줍니다. 예를 들어, dateTime은 n8n이 날짜 선택기를 추가하도록 합니다. 자세한 내용은 노드 UI 요소를 참고하세요.
• noDataExpression: Boolean. 파라미터에 표현식을 사용하지 못하도록 합니다. operation에서는 항상 true여야 합니다.
• options: Array of objects. 각 객체는 라우팅, 사용하는 REST 동사 등 하나의 작업 동작을 설명합니다. options 객체는 다음을 포함합니다.
  • name. String.
  • value. String.
  • action: String. 이 파라미터는 resource와 operation을 결합합니다. n8n이 향후 버전에서 이를 사용할 예정이므로 항상 포함해야 합니다. 예를 들어, resource가 "Card"이고 operation이 "Get all"이라면, action은 "Get all cards"가 됩니다.
  • description: String.
  • routing: 요청 세부 정보를 담은 Object.

Additional fields 객체#

이 객체는 선택적 파라미터를 정의합니다. n8n은 이를 GUI의 Additional Fields 아래에 표시합니다. 사용자는 설정할 파라미터를 선택할 수 있습니다.

객체는 다음을 반드시 포함해야 합니다.

displayName: 'Additional Fields',
name: 'additionalFields',
// The UI element type
type: ''
placeholder: 'Add Field',
default: {},
displayOptions: {
  // Set which resources and operations this field is available for
  show: {
    resource: [
      // Resource names
    ],
    operation: [
      // Operation names
    ]
  },
}

UI 요소 유형에 대한 자세한 내용은 UI 요소를 참고하세요.

관련 리소스#

• 베이스 파일
• 구조
• 선언형 스타일 매개변수
• 프로그래밍 방식 스타일 매개변수
• 프로그래밍 방식 스타일 execute 메서드