Data Platform コネクタで Odoo ERP データを抽出する#

#目的

Odoo コネクタは、Odoo ERP インスタンスからデータを抽出します：連絡先、CRM リード、販売注文、請求書、製品、在庫、HR、プロジェクトなど。

26 の事前定義済みモデルが 9 のドメインをカバー + カスタムモデルエンドポイントは任意の Odoo モデル + モデルフィールドエンドポイントはスキーマのイントロスペクション。

コネクタは Odoo JSON-RPC API から生の JSONを返します。プラットフォームは自動的に入れ子になったオブジェクトを列にフラット化し、結果をレイクハウスに保存します。手動でのスキーマ定義は必要ありません。

Odoo 14–19 と互換性があります。

#1. API キーを取得する

1. Odoo インスタンスにログインします
2. アバター（右上）をクリック > マイプロフィール
3. アカウントセキュリティタブに移動します
4. 新しい API キーをクリックします
5. 説明を入力します（例：data-platform-connector）
6. キーを生成をクリックします
7. キーをすぐにコピーします：一度だけ表示されます

#2. 資格情報を設定する

#3. 利用可能なエンドポイントの種類

#models: 事前定義済みモデル

26 の一般的に使用される Odoo モデルをドメイン別にグループ化：

パラメータ：

#custom_model: 任意の Odoo モデル

事前定義済みリストにないモデル（例：helpdesk.ticket, mrp.production, fleet.vehicle）の場合。

#model_fields: スキーマのイントロスペクション

任意のモデルのフィールド定義（名前、タイプ、必須、ヘルプテキスト、関係）を返します。データを抽出する前に利用可能なフィールドを発見するのに役立ちます。

#4. Data Platform に Odoo ソースを追加する

1. Data Platform のコネクタで、ソースストアからOdooを見つけ、選択をクリックします。
2. 手順 2から接続フィールドを入力します：URL、ログイン、API キー、および（セルフホストの場合）データベース。
3. 接続をクリックして資格情報を確認します。コネクタは JSON-RPC を介して認証し、Odoo uidを解決します。
4. エンドポイントを追加をクリックし、ドロップダウンからmodels, custom_model, またはmodel_fieldsを選択し、そのエンドポイントが必要とするパラメータを入力します（例：モデル、オプションのフィールドフィルタ、オプションのドメインフィルタ、オプションの最大アイテム数）。
5. このソースで取り込みたい追加のエンドポイントごとに手順 4 を繰り返します。各エンドポイントはレイクハウス内の別々のテーブルになります。
6. ソースに名前を付け、作成をクリックします。

#5. クイック例：連絡先を抽出する

1. エンドポイント：models
2. モデル：res.partner（連絡先）
3. フィールドフィルタ：name, email, phone, is_company, city, country_id
4. 最大アイテム数：100（または空にして全てを抽出）

コネクタは Odoo API から生の JSON を返します。プラットフォームは自動的に入れ子になったオブジェクトをフラット化し、結果をレイクハウスに保存します。

#6. ドメインフィルタの構文

ドメインフィルタは Odoo のポーランド（接頭辞）表記法を使用します。JSON 配列として入力します：

[["state", "=", "sale"], ["amount_total", ">", 1000]]

一般的な演算子：=, !=, >, <, >=, <=, in, not in, like, ilike

OR 条件は|接頭辞を使用します：

["|", ["type", "=", "lead"], ["type", "=", "opportunity"]]

全レコードを抽出するには[]を空にします。

#7. ベストプラクティス

#フィールドフィルタを使用する

フィルタなしでは Odoo は全フィールドを返します：一部のモデルには 200 以上のフィールドがあります。特にres.partnerのような大規模なモデルの場合、必要なものだけを保持するためにフィールドフィルタを使用します。

#max_items から始める

10 または 100 にmax_itemsを設定して、素早くテストします。満足したら制限を解除します。

#model_fields を使用してフィールドを発見する

model_fieldsエンドポイントは任意のモデルの完全なスキーマを返します。抽出を設定する前にフィールド名、タイプ、関係を発見するために使用します。

#ステージと参照テーブル

crm.stage, account.journal, product.categoryを参照テーブルとして抽出します。ステージ/ジャーナル/カテゴリ ID フィールドでメインデータと結合します。

#8. 既知の制限

• モデルの利用可能性はインストールされたアプリに依存します。モデルのようなcrm.leadは CRM アプリが必要です、sale.orderは販売が必要ですなど。custom_modelを使用してインスタンスにモデルが存在するかテストします。
• 一部のフィールドは特定のユーザーグループが必要です。例えば、project.project.stage_idは「プロジェクトでステージを使用する」グループが必要です。権限エラーが発生した場合、fields_filterを使用して制限されたフィールドを除外します。
• Odoo Online API アクセスにはカスタムプランが必要です。Odoo 料金を参照してください。

#さらに進む

トレーニングや技術的なサポートを受けてソリューションを実装するには、営業担当者に連絡するか、プロフェッショナルサービスページを訪れて、専門家がプロジェクトを分析するための見積もりを依頼してください。

質問をする、フィードバックを送信し、Data Platform を構築するチームと直接交流するには、専用のDiscord チャネルにアクセスしてください。

OVHcloud サービスについてサポートが必要な場合は、ヘルプセンターでリクエストを作成してください。

ユーザーコミュニティに参加してください。