データのインポートとエクスポート¶

Odooでは、レポートの実行やデータの修正のためにデータのエクスポートやインポートが必要になることがあります。このドキュメントではOdooへのデータのエクスポートとインポートについて説明します。

Odooからデータをエクスポートする¶

データベースを使用する際、データを別ファイルにエクスポートする必要がある場合があります。Odooは各アプリケーションで正確かつ簡単なレポートツールを提供しています。

With Odoo, the values can be exported from any field in any record. To do so, activate the list view ( (list) icon), on the items that need to be exported, then select the records that should be exported. To select a record, tick the checkbox next to the corresponding record. Finally, click on Actions, then Export.

エクスポート をクリックすると、データのエクスポート ポップオーバーウィンドウが表示され、エクスポートするデータのオプションが表示されます:

1. With the I want to update data (import-compatable export) option ticked, the system only shows the fields that can be imported. This is helpful in the case where the existing records need to be updated. This works like a filter. Leaving the box unticked, gives many more field options because it shows all the fields, not just the ones that can be imported.

2. エクスポートの際、2つのフォーマットでエクスポートするオプションがあります: .csv` と .xls です。.csv`の場合、項目はカンマで区切られ、.xls`の場合、内容とフォーマットの両方を含むファイル内の全てのワークシートに関する情報が保持されます。

3. これらはエクスポートできる項目です。 >(右矢印) アイコンを使用すると、サブフィールドのオプションが表示されます。特定のフィールドを検索するには 検索 バーを使用します。 検索 オプションをより効率的に使用するには、 >(右矢印) を全てクリックして全てのフィールドを表示させて下さい。

4. +(プラス記号) アイコンボタンは、 エクスポートするフィールド リストにフィールドを追加するためにあります。

5. 選択したフィールドの左にある ↕️ (上下の矢印) を使ってフィールドを上下に移動し、エクスポートされたファイルでの表示順を変更することができます。 ↕️ (上下の矢印) のアイコンを使ってドラッグ＆ドロップします。

6. 🗑️(ゴミ箱) アイコンはフィールドを削除するために使用します。フィールドを削除するには 🗑️ (ゴミ箱) アイコンをクリックして下さい。

7. 繰返しレポートを作成する場合は、エクスポートプリセットを保存しておくと便利です。必要なフィールドを全て選択し、テンプレートのドロップダウンメニューをクリックします。そこで 新規テンプレート をクリックし、作成したエクスポートに一意の名前を付けます。 💾(フロッピードライブ) アイコンをクリックして設定を保存します。次に同じリストをエクスポートする必要がある場合は、ドロップダウンメニューから以前に保存した関連テンプレートを選択します。

Odooにデータをインポートする¶

Importing data into Odoo is extremely helpful during implementation, or in times where data needs to be updated in bulk. The following documentation covers how to import data into an Odoo database.

ちなみに

開発者モード を有効にすると、左メニューに表示されるインポートの設定が変更されます。これにより 高度な メニューが表示されます。この詳細メニューには インポートの経過を追跡 と サブフィールドとのマッチングを許可する という2つのオプションがあります。

モデルが openchatter を使用している場合、インポートの経過を追跡 オプションは、インポート中にサブスクリプションを設定し、通知を送信しますが、インポートが遅くなります。

サブフィールドとのマッチングを許可する オプションが選択されている場合、インポート時にフィールド内の全てのサブフィールドが Odooフィールド の下でマッチングに使用されます。

はじめに¶

データはExcel (.xlsx) または CSV (.csv) 形式でOdooのビジネスオブジェクトにインポートすることができます。これには連絡先、プロダクト、銀行明細、仕訳、オーダが含まれます。

データをインポート/入力するオブジェクトのビューを開き、 ⚙️ (アクション) ‣ レコードをインポート をクリックします。

レコードのインポート をクリックすると、Odooの別ページにテンプレートが表示されます。このようなテンプレートは、データマッピングが既に行われているため、ワンクリックでインポートすることができます。テンプレートをダウンロードするには、ページ中央の 顧客用にテンプレートをインポート をクリックして下さい。

重要

CSV ファイルをインポートする際、Odooは :guilabel:` フォーマッティング` オプションを提供します。これらのオプションは独自のExcelファイルタイプ(.xls, .xlsx)をインポートする際には表示され ません 。

*フォーマッティング*オプションに必要な調整を行い、 Odooフィールド と ファイル列 の全ての列にエラーがないことを確認します。最後に インポート をクリックしてデータをインポートします。

テンプレートの適用¶

テンプレートのインポートは、インポートするごく一般的なデータ(連絡先、プロダクト、銀行明細など)のインポートツールに用意されています。（Microsoft Office, OpenOffice, Google Drive など）。

テンプレートをダウンロードしたら、以下の手順に従って下さい:

• データ構成に最適な列の追加、削除、並べ替えを行います。

• 外部ID (ID)列を削除 しない ことを強くお勧めします。(理由は次のセクションをご覧下さい)

• 外部ID (ID)列のIDシーケンスをドラッグダウンすることで、全てのレコードに一意のIDを設定します。

注釈

新しい列が追加された場合、そのラベルがOdoo内のどのフィールドにも適合しない場合、Odooはその列を自動的にマッピングできないことがあります。しかし、インポートのテスト時に新しい列を手動でマッピングすることができます。ドロップダウンメニューから該当するフィールドを検索します。

その後、インポートファイルでこのフィールドのラベルを使用し、今後のインポートが成功するようにします。

他のアプリケーションからインポートする¶

外部ID (ID)は行項目の一意な識別子です。Odooへの移行を容易にするため、以前のソフトウェアのものをご自由にお使い下さい。

IDの設定はインポート時に必須ではありませんが、多くの場合に役立ちます:

• Update imports: import the same file several times without creating duplicates.

• インポート関連フィールド.

異なるレコード間の関係を再作成するには、元のアプリケーションの一意な識別子をOdooの 外部ID (ID) 列にマッピングする必要があります。

最初のレコードにリンクする別のレコードをインポートする場合、元の一意の識別子には XXX/ID (XXX/External ID) を使用します。このレコードは、名前を使用して検索することもできます。

マップ列にフィールドがない¶

Odooはインポートされたファイルの最初の10行を基に、各列のフィールドタイプを発見すべく検索します。

例えば、数字だけを含む列がある場合、整数 型のフィールドだけがオプションとして表示されます。

ほとんどの場合、この動作は有益かもしれませんが、失敗する可能性もありますし、デフォルトで提案されていないフィールドに列がマッピングされる可能性もあります。

このような場合は 関連フィールドのフィールドを表示 (高度な)オプション をチェックして下さい。そうすると、各列用にフィールドの完全なリストが利用できます。

データインポートフォーマットを変更する¶

CSV ファイルをインポートする際、Odooは フォーマティング オプションを提供します。

Odooがファイルから検出した日付フォーマットを確認するには、ファイルセレクタのオプションをクリックすると表示される 日付フォーマット をチェックして下さい。このフォーマットが正しくない場合は、ISO 8601 を使用してフォーマットを定義し、希望のフォーマットに変更して下さい。

通貨記号付き番号をインポートする¶

Odooは負の符号を表す括弧付きの数値や、通貨記号付きの数値を完全にサポートしています。また、Odooはどの千進/十進区切り記号が使用されているかを自動的に検出します。Odooが知らない通貨記号が使用された場合、数値として認識されずインポートがクラッシュすることがあります。

サポートされる数字の例(数字として3万2千を使用):

• 32.000,00

• 32000,00

• 32,000.00

• -32000.00

• (32000.00)

• $ 32.000,00

• (32000.00 €)

上手くいかない例:

• ABC 32.000,00

• $ (32.000,00)

インポートプレビューテーブルが正しく表示されない¶

デフォルトでは、インポートプレビューではフィールドの区切り文字としてカンマ、テキストの区切り文字として引用符が設定されています。もし CSV ファイルにこれらの設定がない場合は フォーマティング オプション ( CSV ファイルを選択した後 インポート CSV ファイルバーの下に表示されます )。

表計算アプリケーションでCSVファイル形式を変更¶

スプレッドシートアプリケーションで CSV ファイルを編集・保存する場合、セパレータとデリミタにはコンピュータの地域設定が適用されます。Odooでは OpenOffice または LibreOffice を使用することをお勧めします。どちらのアプリケーションでも3つのオプション全てを変更することができます( LibreOffice アプリケーションから '名前を付けて保存' ダイアログボックス ‣ 'フィルタ設定を編集' ボックスにチェックを入れ ‣ 保存）。

Microsoft Excelは保存時にエンコーディングを変更することができます('名前を付けて保存'ダイアログボックス ‣ 'ツール'ドロップダウンメニュー ‣ エンコーディングタブ)。

データベースIDと外部IDの違い¶

いくつかのフィールドは別のオブジェクトとの関係を定義します。例えば、連絡先の国は'国'オブジェクトのレコードへのリンクです。このようなフィールドをインポートする場合、Odooは異なるレコード間のリンクを再作成する必要があります。このようなフィールドをインポートするために、Odooは3つのメカニズムを提供しています。

例えば、連絡先の国を参照するために、Odooはインポートする3つの異なるフィールドを提案します:

• 国: 国の名前またはコード。

• 国/データベースID: PostgreSQLのID列で定義された、レコードに固有のOdoo IDです。

• 国/外部ID: 他のアプリケーション(またはそれをインポートした .XML ファイル)で参照されているこのレコードの ID。

例えばベルギーの場合、以下の3つの方法のいずれかを使って輸入して下さい:

• Country: Belgium

• 国/データベースID: 21

• 国/外部ID: base.be

会社のニーズに応じて、関係あるレコードを参照するために、これら3つの方法のいずれかを使用します。必要に応じて、どちらか一方を使用する場合の例を示します:

• 国 を使用します。 CSV ファイルを手動で作成した場合、この方法が最も簡単です。

• :guilabel:`国/データベースID`を使用する：これはほとんど使用すべきではありません。主な利点は不整合が発生しないことです(同じ名前のレコードが複数あるかもしれませんが、それらは常にユニークなデータベースIDを持っています)。

• Use 国/外部ID: サードパーティのアプリケーションからデータをインポートする場合、外部ID を使用します。

外部ID を使用する場合は、インポートする各レコードの 外部ID を定義する 外部ID (ID)列を持つ CSV ファイルをインポートします。そして、フィールド/外部ID`のような列でそのレコードを参照することができます。次の2つの :abbr:`CSV (Comma-separated Values) ファイルはプロダクトとそのカテゴリの例です。

• CSVファイルカテゴリ用

• CSVファイルプロダクト用

関連フィールドをインポートする¶

Odooオブジェクトは常に他の多くのオブジェクトと関連しています(例えばプロダクトはプロダクトカテゴリ、属性、仕入先などとリンクしています)。これらの関係をインポートするには、まず関連オブジェクトのレコードをリストメニューからインポートする必要があります。

この作業は、状況に応じて関連するレコードの名前または該当するIDを使用して行うことができます。2つのレコードの名前が同じ場合は、IDを使用するようにします。このような場合、列タイトルの最後に / ID を追加します(例：プロダクト属性の場合：プロダクト属性 / 属性 / ID)。

フィールドでの複数一致のオプション¶

例えば、子カテゴリ名が`販売可能`のプロダクトカテゴリが2つある場合（例：その他.プロダクト/販売可能`と`他プロダクト/販売可能）、検証は中断されますが、データをインポートすることはできます。しかし、データは全て プロダクトカテゴリ リストで最初に見つかった`販売可能`カテゴリ(その他プロダクト/販売可能)にリンクされるため、インポートしないことをお勧めします。Odooでは代わりに、重複する値の1つ、またはプロダクトカテゴリ階層を変更することを推奨しています。

しかし、プロダクトカテゴリの設定を変更したくない場合、Odooはこのフィールド、 'カテゴリ' に 外部ID を使用することをお勧めします。

多対多関係フィールドをインポートする¶

タグはコンマで区切り、スペースを空けてはいけません。例えば、ある顧客が 製造業 と 小売業者 の両方のタグにリンクされる必要がある場合 例えば、顧客が 製造業` と 小売業 の両方のタグにリンクする必要がある場合、'製造業.小売業' は CSV ファイルの同じ列にエンコードする必要があります。

