node 기본 파일의 표준 파라미터입니다. 모든 node 타입에서 동일하게 사용됩니다.

displayName#

문자열 | 필수

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

name#

문자열 | 필수

오브젝트의 내부 이름입니다. node 내 다른 곳에서 참조하는 데 사용됩니다.

icon#

문자열 또는 오브젝트 | 필수

특정 node의 아이콘을 지정합니다. n8n은 직접 이미지 파일을 업로드하는 것을 권장합니다.

아이콘 파일 이름을 문자열로 제공하거나, 라이트 모드와 다크 모드에 각각 다른 아이콘을 사용하기 위해 오브젝트로 제공할 수 있습니다. 라이트 모드와 다크 모드 모두에서 작동하는 아이콘의 경우, file:로 시작하는 문자열을 사용하여 아이콘 파일 경로를 나타냅니다. 예를 들어:

icon: 'file:exampleNodeIcon.svg'

라이트 모드와 다크 모드에 각각 다른 아이콘을 제공하려면 light 및 dark 속성이 있는 오브젝트를 사용합니다. 예를 들어:

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

n8n은 노드 아이콘으로 SVG 사용을 권장하지만, PNG도 사용할 수 있습니다. PNG를 사용하는 경우 아이콘 해상도는 60x60px여야 합니다. 노드 아이콘은 정사각형 또는 정사각형에 가까운 비율이어야 합니다.

group#

문자열 배열 | 필수

워크플로 실행 시 node의 동작 방식을 n8n에 알립니다. 옵션:

• trigger: node가 트리거를 대기합니다.
• schedule: node가 타이머 만료를 대기합니다.
• input, output, transform: 현재 아무 효과가 없습니다.
• 빈 배열 []. trigger 또는 schedule이 필요하지 않은 경우 기본 옵션으로 사용합니다.

description#

문자열 | 필수

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

defaults#

오브젝트 | 필수

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

오브젝트는 다음을 포함할 수 있습니다:

• name: 문자열. displayName이 너무 길 경우 캔버스에서 node 이름으로 사용됩니다.
• color: 문자열. 16진수 색상 코드. n8n에서 사용할 통합의 브랜드 색상을 제공합니다.

forceInputNodeExecution#

불리언 | 선택적

멀티 입력 node를 구축할 때 node 실행 전 모든 브랜치의 이전 node가 실행되도록 강제할 수 있습니다. 기본값은 false입니다(하나의 입력 브랜치만 실행하면 됩니다).

inputs#

문자열 배열 | 필수

입력 커넥터의 이름을 지정합니다. 입력 측의 커넥터 수를 제어합니다. 커넥터 하나만 필요한 경우 input: ['main']을 사용합니다.

outputs#

문자열 배열 | 필수

출력 커넥터의 이름을 지정합니다. 출력 측의 커넥터 수를 제어합니다. 커넥터 하나만 필요한 경우 output: ['main']을 사용합니다.

requiredInputs#

정수 또는 배열 | 선택적

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

credentials#

오브젝트 배열 | 필수

이 파라미터는 n8n에 자격 증명 옵션을 알립니다. 각 오브젝트는 인증 타입을 정의합니다.

오브젝트에는 다음이 포함되어야 합니다:

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

requestDefaults#

오브젝트 | 필수

node가 수행하는 API 호출의 기본 정보를 설정합니다.

이 오브젝트에는 다음이 포함되어야 합니다:

• baseURL: API 기본 URL.

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

• headers: 콘텐츠 타입과 같은 API 호출 헤더를 설명하는 오브젝트.
• url: 문자열. baseURL에 추가됩니다. 일반적으로 생략할 수 있습니다. operations에서 제공하는 것이 더 일반적입니다.

properties#

오브젝트 배열 | 필수

node 동작을 정의하는 리소스와 오퍼레이션 오브젝트를 포함하며, 사용자 입력을 받을 수 있는 필수 및 선택적 필드를 설정하는 오브젝트도 포함됩니다.

리소스 오브젝트#

리소스 오브젝트에는 다음 파라미터가 포함됩니다:

• displayName: 문자열. 항상 Resource여야 합니다.
• name: 문자열. 항상 resource여야 합니다.
• type: 문자열. n8n이 사용할 UI 요소와 기대하는 입력 타입을 알립니다. 예를 들어, options는 n8n이 사용자가 하나의 옵션을 선택할 수 있는 드롭다운을 추가하게 합니다. 자세한 내용은 Node UI 요소를 참고하세요.
• noDataExpression: 불리언. 파라미터에 표현식 사용을 방지합니다. resource에는 항상 true여야 합니다.

오퍼레이션 오브젝트#

오퍼레이션 오브젝트는 리소스에서 사용 가능한 오퍼레이션을 정의합니다.

• displayName: 문자열. 항상 Options여야 합니다.
• name: 문자열. 항상 option이어야 합니다.
• type: 문자열. n8n이 사용할 UI 요소와 기대하는 입력 타입을 알립니다. 예를 들어, dateTime은 n8n이 날짜 선택기를 추가하게 합니다. 자세한 내용은 Node UI 요소를 참고하세요.
• noDataExpression: 불리언. 파라미터에 표현식 사용을 방지합니다. operation에는 항상 true여야 합니다.
• options: 오브젝트 배열. 각 오브젝트는 라우팅, 사용하는 REST 동사 등 오퍼레이션의 동작을 설명합니다. options 오브젝트에는 다음이 포함됩니다:
  • name. 문자열.
  • value. 문자열.
  • action: 문자열. 이 파라미터는 리소스와 오퍼레이션을 결합합니다. 항상 포함해야 합니다. n8n이 향후 버전에서 이를 사용할 예정입니다. 예를 들어, "Card" 리소스와 "Get all" 오퍼레이션이 있다면 액션은 "Get all cards"가 됩니다.
  • description: 문자열.
  • routing: 요청 세부 정보를 포함하는 오브젝트.

추가 필드 오브젝트#

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

오브젝트에는 다음이 포함되어야 합니다:

displayName: 'Additional Fields',
name: 'additionalFields',
// UI 요소 타입
type: ''
placeholder: 'Add Field',
default: {},
displayOptions: {
  // 이 필드를 사용 가능하게 할 리소스와 오퍼레이션 설정
  show: {
    resource: [
      // 리소스 이름
    ],
    operation: [
      // 오퍼레이션 이름
    ]
  },
}

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