WebLogic のコネクションプールからOdooに接続
CData JDBC Driver for Odoo を使えば、標準的な手順に沿ってOdoo のデータ をJava Web アプリケーションに統合できます。この記事では、CData JDBC Driver for Odoo をWebLogic Server にデプロイする方法を説明します。
Odoo データ連携について
CData を使用すれば、Odoo のライブデータへのアクセスと統合がこれまでになく簡単になります。お客様は CData の接続機能を以下の目的で利用しています:
- Odoo API 8.0+ と Odoo.sh クラウド ERP の両方からライブデータにアクセスできます。
-
多対一、一対多、多対多のデータプロパティをインテリジェントに処理することで、ネイティブの Odoo 機能を拡張できます。CData の接続ソリューションは、Odoo 内の複雑なデータプロパティもインテリジェントに処理します。テキストや日付などの単純な値を持つカラムに加えて、各行に複数の値を含むカラムもあります。ドライバーは、値の元となるカラムのタイプに応じて、これらの種類の値を異なる方法でデコードします:
- 多対一カラムは、別のモデル内の単一の行への参照です。CData ソリューションでは、多対一カラムは整数として表され、その値は他のモデルで参照している ID です。
- 多対多カラムは、別のモデル内の多くの行への参照です。CData ソリューションでは、多対多カラムはカンマ区切りの整数リストを含むテキストとして表されます。リスト内の各値は、参照されている行の ID です。
- 一対多カラムは、別のモデル内の多くの行への参照です。多対多カラムと同様(カンマ区切りの整数リスト)ですが、参照されるモデルの各行はメインモデルの 1 つにのみ属する必要があります。
- SQL ストアドプロシージャを使用して、Odoo 内のサーバーサイド RFC を呼び出すことができます。
ユーザーは、Power BI や Qlik Sense などの分析ツールと Odoo を統合し、当社のツールを活用して Odoo データをデータベースやデータウェアハウスにレプリケートしています。
はじめに
WebLogic Server へのJDBC ドライバーのデプロイ
ドライバーをデプロイするには、ドライバーJAR をクラスパスに追加します。.lic ファイルは、JAR と同じフォルダに配置する必要があります。 これらのファイルは、インストールディレクトリのlib サブフォルダに格納されています。
すべてのドメインにドライバーを追加する場合は、WL_HOME\common\bin\commEnv.cmd/sh にあるWEBLOGIC_CLASSPATH 環境変数の先頭にJAR のパスを追加します。このスクリプトは WL_HOME\common\bin\ にあります。以下に例を示します。
set WEBLOGIC_CLASSPATH=your-installation-directory\lib\cdata.jdbc.odoo.jar;%WEBLOGIC_CLASSPATH%
WebLogic 12.2.1 では、特定のドメインにドライバーを追加する場合、ドライバーJAR と.lic ファイルをDOMAIN_HOME\lib(例:ORACLE_HOME\user_projects\domains\MY_DOMAIN\lib)に配置するだけで済みます。これらのファイルは、起動時にサーバーのクラスパスに追加されます。
以前のバージョンでは、手動でドライバーをクラスパスに追加する必要があります。setDomainEnv.cmd/sh のPRE_CLASSPATH 環境変数の先頭に、以下の内容を追加します。このスクリプトは、対象ドメインのフォルダのbin サブフォルダにあります。
set PRE_CLASSPATH=your-installation-directory\lib\cdata.jdbc.odoo.jar;%PRE_CLASSPATH%
これらの変更を行った後、サーバーを再起動します。
Odoo 用JDBC データソースの作成
ドライバーをデプロイしたら、WebLogic 管理コンソールにログインして接続を作成します。
- ドメイン構造ツリーで、Services -> Data Sources -> New -> Generic Data Source をクリックします。
-
JDBC Data Source Properties ページで、以下の情報を入力します。
- Name: ユーザーフレンドリーな名前を入力します(例:odoojdbc)。
- JNDI Name: JDBC データソースのバインド先のパスを入力します(例:jdbc/Odoo)。
Database Type: Other を選択します。
-
Next をクリックしてデフォルトオプションを使用します。最後のページで、以下の情報を入力してTest Configuration をクリックします。
- Driver Class Name: ドライバークラスを入力します(cdata.jdbc.odoo.OdooDriver)。
URL: JDBC URL を入力します。一般的なJDBC URL は次のとおりです。
jdbc:odoo:User=MyUser;APIToken=MyToken;URL=http://MyOdooSite/;Database=MyDatabase
接続するには、URL にOdoo インスタンスURL、User およびAPIToken にユーザー資格情報、Database にOdoo データベース名を設定します。 API トークン(Odoo 14 以降でのみ利用可能)を使用していない場合、代わりにAPIToken フィールドにパスワードを直接入力することができます。
接続方法の詳細は、ヘルプドキュメントの「はじめに」セクションを参照してください。
組み込みの接続文字列デザイナー
JDBC URL の作成には、Odoo JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。
java -jar cdata.jdbc.odoo.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
- Database User Name: JDBC URL で指定していない場合は、ユーザー名を入力します。
- Password: JDBC URL で指定していない場合は、パスワードを入力します。
JDBC データソースをデプロイするサーバーを選択すると、Odoo のデータ に接続できるようになります。
その他のWebLogic 連携
上記の手順では、シンプルなコネクションプーリングシナリオでのドライバー設定方法を説明しました。その他のユースケースや詳細については、Oracle Fusion Middleware ドキュメントのWebLogic Data Sources 章のJDBC セクションを参照してください。