• 製造業、小売業用CSVファイル

1対多関係をインポートする¶

会社が複数のオーダ明細を持つ販売オーダをインポートしたい場合、各オーダ明細に対して特定の行を CSV ファイルに指定しておく 必要があります 。最初のオーダ明細は、オーダに関連する情報と同じ行にインポートされます。追加の明細は、オーダに関連するフィールドに情報を持たない追加行が必要です。

例えば、以下はデモデータに基づいてインポートできる見積書の CSV ファイルです:

• 見積書用ファイル

次の CSV ファイルで、それぞれオーダ明細がある購買オーダをインポートする方法を示しています:

• 購買オーダとそれぞれの購買オーダ明細

次の CSV ファイルは、顧客とそれぞれの連絡先をインポートする方法を示しています:

• 顧客とその連絡先

レコードを複数回インポートする¶

インポートされたファイルに 外部ID または データベースID という列が含まれている場合、既にインポートされたレコードは作成されずに変更されます。これは非常に便利で、ユーザは同じ CSV ファイルを何度もインポートすることができます。

Odooは、それが新規かそうでないかによって、各レコードの新規作成または変更を行います。

この機能により、企業はOdooの インポート/エクスポートツール を使用して、スプレッドシートアプリケーションのレコードを一括修正することができます。

