JBoss のコネクションプールから Harvest のデータに接続

Jerod Johnson
Director, Technology Evangelism

Harvest のデータを Java サーブレットに統合：JBoss の管理コンソールを使用して Harvest JDBC Driver をインストール。

CData JDBC Driver は、コネクションプーリングの標準手順に従ってJBoss で設定できます。本記事では、JBoss アプリケーションのコネクションプールから Harvest のデータにアクセスする方法を解説します。JBoss 管理インターフェースを使用して CData JDBC Driver for Harvest を設定し、コネクションプールから Harvest のデータにアクセスします。

管理コンソールから Harvest 用のJDBC データソースを作成

以下の手順に従って、ドライバーJAR を追加し、必要な接続プロパティを定義します。

Runtime メニューで、管理ドメインにデプロイするかスタンドアロンサーバーにデプロイするかに応じて、Domain またはServer メニューを選択し、「Manage deployments」をクリックしてDeployments ページを開きます。
Add をクリックします。表示されるウィザードで、インストールディレクトリのlib サブフォルダにあるドライバーのJAR ファイルとライセンスを追加します。デフォルト設定でウィザードを完了し、ドライバーを選択してEnable をクリックします。
Configuration メニューで、Subsystems -> Connector -> Datasources をクリックします。JDBC Datasources ページが開きます。
Add をクリックし、表示されるウィザードでドライバーの名前とJNDI 名を入力します。例：
```
java:jboss/root/jdbc/API
```
上記で追加したドライバーを選択します。
JDBC URL とユーザー名、パスワードを入力します。JDBC URL の構文は、jdbc:api: の後にセミコロン区切りの接続プロパティを記述します。

まず、Profile 接続プロパティをディスク上のHarvest プロファイルの場所に設定します（例：C:\profiles\Harvest.apip）。次に、ProfileSettings 接続プロパティをHarvest の接続文字列に設定します（以下を参照）。

Harvest API プロファイル設定

Harvest に認証するには、トークン認証またはOAuth 標準のいずれかを使用できます。自分のデータに接続するにはBasic 認証を使用します。他のユーザーが自分のデータに接続できるようにするにはOAuth を使用します。

トークン認証の使用

トークン認証を使用するには、ProfileSettings 接続プロパティでAPIKey にHarvest パーソナルアクセストークンを設定します。APIKey に加えて、ProfileSettings でAccountId を設定して接続します。

OAuth 認証の使用

まず、Harvest でOAuth2 アプリケーションを登録します。アプリケーションはHarvest ID の「Developers」セクションから作成できます。

以下の接続プロパティを設定すると、接続できるようになります。
- ProfileSettings：ProfileSettings でAccountId を設定します。
- AuthScheme：OAuth に設定します。
- OAuthClientId：アプリ設定で指定したclient ID に設定します。
- OAuthClientSecret：アプリ設定で指定したclient secret に設定します。
- CallbackURL：アプリ設定で指定したRedirect URI に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、ドライバーがOAuthAccessToken を取得および更新する方法を管理できます。
組み込みの接続文字列デザイナー

JDBC URL の作成には、Harvest JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。
```
java -jar cdata.jdbc.api.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

一般的な接続文字列は次のとおりです。
```
jdbc:api:Profile=C:\profiles\Harvest.apip;ProfileSettings='APIKey=my_personal_key;AccountId=_your_account_id';
```
接続をテストしてウィザードを完了します。Harvest データソースを選択し、Enable をクリックします。