WebLogic のコネクションプールからCventに接続
CData JDBC Driver for Cvent を使えば、標準的な手順に沿ってCvent のデータ をJava Web アプリケーションに統合できます。この記事では、CData JDBC Driver for Cvent をWebLogic Server にデプロイする方法を説明します。
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.cvent.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.cvent.jar;%PRE_CLASSPATH%
これらの変更を行った後、サーバーを再起動します。
Cvent 用JDBC データソースの作成
ドライバーをデプロイしたら、WebLogic 管理コンソールにログインして接続を作成します。
- ドメイン構造ツリーで、Services -> Data Sources -> New -> Generic Data Source をクリックします。
-
JDBC Data Source Properties ページで、以下の情報を入力します。
- Name: ユーザーフレンドリーな名前を入力します(例:cventjdbc)。
- JNDI Name: JDBC データソースのバインド先のパスを入力します(例:jdbc/Cvent)。
Database Type: Other を選択します。
-
Next をクリックしてデフォルトオプションを使用します。最後のページで、以下の情報を入力してTest Configuration をクリックします。
- Driver Class Name: ドライバークラスを入力します(cdata.jdbc.cvent.CventDriver)。
URL: JDBC URL を入力します。一般的なJDBC URL は次のとおりです。
jdbc:cvent:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;
Cvent への認証を行う前に、ワークスペースとOAuth アプリケーションを作成する必要があります。
ワークスペースの作成
ワークスペースを作成するには:
- Cvent にサインインし、App Switcher(ページ右上の青いボタン) -> Admin に移動します。
- Admin メニューから、Integrations -> REST API に移動します。
- Developer Management の新しいタブが立ち上がります。新しいタブでManage API Access をクリックします。
- Workspace を作成し、名前を付けます。開発者にアクセスさせたいスコープを選択します。スコープは、開発者がアクセスできるデータドメインを制御します。
- All を選択すると、開発者は任意のスコープ、およびREST API にこれから追加されるスコープを選択できます。
- Custom を選択すると、開発者がOAuth アプリで選択できるスコープを、選択したスコープに制限できます。CData 製品によって公開されるすべてのテーブルにアクセスするには、次のスコープを設定する必要があります。
event/attendees:read event/attendees:write event/contacts:read event/contacts:write event/custom-fields:read event/custom-fields:write event/events:read event/events:write event/sessions:delete event/sessions:read event/sessions:write event/speakers:delete event/speakers:read event/speakers:write budget/budget-items:read budget/budget-items:write exhibitor/exhibitors:read exhibitor/exhibitors:write survey/surveys:read survey/surveys:write
OAuth アプリケーションの作成
Workspace を設定して招待すると、開発者はサインアップしてカスタムOAuth アプリを作成できます。手順については、ヘルプドキュメントのカスタムOAuth アプリケーションの作成を参照してください。
Cvent への接続
OAuth アプリケーションを作成したら、次の接続プロパティを設定してCvent に接続します。
- InitiateOAuth:GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
- OAuthClientId:OAuth アプリケーションに関連付けられたClient ID。これは、Cvent Developer Portal のApplications page ページにあります。
- OAuthClientSecret:OAuth アプリケーションに関連付けられたClient secret。これは、Cvent Developer Portal のApplications page ページにあります。
組み込みの接続文字列デザイナー
JDBC URL の作成には、Cvent JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。
java -jar cdata.jdbc.cvent.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
- Database User Name: JDBC URL で指定していない場合は、ユーザー名を入力します。
- Password: JDBC URL で指定していない場合は、パスワードを入力します。
JDBC データソースをデプロイするサーバーを選択すると、Cvent のデータ に接続できるようになります。
その他のWebLogic 連携
上記の手順では、シンプルなコネクションプーリングシナリオでのドライバー設定方法を説明しました。その他のユースケースや詳細については、Oracle Fusion Middleware ドキュメントのWebLogic Data Sources 章のJDBC セクションを参照してください。