원드라이브
Microsoft OneDrive 파일을 가져오는 노드입니다.
설명
원드라이브 노드는 Microsoft 계정의 OneDrive 파일을 탐색하고, 선택한 파일을 캔버스로 가져올 수 있는 노드입니다.
파일 피커 모달에서 폴더 탐색, 검색, 파일 타입 필터, 다중 선택이 가능하며, 선택한 파일은 백엔드에서 다운로드하여 S3에 업로드한 뒤 다음 노드로 전달됩니다.
Microsoft 계정 연동
사용하려면 먼저 Microsoft 계정을 연동해야 합니다.
- 노드를 캔버스에 추가합니다
- Microsoft 로그인하여 연결하기 버튼을 클릭합니다
- Microsoft 계정 로그인 창에서 계정을 선택합니다
- AI Canvas의 OneDrive 접근 권한을 허용합니다
- 연동이 완료되면 파일 피커 모달을 사용할 수 있습니다
단일 계정 정책
Microsoft 계정 연동은 사용자당 하나의 계정만 등록됩니다. 동일한 연동으로 아웃룩 메일 · 아웃룩 캘린더 · SharePoint · 팀즈 노드도 함께 사용할 수 있습니다.
포트 구성
입력 포트
없음
출력 포트
- 데이터셋: 가져온 OneDrive 파일 데이터 (
file_name,file_path컬럼). 후속 노드(PDF Reader · Data Table 등)가file_path로 파일을 바로 처리할 수 있습니다.
속성
최대 결과 수
파일 피커에서 가져올 파일의 최대 개수를 설정합니다. (기본값: 1,000)
시간대
파일 날짜/시간 표시에 사용할 시간대를 선택합니다. (예: KST)
폴더 제외
파일 목록에서 폴더를 제외할지 여부를 설정합니다.
파일 피커
노드를 우클릭 → OneDrive 파일 선택을 클릭하면 파일 피커 모달이 열립니다.
폴더 탐색
- 폴더를 클릭하면 해당 폴더 내부로 이동합니다
- 상단 breadcrumb으로 현재 경로를 확인하고 상위 폴더로 돌아갈 수 있습니다
검색
- 상단 검색창에서 파일명으로 검색할 수 있습니다
정렬
- 수정일순 (기본값): 최근 수정된 파일이 먼저 표시됩니다
- 이름순: 파일명 알파벳 순서로 정렬됩니다
파일 타입 필터
지원하는 파일 타입별로 필터링할 수 있습니다:
| 파일 타입 | 포맷 |
|---|---|
| Word | .docx, .doc |
| Excel | .xlsx, .xls, .csv |
| PowerPoint | .pptx, .ppt |
.pdf | |
| 이미지 | .jpg, .png, .gif, .webp 등 |
| 텍스트 | .txt, .md, .json, .xml 등 |
다중 선택
- 체크박스로 여러 파일을 동시에 선택할 수 있습니다
- 전체 선택 체크박스를 사용할 수 있습니다
사용 방법
- 노드를 캔버스에 추가합니다
- Microsoft 로그인하여 연결하기 버튼을 클릭해 Microsoft 계정을 연동합니다
- 노드 우클릭 → OneDrive 파일 선택으로 파일 피커 모달을 엽니다
- 폴더를 탐색하거나 검색하여 원하는 파일을 선택합니다
- Select files 버튼을 클릭해 선택을 확정합니다
- 실행하기 버튼을 클릭합니다
- 출력 포트에서 가져온 파일 데이터를 확인할 수 있습니다
주의사항
계정 연동 필수
원드라이브 노드를 사용하려면 Microsoft 계정 연동이 필요합니다.
파일 처리 방식
선택한 파일은 백엔드에서 다운로드하여 S3에 업로드한 뒤 다음 노드로 전달됩니다. 파일 크기에 따라 처리 시간이 달라질 수 있습니다.