特定のフィールドに提供されていない値¶

CSVファイルに全てのフィールドが設定されていない場合、Odooは定義されていない全てのフィールドにデフォルト値を割当てます。しかし CSV ファイルに空の値が設定されている場合、Odooはデフォルト値を割当てずに空の値をフィールドに設定します。

SQLアプリケーションからOdooへの異なるテーブルのエクスポート/インポート¶

異なるテーブルからデータをインポートする必要がある場合、異なるテーブルに属するレコード間の関係を再作成する必要があります。例えば、会社と人がインポートされた場合、各人と所属会社の間のリンクを再作成する必要があります。

テーブル間の関係を管理するには、Odooの 外部ID 機能を使用します。レコードの`外部ID`は他のアプリケーションにおけるそのレコードの一意な識別子です。 外部ID は全てのオブジェクトの全てのレコードで一意でなければなりません。この 外部ID の前にアプリケーション名またはテーブル名を付けるとよいでしょう。( 'company_1', 'person_1' - '1' の代わりに)

例として、企業と人という2つのテーブルをインポートするSQLデータベースがあるとします。各人は1つの会社に所属しているため、人と所属会社の間のリンクを再作成する必要があります。

この例を、PostgreSQLデータベースのサンプル でテストして下さい。

まず、全ての会社とその*外部ID*をエクスポートします。PSQL で次のコマンドを記述します:

