Félix Malfait
882e9fd231
## Summary - Restructures the developer Extend documentation: moves API and Webhooks to top-level pages, creates dedicated Apps section with Getting Started, Building, and Publishing pages - Updates navigation structure (`docs.json`, `base-structure.json`, `navigation.template.json`) - Updates translated docs for all locales and LLMS.md references across app packages ## Test plan - [ ] Run `mintlify dev` locally and verify navigation structure - [ ] Check that all links in the Extend section work correctly - [ ] Verify translated pages render properly Made with [Cursor](https://cursor.com) --------- Co-authored-by: github-actions <github-actions@twenty.com>
210 lines
8.2 KiB
Plaintext
210 lines
8.2 KiB
Plaintext
---
|
|
title: 데이터 내보내기
|
|
description: Twenty에서 데이터를 내보내는 포괄적인 단계별 가이드.
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
## 개요
|
|
|
|
백업, 보고, 또는 마이그레이션을 위해 워크스페이스 데이터를 CSV로 내보내세요.
|
|
|
|
**사용 사례:**
|
|
|
|
* **정기 백업** — 데이터 사본을 보관하세요
|
|
* **외부 보고** — Excel, Google Sheets 또는 BI 도구에서 데이터를 분석하세요
|
|
* **마이그레이션** — 데이터를 다른 시스템으로 이동하세요
|
|
* **대량 업데이트** — 내보내고, 편집한 후, 다시 가져와 레코드를 업데이트하세요
|
|
|
|
## 알아두어야 할 사항
|
|
|
|
### 내보내기 제한
|
|
|
|
* 내보내기 1회당 **최대 20,000개 레코드**
|
|
* **표시된 열**만 내보내집니다
|
|
* **필터링된 레코드**만 내보내집니다(현재 보기 기준)
|
|
|
|
<Note>더 큰 내보내기(20,000개 이상의 레코드)에는 필터를 사용해 배치로 내보내거나 [API](/l/ko/developers/api)를 사용하세요.</Note>
|
|
|
|
### 권한
|
|
|
|
데이터를 내보내려면 **"Export CSV"** 권한이 필요합니다. 이 옵션이 없다면 워크스페이스 관리자에게 문의하세요.
|
|
|
|
## 1단계: 객체로 이동
|
|
|
|
내보내려는 객체로 이동하세요:
|
|
|
|
* **People** — 연락처
|
|
* **Companies** — 조직
|
|
* **Opportunities** — 거래
|
|
* **사용자 지정 객체** — 사용자가 생성한 모든 객체
|
|
|
|
## 2단계: 보기 구성
|
|
|
|
**중요:** 내보내기에는 현재 보기에서 보이는 내용만 포함됩니다.
|
|
|
|
### 열 추가/제거
|
|
|
|
1. **옵션 → 필드**를 클릭합니다(또는 열 끝의 **+**).
|
|
2. 내보내려는 필드를 선택하세요
|
|
3. 불필요한 필드의 선택을 해제하세요
|
|
|
|
### 레코드 필터링(선택 사항)
|
|
|
|
일부 데이터만 필요하다면:
|
|
|
|
1. **필터**를 클릭합니다
|
|
2. 필터 조건을 추가하세요(예: "Created date > January 1, 2024")
|
|
3. 조건과 일치하는 레코드만 내보내집니다
|
|
|
|
### 레코드 정렬(선택 사항)
|
|
|
|
1. 정렬하려면 열 헤더를 클릭하세요
|
|
2. 내보내기는 정렬 순서를 따릅니다
|
|
|
|
<Note>**내보내기 전용 보기를 만드세요.** 내보내기에 맞게 구성한 보기를 저장해 매번 다시 구성할 필요가 없도록 하세요.</Note>
|
|
|
|
## 3단계: 데이터 내보내기
|
|
|
|
1. 테이블 오른쪽 상단의 **⋮** 아이콘을 클릭하세요
|
|
2. **Export view**를 선택하세요
|
|
3. CSV 파일을 저장할 위치를 선택하세요
|
|
4. 다운로드가 완료될 때까지 기다리세요
|
|
|
|
## 내보내지는 내용
|
|
|
|
| 포함됨 | 포함되지 않음 |
|
|
| --------------- | ----------- |
|
|
| 모든 표시된 열 | 숨김 열 |
|
|
| 현재 필터와 일치하는 레코드 | 필터로 제외된 레코드 |
|
|
| 사용자 지정 필드 값 | 보기에 없는 필드 |
|
|
| 레코드 ID | 파일 첨부 |
|
|
| 관계 ID | 이미지 |
|
|
|
|
### 관계 필드
|
|
|
|
관계 ID는 관계의 **"many" 측**에서만 내보내집니다:
|
|
|
|
* **People 내보내기**에는 `companyId` 열이 포함됩니다(People → Company 관계)
|
|
* **Companies 내보내기**에는 `peopleIds`가 포함되지 않습니다(Companies는 "one" 측입니다)
|
|
|
|
즉, People 내보내기를 사용해 다시 가져오면서 Company 연결을 유지할 수 있지만, 관계를 다시 만들려면 Companies 이후에 People을 다시 가져와야 합니다.
|
|
|
|
## 용도별 내보내기
|
|
|
|
### 백업용
|
|
|
|
1. **모든 필드**가 보이도록 보기를 만들세요
|
|
2. 모든 레코드를 포함하려면 모든 필터를 제거하세요
|
|
3. 각 객체 유형을 별도로 내보내세요
|
|
4. 내보낸 파일을 안전한 위치에 보관하세요
|
|
5. 반복 알림을 설정하세요(매주/매월)
|
|
|
|
### 외부 보고용
|
|
|
|
1. 분석에 필요한 필드만 포함하세요
|
|
2. 관련 데이터에 집중할 수 있도록 필터를 적용하세요
|
|
3. 분석할 필드로 정렬하는 것을 고려하세요
|
|
|
|
### 대량 업데이트용
|
|
|
|
1. 업데이트하려는 레코드를 내보내세요
|
|
2. 고유 식별자(`email`, `domain` 또는 `id`)를 포함하세요
|
|
3. 내보낸 파일을 편집하세요
|
|
4. 다시 가져와 레코드를 업데이트하세요
|
|
참고: [기존 레코드를 업데이트하는 방법](/l/ko/user-guide/data-migration/how-tos/update-existing-records-via-import)
|
|
|
|
### 마이그레이션용
|
|
|
|
다른 시스템으로 마이그레이션하기 위해 내보내는 경우:
|
|
|
|
1. **각 객체를 개별적으로 내보내세요** — People, Companies, Opportunities 등
|
|
2. **ID 필드를 포함하세요** — 관계를 유지하는 데 도움이 됩니다
|
|
3. **필드 매핑을 문서화하세요** — Twenty의 필드가 대상 시스템에 어떻게 매핑되는지 기록하세요
|
|
|
|
## 대용량 데이터셋 처리(20,000개 이상 레코드)
|
|
|
|
내보내기 한도는 20,000개 레코드입니다. 더 큰 데이터셋의 경우:
|
|
|
|
### 옵션 1: 배치로 내보내기
|
|
|
|
1. 필터를 추가하세요(예: "Created date" 범위)
|
|
2. 첫 번째 배치를 내보내세요
|
|
3. 필터를 변경하세요
|
|
4. 다음 배치를 내보내세요
|
|
5. 스프레드시트에서 파일을 결합하세요
|
|
|
|
**배치용 예시 필터:**
|
|
|
|
* 날짜 범위별(1월, 2월, 3월...)
|
|
* 소유자별(팀원 A, 팀원 B...)
|
|
* 상태별(활성, 비활성...)
|
|
|
|
### 옵션 2: API 사용
|
|
|
|
API에는 레코드 수 한도가 없습니다:
|
|
|
|
1. API 키를 **설정 → 개발자**에서 발급받으세요
|
|
2. GraphQL API를 사용해 레코드를 쿼리하세요
|
|
3. 애플리케이션에서 결과를 처리하세요
|
|
|
|
참고: [API 문서](/l/ko/developers/api)
|
|
|
|
## 팁 및 모범 사례
|
|
|
|
### 내보내기용 보기 만들기
|
|
|
|
내보내기에 맞게 구성한 보기를 저장하세요:
|
|
|
|
1. 열과 필터를 구성하세요
|
|
2. **보기 옵션** → **새 보기로 저장**을 클릭하세요
|
|
3. "Export - [Purpose]"로 이름을 지정하세요
|
|
|
|
### 내보낸 파일 보호
|
|
|
|
내보낸 파일에는 민감한 데이터가 포함될 수 있습니다:
|
|
|
|
* 안전한 위치에 보관하세요
|
|
* 더 이상 필요하지 않은 내보낸 파일은 삭제하세요
|
|
* 내보낸 파일을 공유할 때 주의하세요
|
|
|
|
### 내보내기 전 확인 사항
|
|
|
|
<Check>올바른 열이 표시되어 있습니다</Check>
|
|
<Check>필터가 올바르게 설정되어 있습니다(전체 내보내기의 경우 제거)</Check>
|
|
<Check>내보내기 권한이 있습니다</Check>
|
|
|
|
## FAQ
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="내보낸 파일에 일부 열이 없는 이유는 무엇인가요?">
|
|
표시된 열만 내보내집니다. 내보내기 전에 **옵션 → 필드**에서 필요한 열을 추가하세요.
|
|
</Accordion>
|
|
|
|
<Accordion title="내보낸 파일에 모든 레코드가 포함되지 않은 이유는 무엇인가요?">
|
|
필터를 확인하세요. 내보내기에는 현재 보기의 필터와 일치하는 레코드만 포함됩니다. 모든 레코드를 내보내려면 필터를 제거하세요.
|
|
</Accordion>
|
|
|
|
<Accordion title="20,000개 이상의 레코드를 내보낼 수 있나요?">
|
|
단일 내보내기로는 불가능합니다. 필터를 사용해 배치로 내보내거나, 더 큰 데이터셋에는 API를 사용하세요.
|
|
</Accordion>
|
|
|
|
<Accordion title="내보낸 파일의 형식은 무엇인가요?">
|
|
CSV(쉼표로 구분된 값). Excel, Google Sheets 또는 어떤 스프레드시트 애플리케이션에서도 열 수 있습니다.
|
|
</Accordion>
|
|
|
|
<Accordion title="관계 ID가 포함되나요?">
|
|
예. 다만 관계의 "many" 측에서만 포함됩니다. 예를 들어 People 내보내기에는 `companyId`가 포함되지만, Companies 내보내기에는 people ID가 포함되지 않습니다.
|
|
</Accordion>
|
|
|
|
<Accordion title="내보내기를 자동화할 수 있나요?">
|
|
UI만으로는 불가능합니다. API를 사용해 자동화된 내보내기 워크플로우를 구축하세요.
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## 다음 단계
|
|
|
|
* [기존 레코드를 업데이트하는 방법](/l/ko/user-guide/data-migration/how-tos/update-existing-records-via-import) — 내보낸 파일을 편집한 뒤 다시 가져오세요
|
|
* [API로 데이터 가져오는 방법](/l/ko/user-guide/data-migration/how-tos/import-data-via-api) — 대용량 데이터셋용
|
|
* [API 문서](/l/ko/developers/api) — 맞춤 내보내기 워크플로우를 구축하세요
|