n8n-nodes-dooray

n8n에서 사용할 수 있는 Dooray 노드입니다. Dooray의 프로젝트 관리, 메신저, 캘린더 API와 연동할 수 있습니다.

주요 기능

이 노드를 통해 다음 기능들을 사용할 수 있습니다:

📁 프로젝트 관리

• 프로젝트 목록 조회: 접근 가능한 모든 프로젝트 정보 조회
• 프로젝트 상세 조회: 특정 프로젝트의 상세 정보 조회

✅ 업무 관리

• 업무 생성: 프로젝트에 새로운 업무 생성
• 업무 목록 조회: 프로젝트의 업무 목록을 다양한 필터 옵션으로 조회
  • 페이지네이션 (페이지, 개수)
  • 담당자, 참조자, 작성자 필터링
  • 태그, 마일스톤 필터링
  • 상태, 워크플로우 필터링
  • 생성일, 수정일, 마감일 필터링
  • 제목 검색 및 정렬 옵션
• 업무 상세 조회: 특정 업무의 상세 정보 조회
• 업무 수정: 기존 업무 정보 수정

💬 메신저

• 메시지 전송: 채널에 메시지 전송
• 메시지 목록 조회: 채널의 메시지 히스토리 조회

📅 캘린더

• 일정 생성: 새로운 캘린더 일정 생성
• 일정 조회: 캘린더의 일정 정보 조회

설치 방법

n8n 커뮤니티 노드 설치 가이드를 참고하여 설치하세요.

인증 설정

Dooray API 인증 정보를 설정해야 합니다:

1. API 토큰 발급

   • Dooray 관리자 페이지에서 API 토큰을 발급받으세요
   • 필요한 권한을 가진 토큰인지 확인하세요

2. n8n 인증 정보 설정

   • n8n에서 "Dooray API" 인증 타입을 선택하세요
   • API 토큰을 입력하세요

사용 방법

프로젝트 관리

1. Dooray 노드 추가
2. Resource: "Project" 선택
3. Operation: 원하는 작업 선택
   - Get Many: 프로젝트 목록 조회
   - Get: 특정 프로젝트 조회 (Project ID 필요)

업무 관리

1. Dooray 노드 추가
2. Resource: "Task" 선택
3. Operation: 원하는 작업 선택
   - Create: 새 업무 생성
   - Get Many: 업무 목록 조회 (다양한 필터 옵션 사용 가능)
   - Get: 특정 업무 조회
   - Update: 업무 수정
4. Project ID는 필수 입력 사항입니다

메신저

1. Dooray 노드 추가
2. Resource: "Message" 선택
3. Operation: "Send" 선택
4. Channel ID와 메시지 내용 입력

캘린더

1. Dooray 노드 추가
2. Resource: "Calendar" 선택
3. Operation: "Get Events" 선택
4. Calendar ID 입력

개발 환경 설정

필수 요구사항

• Node.js (최소 버전 20)
• npm
• git

개발 과정

1. 저장소 클론:

   git clone https://github.com/nhn/n8n-nodes-dooray.git
   cd n8n-nodes-dooray

2. 의존성 설치:

   npm install

3. 코드 검사:

   npm run lint
   npm run lintfix  # 자동 수정

4. 빌드:

   npm run build

파일 구조

이 노드는 유지보수를 위해 모듈화된 구조로 개발되었습니다:

nodes/Dooray/
├── Dooray.node.ts          # 메인 노드 파일
├── ProjectDescription.ts   # 프로젝트 관련 작업 정의
├── TaskDescription.ts      # 업무 관련 작업 정의
├── MessageDescription.ts   # 메신저 관련 작업 정의
├── CalendarDescription.ts  # 캘린더 관련 작업 정의
└── dooray.svg             # 노드 아이콘

credentials/
└── DoorayApi.credentials.ts # API 인증 정보 정의

자세한 모듈 구조는 MODULAR_STRUCTURE.md 문서를 참고하세요.

기여하기

버그 리포트나 기능 제안은 GitHub Issues를 통해 제출해주세요.

라이선스

MIT