> copy (select 'company_'||id as "External ID",company_name as "Name",'True' as "Is a Company" from companies) TO '/tmp/company.csv' with CSV HEADER;

このSQLコマンドは以下の CSV ファイルを作成します:

External ID,Name,Is a Company
company_1,Bigees,True
company_2,Organi,True
company_3,Boum,True

会社にリンクされている人物の CSV（Comma-separated Values ファイルを作成するには、PSQLで次の SQLコマンドを使用します:

> copy (select 'person_'||id as "External ID",person_name as "Name",'False' as "Is a Company",'company_'||company_id as "Related Company/External ID" from persons) TO '/tmp/person.csv' with CSV

これは次のような CSV ファイルを生成します:

External ID,Name,Is a Company,Related Company/External ID
person_1,Fabien,False,company_1
person_2,Laurence,False,company_1
person_3,Eric,False,company_2
person_4,Ramsy,False,company_3

このファイルでは、FabienとLaurenceはBigees社(company_1)で働いており、EricはOrgani社で働いています。人と会社の関係は、会社の*外部ID* を使って行われます。外部 ID は、テーブルの名前の前に付けて、人と会社の間のIDの不整合を回避します (person_1 と company_1 は、元のデータベースで同じ ID 1 を共有していました)。

作成された2つのファイルはそのままOdooにインポートすることができます。これら2つの CSV ファイルをインポートすると、4つの連絡先と3つの会社があります(最初の2つの連絡先は最初の会社にリンクされています)。まず会社をインポートし、次に人をインポートするようにして下さい。

Update data in Odoo¶

Existing data can be updated in bulk through a data import, as long as the External ID remains consistent.

Prepare data export¶

To update data through an import, first navigate to the data to be updated, and select the (list) icon to activate list view. On the far-left side of the list, tick the checkbox for any record to be updated. Then, click Actions, and select Export from the drop-down menu.

On the resulting Export Data pop-up window, tick the checkbox labeled, I want to update data (import-compatible export). This automatically includes the External ID in the export. Additionally, it limits the Fields to export list to only include fields that are able to be imported.

Select the required fields to be included in the export using the options on the pop-up window, then click Export.

Import updated data¶

After exporting, make any necessary changes to the data file. When the file is ready, it can be imported by following the same process as a normal data import.