표준 매개변수

이들은 모든 노드 유형에 대해 동일한 node base file의 표준 매개변수입니다.

displayName

문자열 | 필수

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

name

문자열 | 필수

객체의 내부 이름입니다. 노드의 다른 곳에서 참조하는 데 사용됩니다.

icon

문자열 또는 객체 | 필수

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

아이콘 파일 이름을 문자열로 제공하거나, 라이트 및 다크 모드에 대한 다양한 아이콘을 처리하기 위해 객체로 제공할 수 있습니다.
아이콘이 라이트 및 다크 모드에서 모두 작동한다면 file:로 시작하는 문자열을 사용하여 아이콘 파일의 경로를 나타냅니다. 예를 들어:

icon: 'file:exampleNodeIcon.svg'

라이트 및 다크 모드에 대한 서로 다른 아이콘을 제공하려면 light 및 dark 속성을 가진 객체를 사용합니다. 예를 들어:

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

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

Font Awesome 아이콘을 직접 참조하지 마세요

Font Awesome 아이콘을 사용하려면, 아이콘을 다운로드하여 직접 삽입해야 합니다.

group

문자열 배열 | 필수

워크플로우가 실행될 때 노드의 동작 방식을 n8n에 알려줍니다. 선택 사항은 다음과 같습니다:

• trigger: 노드가 트리거를 기다립니다.
• schedule: 노드가 타이머가 만료될 때까지 기다립니다.
• input, output, transform: 현재는 효과가 없습니다.
• 빈 배열 []. trigger나 schedule이 필요하지 않을 경우 기본 옵션으로 사용합니다.

description

문자열 | 필수

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

defaults

객체 | 필수

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

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

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

forceInputNodeExecution

부울 | 선택

다중 입력 노드를 구축할 때, 노드가 실행되기 전에 모든 분기의 모든 이전 노드를 실행하도록 강제할 수 있습니다. 기본값은 false (하나의 입력 분기만 실행하라는 의미)입니다.

inputs

문자열 배열 | 필수

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

outputs

문자열 배열 | 필수

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

requiredInputs

정수 또는 배열 | 선택

다중 입력 노드에 사용됩니다. 노드가 실행되기 전에 데이터가 있어야 할 입력을 숫자로 지정합니다 (해당 분기가 실행되어야 합니다).

credentials

객체 배열 | 필수

이 매개변수는 n8n에 자격 증명 옵션을 알려줍니다. 각 객체는 인증 유형을 정의합니다.

객체는 다음을 포함해야 합니다:

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

requestDefaults

객체 | 필수

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

이 객체는 다음을 포함해야 합니다:

• baseURL: API 기본 URL입니다.

다음도 추가할 수 있습니다:

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

properties

객체 배열 | 필수

이 객체는 사용자 입력을 받을 수 있는 필수 및 선택적 필드를 설정하는 리소스 및 운영 객체를 포함합니다.

리소스 객체

리소스 객체에는 다음 매개변수가 포함됩니다:

• displayName: 문자열. 항상 Resource여야 합니다.
• name: 문자열. 항상 resource여야 합니다.
• type: 문자열. n8n에 어떤 UI 요소를 사용할지와 어떤 입력 유형을 예상하는지를 알립니다. 예를 들어, options는 n8n이 사용자가 하나의 옵션을 선택할 수 있는 드롭다운을 추가하게 합니다. 더 많은 정보는 Node UI elements를 참조하세요.
• noDataExpression: 불리언. 매개변수에 대해 표현식을 사용하는 것을 방지합니다. 항상 resource에 대해서는 true여야 합니다.

운영 객체

운영 객체는 리소스에서 사용 가능한 운영을 정의합니다.

• displayName: 문자열. 항상 Options이어야 합니다.
• name: 문자열. 항상 option이어야 합니다.
• type: 문자열. n8n에 어떤 UI 요소를 사용할지와 어떤 입력 유형을 예상하는지를 알립니다. 예를 들어, dateTime은 n8n이 날짜 선택기를 추가하게 합니다. 더 많은 정보는 Node UI elements를 참조하세요.
• 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 elements를 참조하세요.