---
title: データのインポート/エクスポート
info: "データのインポートとエクスポートの方法を学びましょう。"
image: /images/user-guide/import-export-data/cloud.png
sectionInfo: オープンソースCRMであるTwentyを発見してください。
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

<Frame>
  <img src="/images/user-guide/import-export-data/cloud.png" alt="Header" />
</Frame>

## データをインポート

- .csv、.xlsx、.xlsファイルを使用してどのオブジェクトのデータでもインポートできます。
- アップロードする各ファイルには、**一種類のオブジェクトのみ**を含める必要があります（例: "人"のレコードのみ）。
- インポート機能を使用して、**レコードを作成または更新**することができます。

### Download a sample file to match the expected formatting

1. インポートするオブジェクトのビューに移動します。
2. 右上の`⋮`アイコンをクリックして、`レコードをインポート`を選択します。
3. `サンプルファイルをダウンロード`をクリックします。

### CSVの準備

ファイルをアップロードする前にチェックすべき項目がいくつかあります。

- レコード数を**1ファイルあたり10,000件以下**に制限してください。
- ファイルから**重複を削除**してください。
  - `人` の一意性はデフォルトで `id` と `メール` によって設定されています。 データモデルを設定する際に、`人` から独自のフィールドを一意として定義することもできます。
  - `企業` の一意性はデフォルトで `id` と `ドメイン` によって設定されています。 データモデルを設定する際に、`企業` から独自のフィールドを一意として定義することもできます。
  - その他のオブジェクトを含むカスタムオブジェクトでは、いくつかのフィールドを一意として定義することができます。 ファイルを準備する際には重複がないように注意してください。
- ドメインをアップロードする際は、`https://domain.com`という構文を使用することをお勧めします。これは、メールボックスやカレンダーと連携する際にコネクターで使用されるものです。
- 関連レコードの一意のフィールドの1つを提供することで、**オブジェクト間の関係をインポート**することができます。
  - 例: 人を会社に紐付けたい場合。 ファイルに、会社の`id`または`ドメイン` を含む列を追加してください。 アップロード中にこのフィールドをマッピングすることができます。
    <Warning>

**重要な注意事項:**

- Twenty におけるオブジェクト間の関係は「一対多」です。 つまり、オブジェクトAの各レコードはオブジェクトBの複数のレコードに関連付けることができます。しかし、オブジェクトBの各レコードはオブジェクトAのレコード1つのみに属することができます。  そして1人は1つの会社にしか所属できません。

- インポート機能を通じて関係をアップロードするには、関連するオブジェクトの`id`（またはその他の一意フィールド）を「多対側」のレコードを含むファイルに提供する必要があります。  
  例えば、人物レコードをアップロードする際は会社の`id`または`ドメイン`を提供します。 会社のファイルをアップロードする際は、人物の`id`（または`メール`）を提供しません。
  </Warning>

### ファイルをアップロード

1. インポートするオブジェクトのビューに移動します。
2. 右上の`⋮`アイコンをクリックして、`レコードをインポート`を選択します。
3. `ファイルを選択`をクリックします。
4. フィールドのマッピングを確認します。

- すべてをインポートする必要はなく、"マッピングしない" オプションを選ぶことができます。
- 関係については、一意のフィールドの1つだけをマッピングすることをお勧めします。
- 選択タイプとマルチ選択タイプのフィールドの値もマッピングする必要があるかもしれません。

5. `次のステップ`をクリックし、`エラーのある行を確認`します。 問題のあるセルはハイライトされています。 **その場でセルを更新するか、行を削除することができます**。
6. 完了したら、`確認`をクリックします。

<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}}/>

### インポートFAQ

<details><summary>ファイルのアップロード時に重複問題が発生した場合、どうすればいいですか？</summary>

この記事の上記の**CSVの準備**セクションを参照してください。それには重複と見なされる内容についてのガイドラインが含まれています。

</details>

<details><summary>オブジェクト間の関係をインポートできますか？</summary>

はい、この記事の上記の **CSVの準備** セクションを参照してください。関係のインポートに関するセクションが含まれています。

</details>

<details><summary>インポート機能を使用して既存のレコードを更新できますか？</summary>

はい、インポート機能を使用して既存のレコードを更新することができます。 レコードを再アップロードする際には、id（またはその他の一意のフィールド）を必ず提供してください。

</details>

<details><summary>ほかのツールから`id`を移行出来ますか？</summary>

はい. 他のツールからの`id`を含む独自のフィールドをデータモデルで一意として定義する必要があります。 `id`という名前はTwentyのidに使用されているため保護されていますので、ご注意ください。  
このフィールドを使用してオブジェクト間の関係を作成する場合は、この記事の上記の **CSVの準備** セクションを参照してください。 関係のインポートに関するセクションが含まれています。

</details>

## データをエクスポート

ほとんどのオブジェクトからデータをダウンロードでき、エクスポートあたり最大20,000レコードです。
オブジェクトからデータをエクスポートするには:

1. オブジェクトインデックスに移動します。
2. データエクスポートのビューを選択します。 ダウンロードしたい列を追加または非表示にして、必要なレコードをフィルタして見つけます。
3. 右上の`⋮`アイコンをクリックしてサイドパネルにアクセスします。
4. `ビューをエクスポート`をクリックします。
5. CSVデータの保存先を選択します。 エクスポートが大量のレコード数の場合、時間がかかることがあります。

<VimeoEmbed videoId="926226303" title="Video demonstration" />

