Harvest のデータをBoomi AtomSphere で連携利用する方法：CData JDBC Driver

桑島義行
テクニカルディレクター

CData JDBC ドライバを使って、データ統合サービス（iPaaS）のBoomi で Harvest のデータをノーコードで連携。

Boomi AtomSphere https://boomi.com/は、Boomi 社が提供する、シングルインスタンス、マルチテナントアーキテクチャを特徴としているデータ統合サービス（iPaaS）です。データ統合機能だけでなく、マスターデータのハブ機能、EDI、APIManagement、WorkFlow といったビジネスユースに必要なデータ連携のすべてを実現する機能をシングルプラットフォームで提供しています。

この記事では、Boomi AtomSphere のオンプレミスAtom deployment 機能を使って、CData JDBC ドライバ経由でHarvest のデータにアクセスする方法を紹介します。CData Drivers を使うことで、RDB のようにBoomi 内でHarvest のデータを扱うことができるようになります。

Boomi のon-Premise Atom depleyment の作成

on-Premise Atom deployment （右上の青部分）を利用する構成としました。この機能を利用することでOn-Premise 側に配置したCData JDBC ドライバ経由でのSaaS 連携を実現します。

ブラウザからBoomi Atom のManage > Atom Management のタブを開きます。
+New > Atom を開きます。
Atom Setup ダイアログが開くので、ブラウザを開いているマシンのOS（本例ではWindows10Pro 64bit）のSetup ファイルをダウンロードします。

ダウンロードした「atom_install64.exe」を実行するとインストーラが起動します。
Setup Wizard を進めます。
ブラウザからBoomi Atom へのログインする時のUser・Password をセットして、Atom Name はデフォルトのまま、次に進みます。
on-Premise Atom deployment のインストールディレクトリ（デフォルト）を指定して次に進みます。
Setup Wizard を終了（Finish）します。
ブラウザからBoomi Atom のManage > Atom Management のタブを開いて、上記で作成したon-Premise Atom Deployment が起動していることを確認します。なお、Windows マシンの場合、サービスからも起動を確認できます。on-Premise Atom deployment の作成は以上です。

Boomi on-Premise Atom deployment モジュールへのJDBC ドライバの配置

次に別途ダウンロード・インストールしたCData JDBC Driver for API をBoomi on-premise Atom モジュールに配置していきます。

cdata.jdbc.api.jar
cdata.jdbc.api.lic （試用版では.lic ファイルは不要）

コピー元：C:\Program Files\CData\CData JDBC Driver for API 2019J\lib
コピー先：C:\Boomi AtomSphere\Atom - 10.211.55.9\lib

コピーしたらBoomi Atom をブラウザからリスタート(Restart Atom)してください。作成したon-Premise Atom deployment のInstalledLibraries にJDBCの.jar ファイルが表示されれば成功です。

Harvest のConnectionの作成

Boomi Atom からHarvest のデータソースに接続するためのConnection を作成します。

Welcom 画面の「Component > Connetion」を選択するとCreate Component ウィザードが開きます。
Harvest への接続用のConnection 設定として以下の値をセットします。
- Type: Connection
- Component Name: ConnectionCDataAPI
- Folder: 任意のパス
- Connector: Database

そしてJDBC Driver の接続設定を行います。
まず、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 を取得および更新する方法を管理できます。
- Driver Type: Custom
- Class Name: cdata.jdbc.api.APIDriver
- User Name: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Password: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Connection URL: jdbc:api:Profile=C:\profiles\Harvest.apip;ProfileSettings='APIKey=my_personal_key;AccountId=_your_account_id';InitiateOAuth=GETANDREFRESH

Connection の値を設定したら接続テストを行います。右上のTest Connection ボタンをクリックします。実行するAtom を選択する画面が表示されるので、上記手順で作成したon-Premise Atom deployment を選択します。
テスト接続が成功することを確認してFinish ボタンでウィザードを閉じます。
作成した Harvest のデータへの接続Connection を保存（Save）します。