커뮤니티 node UX 가이드라인

n8n 커뮤니티 node의 UX 가이드라인에 대한 레퍼런스 문서입니다.

node의 UI가 검증된 커뮤니티 node 후보가 되려면 이 가이드라인을 준수해야 합니다. 자격 증명 # API 키 및 민감한 자격 증명은 항상 비밀번호 필드여야 합니다. OAuth # 사용 가능한 경우 항상 OAuth 자격 증명을 포함합니다. Node 구조 # 포함할 오퍼레이션 # 각 리소스 타입에 대해 CRUD 오퍼레이션을 포함하도록 노력합니다. 각 리소스의 node에 일반적인 오퍼레이션을 포함하도록 노력합니다. n8n은 일관된 경험을 유지하고 사용자가 리소스에 대한 기본 오퍼레이션을 수행할 수 있도록 일부 CRUD 오퍼레이션을 사용합니다. 권장 오퍼레이션은 다음과 같습니다: Create Create or Update (Upsert) Delete Get Get Many: 일부 필터링 또는 검색이 가능할 때도 사용 Update 참고: 이 오퍼레이션은 리소스 자체 또는 리소스 내의 엔티티(예: Google Sheet의 행)에 적용될 수 있습니다. 리소스 내의 엔티티에 대해 오퍼레이션하는 경우 오퍼레이션 이름에 엔티티 이름 을 명시해야 합니다. node와 리소스에 따라 이름이 달라질 수 있습니다. 자세한 내용은 다음 가이드라인을 확인하세요. Resource Locator # 가능한 경우 항상 Resource Locator 컴포넌트를 사용합니다. 이는 사용자에게 훨씬 더 나은 UX를 제공합니다. Resource Locator 컴포넌트는 단일 항목을 선택해야 할 때 가장 유용합니다. Resource Locator 컴포넌트의 기본 옵션은 From list (사용 가능한 경우)여야 합니다. 다른 node와의 일관성 # UX 일관성 유지: n8n은 UX를 일관되게 유지하려고 합니다. 이는 기존 UX 패턴, 특히 최신 신규 또는 개선된 node에서 사용하는 패턴을 따르는 것을 의미합니다. 유사한 node 확인: 예를 들어, 데이터베이스 node를 작업 중인 경우 Postgres node를 확인하는 것이 좋습니다. 정렬 옵션 # 사용자에게 정렬 옵션을 제공하여 특정 "Get Many" 오퍼레이션을 향상시킬 수 있습니다. "Options" collection 아래에 전용 collection에 정렬을 추가합니다. Airtable Record:Search 예시를 따르세요. Node 기능 # 오퍼레이션 출력 삭제 # 항목(레코드나 행 등)을 삭제할 때 단일 오브젝트가 있는 배열 {"deleted": true} 를 반환합니다. 이는 삭제가 성공했다는 사용자 확인이며 해당 항목이 다음 node를 트리거합니다. 출력 필드 단순화 # 일반 node: 'Simplify' 파라미터 # 엔드포인트가 10개 이상의 필드로 데이터를 반환하는 경우, 최대 10개 필드로 단순화된 출력 버전을 반환하는 "Simplify" 불리언 파라미터를 추가합니다. n8n의 주요 문제 중 하나는 데이터 크기이며 Simplify 파라미터는 데이터 크기를 줄여 해당 문제를 제한합니다. 단순화된 node에서 출력할 가장 유용한 필드를 선택하고 가장 많이 사용되는 것을 맨 위에 정렬합니다. Simpl