Excel 통합 없이 FlowHunt에 Excel 파일 업로드하기: 단계별 CSV 가져오기 및 문제 해결 가이드

FlowHunt의 CSV 업로드 기능이란? 언제 사용해야 하나요?

FlowHunt는 데이터 가져오기를 위한 다양한 방법을 제공합니다. 직접 통합(예: Excel, Google Sheets) 또는 수동 파일 업로드가 있습니다. Excel 문서 한 개나 소수의 파일만 업로드하고 싶고, 전체 Excel 통합을 설정하고 싶지 않을 때 수동 CSV 업로드가 가장 간편합니다. 일회성 데이터 가져오기, 새로운 워크플로우를 빠르게 테스트하거나, Microsoft 계정 연결 없이 사용하고 싶을 때 특히 유용합니다.

CSV 업로드 기능을 이용하면 Excel 스프레드시트(.xlsx 또는 .xls)를 범용 형식인 CSV(콤마로 구분된 값) 파일로 변환하여 FlowHunt 대시보드에서 바로 업로드할 수 있습니다. 단, 이 방식은 실시간 동기화가 되지 않으므로, 원본 Excel 파일을 변경할 경우 반드시 다시 내보내고 재업로드해야 합니다.

FlowHunt용 Excel 파일을 CSV로 내보내는 방법

Excel 데이터를 CSV로 내보내면 FlowHunt의 업로드 요구사항에 맞출 수 있습니다. Windows와 Mac 모두에서 사용할 수 있는 단계별 가이드는 다음과 같습니다:

1. Excel 파일 열기: Microsoft Excel 또는 호환되는 스프레드시트 편집기(Google Sheets, LibreOffice Calc 등)에서 파일을 엽니다.
2. 데이터 정리:
   • 불필요한 서식, 병합된 셀, 수식, 특수문자는 제거합니다.
   • 모든 컬럼에 일관성 있는 헤더가 있는지 확인합니다.
   • 업로드할 데이터만 남겨둡니다.
3. CSV로 내보내기:
   • Excel: 파일 > 다른 이름으로 저장을 클릭합니다.
   • 저장할 폴더를 선택합니다.
   • ‘파일 형식’에서 CSV (콤마로 분리)를 선택합니다.
   • 파일명을 입력하고 저장을 누릅니다.
   • 메시지가 나오면 현재 시트만 저장을 선택하세요(여러 시트가 있다면 각 시트를 별도 CSV로 저장).
   • Google Sheets의 경우: 파일 > 다운로드 > Comma-separated values (.csv, 현재 시트)를 선택합니다.
4. CSV 파일 확인:
   • 텍스트 에디터(메모장, VS Code 등)로 열어 이상한 문자, 불필요한 콤마, 인코딩 문제 등이 없는지 확인합니다.
   • 첫 번째 행이 컬럼 헤더이고, 모든 행이 같은 컬럼 수를 가지는지 점검합니다.
5. UTF-8 인코딩 사용:
   • 일부 시스템은 기본적으로 다른 인코딩을 사용하는데, 한글 등 비영어권 문자가 있다면 반드시 UTF-8로 저장하세요.

통합 없이 CSV 파일을 FlowHunt에 업로드하는 방법

CSV로 정리된 데이터를 FlowHunt에 업로드하는 방법은 매우 간단합니다:

1. FlowHunt 대시보드에 로그인: FlowHunt 로그인
2. 데이터 업로드 또는 지식 소스 메뉴로 이동 (워크스페이스에 따라 ‘CSV 업로드’, ‘데이터 소스 추가’ 등으로 표시될 수 있습니다).
3. ‘업로드’ 또는 ‘파일 선택’ 버튼 클릭.
4. 컴퓨터에서 CSV 파일을 선택하고 업로드를 확인합니다.
5. 업로드 및 처리 완료까지 대기. 파일이 클 경우 진행바 또는 완료 메시지가 표시됩니다.
6. FlowHunt에서 가져온 데이터 확인: 데이터가 정상적으로 표시되는지 확인합니다.

