接続の確立

コネクタ内で利用可能なオブジェクトは、"cdata.odoo" モジュールからアクセスできます。モジュールのオブジェクトを直接使用するには：

モジュールを以下のようにインポートします。
```
import cdata.odoo as mod
```
接続を確立するには、以下のような適切な接続文字列を使用してコネクタオブジェクトからconnect() メソッドを呼び出します。
```
mod.connect("User=MyUser;APIToken=MyToken;URL=http://MyOdooSite/;Database=MyDatabase")
```

Odoo への接続

接続するには、URL にOdoo インスタンスURL、User およびAPIToken にユーザー資格情報、Database にOdoo データベース名を設定します。

API トークン（Odoo 14 以降でのみ利用可能）を使用していない場合、代わりにAPIToken フィールドにパスワードを直接入力することができます。

クイックスタート：Odoo Online への接続

以下の手順は、Odoo Online に接続するための一般的な設定です。

OdooEdition をOnline に設定します。
URL をhttps://mycompany.odoo.com のようなOdoo インスタンスの完全なURL に設定します。
User をお使いのOdoo ログイン（E メールまたはユーザー名）に設定します。
APIToken をAPI キーまたはパスワードに設定します。
Database をデータベース名に設定します（Odoo Online ではオプション、On-Premises では必須）。

Note：On-Premises Odoo の場合も手順は同様ですが、必ずDatabase を指定し、サーバーが本製品にアクセス可能であることを確認する必要があります。Odoo Online の場合、データベースは自動的に検出される場合がありますが、設定することをお勧めします。

Odoo エディション

OdooEdition プロパティは、接続の確立方法を決定します。Odoo は2種類の環境を提供しており、この設定は本製品にどちらを使用しているかを伝えます。

Online：odoo.com でOdoo のクラウドホスティングされたSaaS 版を利用する場合
OnPrem：Odoo を自社サーバーにインストールして使用する場合

もし不明な場合は、yourcompany.odoo.com のようなWeb アドレスからOdoo にアクセスする場合、Online を使用してください。組織が独自のOdoo サーバーを管理している場合（カスタムドメインやローカルネットワーク経由でアクセスすることが多い）は、OnPrem を使用してください。

データベース

Odoo は同じサーバーで複数のデータベースをサポートします。接続するデータベースの名前を指定する必要があります。

Odoo Online の場合：データベース名はWeb アドレスに含まれていることが多く、Database が空白の場合、本製品が自動的に検出できる可能性があります。ただし、データベースがURL に表示されず、手動で指定しなければならない場合もあります。信頼性のために、この値を設定することを常に推奨します。
Odoo On-Premises の場合：Database プロパティを設定する必要があります。この場合、本製品はデータベースを自動検出できません。

データベース名の調べ方（Odoo Online）

Odoo Online アカウントにログインします。
右上のプロフィールアイコンをクリックし、My Databases を選択します。
データベース名がテーブルに表示されます。

また、URL のサブドメインにデータベース名が表示されていることもよくあります。アドレスがhttps://mycompany.odoo.com の場合、データベース名はおそらくmycompany です。

アクセス権

Odoo で利用可能なモデル（テーブル）を検出するために、本製品は内部のir.model.access テーブルをチェックします。このテーブルは、ユーザーが閲覧できるモデルを定義しています。

デフォルトでは、Odoo 管理者だけがこのテーブルを読み取る権限を持っています。管理者以外のユーザーにアクセス権を与えるには、新しいグループを作成します。

管理者としてログインし、Odoo の設定でdeveloper mode を有効にします。
Groups ページ（Users ドロップダウンの下）を開いて新しいグループを作成します。
Application をAdministration に設定し、グループ名を"Service Access" とします。
Users タブの下にアクセスが必要なユーザーを追加します。
Access Rights タブで、ir.model.access（またはModel Access）の権限を追加し、Read にチェックを入れ、Inspect Models と名前を付けます。

この方法でアクセスを許可できない場合は、CheckPermissions プロパティをfalse に設定します。これにより、権限チェックが無効になり、ユーザーが明示的なアクセス権を持っていなくても、本製品がすべての利用可能なモデルをリストできるようになります。

トラブルシューティング

データベースが見つからない、または認証に失敗するなどのエラーが発生した場合は、次の手順を試してください。

特にオンプレミス環境では、Database の値を再確認してください。
Odoo に直接ログインして、ユーザー資格情報が有効であることを確認してください。
Odoo Online を使用している場合、Database を空白にして自動検出を許可してみてください。
正しいOdooEdition が設定されていること（Online か OnPrem か）を確認してください。

CData Python Connector for Odoo