데이터 Import
외부 서비스의 데이터를 워크스페이스로 가져오는 Import 기능을 알아보세요.
Import 기능이란
Import는 외부 서비스에 저장된 데이터를 슈츠 워크스페이스의 데이터모델로 한 번에 가져오는 기능입니다. 커머스 플랫폼의 주문/상품 데이터, 이메일 데이터 등을 별도의 워크플로우 설계 없이 클릭 몇 번으로 가져올 수 있습니다.
Import는 내부적으로 워크플로우를 자동 생성하고 실행하는 방식으로 동작합니다. 사용자는 복잡한 파이프라인을 직접 구성할 필요 없이, 미리 정의된 Import 레시피를 선택하기만 하면 됩니다.
지원 소스 및 레시피
Import는 현재 다음 서비스를 지원합니다. 각 서비스별로 가져올 수 있는 데이터 종류(레시피)가 사전 정의되어 있습니다.
카페24
| 레시피 | 설명 |
|---|---|
| 상품 | 카페24 쇼핑몰의 전체 상품을 가져옵니다 |
| 주문 | 카페24 쇼핑몰의 전체 주문을 가져옵니다 |
| 고객 | 카페24 쇼핑몰의 전체 고객을 가져옵니다 |
| 카테고리 | 카페24 쇼핑몰의 전체 카테고리를 가져옵니다 |
| 쿠폰 | 카페24 쇼핑몰의 전체 쿠폰을 가져옵니다 |
| 브랜드 | 카페24 쇼핑몰의 전체 브랜드를 가져옵니다 |
| 공급사 | 카페24 쇼핑몰의 전체 공급사를 가져옵니다 |
| 리뷰 | 카페24 쇼핑몰의 전체 리뷰를 가져옵니다 |
네이버 커머스 (스마트스토어)
| 레시피 | 설명 |
|---|---|
| 주문 | 최근 90일간의 주문을 가져옵니다 (24시간 단위 조회) |
| 상품 | 전체 상품을 가져옵니다 |
| 클레임 | 취소/반품/교환 클레임을 가져옵니다 |
네이버 커머스의 주문 조회는 API 특성상 최대 24시간 단위로만 조회할 수 있습니다. Import 시 자동으로 90일을 24시간 단위로 분할하여 순차 조회합니다.
Gmail
| 레시피 | 설명 |
|---|---|
| 메시지 | 최근 500건의 이메일을 가져옵니다 |
| 스레드 | 최근 500건의 대화 스레드를 가져옵니다 |
| 라벨 | 모든 Gmail 라벨을 가져옵니다 |
Import 레시피란
Import 레시피는 특정 서비스의 특정 데이터를 가져오기 위해 미리 정의된 파이프라인 템플릿입니다. 레시피에는 다음 정보가 포함됩니다.
- 소스 서비스: 어떤 외부 서비스에서 가져올지 (카페24, 네이버 커머스, Gmail)
- 데이터 종류: 어떤 리소스를 가져올지 (상품, 주문, 메시지 등)
- 파이프라인 구조: 데이터를 조회하고 데이터모델에 저장하는 워크플로우 노드 구성
레시피를 선택하면 슈츠가 자동으로 워크플로우를 생성하고 실행합니다. 사용자가 직접 워크플로우를 설계할 필요가 없습니다.
Import 실행 방법
워크스페이스 홈에서 진입
워크스페이스 홈으로 이동
워크스페이스 홈 화면 하단에 데이터 Import 섹션이 표시됩니다. 이 섹션에는 Import 레시피가 등록된 서비스가 카드 형태로 나열됩니다.
인증 상태 확인
각 서비스 카드 하단에 인증 상태가 표시됩니다.
| 상태 | 의미 |
|---|---|
| 연결됨 (초록) | 인증 완료, Import 가능 |
| 미확인 (주황) | 인증 정보가 있으나 테스트 전 |
| 인증 오류 (빨강) | 인증 정보가 유효하지 않음 |
| 인증 필요 (빨강) | 인증 정보가 등록되지 않음 |
인증 상태가 인증 필요 또는 인증 오류인 경우, 먼저 워크스페이스 설정에서 해당 서비스의 인증 정보를 등록해야 합니다.
서비스 카드 클릭
Import할 서비스 카드를 클릭하면 Import 대화상자가 열립니다.
레시피 선택
대화상자에 해당 서비스의 모든 레시피가 체크박스와 함께 표시됩니다. 기본적으로 모든 레시피가 선택되어 있습니다. 필요 없는 레시피의 체크를 해제하세요.
Import 시작
Import 시작 (N개) 버튼을 클릭하면 선택한 레시피가 순차적으로 실행됩니다.
다중 레시피 순차 실행
여러 레시피를 동시에 선택하면 순차적으로 하나씩 실행됩니다. 예를 들어, 카페24에서 상품, 주문, 고객을 동시에 선택하면 상품 Import가 완료된 후 주문 Import가 시작되고, 주문이 완료되면 고객 Import가 시작됩니다.
진행 중에는 현재 몇 번째 레시피가 실행 중인지 표시됩니다 (예: "2/3 레시피 실행 중: 주문").
진행률 확인
Import 실행 중에는 대화상자에서 실시간 진행 상황을 확인할 수 있습니다.
| 표시 정보 | 설명 |
|---|---|
| 진행 바 | 현재 레시피의 처리 진행률을 시각적으로 표시 |
| 처리 건수 | 현재까지 처리된 항목 수와 전체 항목 수 (예: 150/500 처리 중) |
| 레시피 진행 | 다중 레시피 실행 시 전체 레시피 중 현재 순번 (예: 2/3 레시피 실행 중) |
Import가 완료되면 완료 메시지가 표시됩니다. 오류가 발생한 경우 오류 메시지와 함께 다시 시도 버튼이 제공됩니다.
Import 카드 Dismiss (숨기기)
워크스페이스 홈의 Import 섹션에서 이미 Import를 완료했거나 사용하지 않을 서비스 카드를 숨길 수 있습니다.
- 서비스 카드에 마우스를 올리면 우측 상단에 닫기(X) 버튼이 나타납니다
- 닫기 버튼을 클릭하면 해당 서비스 카드가 Import 섹션에서 사라집니다
- 숨김 상태는 워크스페이스별로 브라우저에 저장되므로, 다른 브라우저에서는 다시 표시됩니다
모든 서비스 카드를 dismiss하면 Import 섹션 자체가 워크스페이스 홈에서 사라집니다.
Import 파이프라인 구조
Import는 내부적으로 다음과 같은 워크플로우 파이프라인을 자동 생성합니다. 서비스별로 구조가 다릅니다.
카페24 (getCount 지원 리소스)
수동 실행 → 건수 조회(getCount) → 페이지 배열 생성(Code) → 목록 조회(eachItem) → 데이터모델 저장
총 건수를 먼저 조회한 뒤 필요한 페이지 수를 계산하여 정확한 범위만 조회합니다.
카페24 (getCount 미지원 리소스: 리뷰)
수동 실행 → 페이지 배열 생성(Code, 고정 페이지) → 목록 조회(eachItem) → 데이터모델 저장
getCount API가 없는 리소스는 고정된 최대 페이지 수(20페이지)만큼 조회합니다.
네이버 커머스 (주문)
수동 실행 → 24시간 슬롯 생성(Code, 90일분) → 주문 상세 조회(eachItem) → 데이터모델 저장
주문 API의 24시간 조회 제한으로 인해 90일을 1일 단위(90개 슬롯)로 분할하여 순차 조회합니다.
네이버 커머스 (상품, 클레임)
수동 실행 → 페이지 배열 생성(Code, 고정 50페이지) → 목록 조회(eachItem) → 데이터모델 저장
Gmail
수동 실행 → 데이터 조회(getAll, 최대 500건) → 데이터모델 저장
Gmail API는 한 번에 최대 건수까지 반환하므로 별도의 페이지네이션이 필요 없습니다.
과거 데이터 일괄 가져오기
Import 기능은 서비스를 처음 연동할 때 기존에 축적된 데이터를 한 번에 가져오는 용도로 설계되었습니다.
- 카페24: 쇼핑몰에 등록된 전체 데이터를 가져옵니다 (상품, 주문, 고객 등)
- 네이버 커머스: 주문은 최근 90일, 상품과 클레임은 전체 데이터를 가져옵니다
- Gmail: 최근 500건의 메시지/스레드를 가져옵니다
Import는 일회성 대량 가져오기에 적합합니다. 이후 실시간으로 신규 데이터를 지속 동기화하려면 워크플로우의 트리거(웹훅, 스케줄 등)를 활용하세요.
주의 사항
- Import를 실행하려면 해당 서비스의 **인증 정보(Credential)**가 워크스페이스에 등록되어 있어야 합니다
- Import가 진행되는 동안 대화상자를 닫지 마세요. 진행 상황 추적이 중단될 수 있습니다
- 대량 데이터 Import 시 소요 시간이 길어질 수 있습니다. 네이버 커머스 주문의 경우 90일분 데이터를 순차 조회하므로 수 분이 소요될 수 있습니다
- Import 완료 후 가져온 데이터는 데이터모델에 자동 저장됩니다. 데이터모델 목록에서 확인할 수 있습니다
다음 단계
Import를 완료했다면:
- 마이그레이션 가이드 - 다른 도구에서 데이터 옮기기
- 워크플로우 - 가져온 데이터를 활용한 자동화 구축
- 데이터모델 - Import된 데이터 관리 및 활용