비주얼 가이드가 필요하다면 공식 문서를 참고하세요:

• FlowHunt CSV 출력 문서
• CSV 문서 검색 컴포넌트

원본 Excel 문서를 바꿀 때 FlowHunt에서 자동으로 업데이트되나요?

수동 CSV 업로드 방식에서는 FlowHunt가 각 업로드를 ‘고정된 스냅샷’으로 인식합니다. 즉,

• 자동 동기화 불가: 원본 Excel(또는 다운로드한 CSV)을 수정해도 FlowHunt 내 데이터가 자동으로 바뀌지 않습니다.
• 수동 재업로드 필요: Excel 문서를 수정할 때마다 다시 내보내고 업로드해야 최신 데이터로 갱신됩니다.
• 자주 업데이트가 필요하다면 통합 기능 고려: 자동 동기화가 필요하다면 FlowHunt의 Excel 통합을 설정하는 것이 좋습니다.

CSV 파일 업로드 시 ‘API 실패’ 오류가 발생할 때 어떻게 하나요?

‘API 실패’ 오류는 보통 파일 형식, 인코딩, 크기 등과 관련된 문제 때문입니다. 다음과 같이 점검해보세요.

주요 원인 및 해결 방법

• 파일 형식 문제:

  • 병합된 셀, 숨겨진 컬럼, 특수 서식 등이 원본 Excel에 있으면 안 됩니다.
  • 모든 행이 헤더와 동일한 컬럼 수를 가져야 합니다.
  • 수식이나 지원되지 않는 문자가 없어야 합니다.

• CSV 인코딩 문제:

  • FlowHunt는 CSV 파일의 UTF-8 인코딩을 요구합니다. 한글 등 특수문자가 있다면 반드시 UTF-8로 저장하세요.
  • 텍스트 에디터에서 ‘다른 이름으로 저장’을 선택해 UTF-8로 저장하세요.

• 파일 크기 제한:

  • FlowHunt 공식 문서 또는 요금제 안내에서 파일 최대 크기와 행 수 제한을 확인하세요.
  • 더 작은 샘플 파일로 업로드 테스트를 해보세요.

• 구분자 및 줄바꿈:

  • CSV가 콤마(,)로 구분되어 있는지 확인하세요(세미콜론, 탭 등은 사용 불가).
  • 줄바꿈(LF 또는 CRLF)이 일관되어야 합니다.

• 파일 손상 또는 업로드 오류:

  • Excel 또는 Google Sheets에서 다시 CSV로 다운로드해보세요.
  • 파일명을 변경해서 다시 업로드해보세요.

단계별 문제 해결 체크리스트

1. CSV 파일을 텍스트 에디터로 열어 다음을 점검합니다:
   • 끝에 불필요한 빈 줄이 있는지
   • 컬럼 수가 일치하지 않는 행이 있는지
   • 특이하거나 인식되지 않는 문자가 있는지
2. 온라인 CSV 검사 도구로 파일 유효성을 확인해보세요(선택).
3. 큰 파일을 여러 개의 작은 파일로 나눠서 한 부분씩 업로드해 문제를 진단하세요.
4. 브라우저 캐시 지우기 혹은 다른 브라우저 사용으로 세션 문제를 점검하세요.
5. FlowHunt에서 제공하는 에러 로그나 메시지를 확인해 구체적인 원인을 찾아보세요.

이 단계들로도 해결이 안 된다면, 파일 복사본을 저장하고, 오류 상황과 시도한 내용을 정리해 FlowHunt 지원팀에 문의하세요.

추가 도움말 또는 공식 문서는 어디서 볼 수 있나요?

• FlowHunt CSV 출력 문서
• CSV 문서 검색 컴포넌트
• FlowHunt 지원 문의
• FlowHunt 지식 베이스

지속적으로 기술적 문제가 발생한다면, CSV 파일과 함께 문제 상황을 자세히 설명하여 FlowHunt 지원팀에 문의하시면 전문가의 도움을 받으실 수 있습니다.