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

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

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

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

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

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 Kintone をBoomi on-premise Atom モジュールに配置していきます。

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

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

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

Kintone のConnectionの作成

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

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

そしてJDBC Driver の接続設定を行います。
Kintone 接続プロパティの設定方法

それでは、Kintone に接続していきましょう。接続するには、以下の接続プロパティを設定します。
- URL：Kintone のアクセスURL（例：https://yoursitename.cybozu.com または https://yoursitename.kintone.com）
- User：アカウントのユーザー名
- Password：アカウントのパスワード
- AuthScheme：「Password」を指定
パスワード認証の代わりにAPI トークン認証をご利用になる場合は、ヘルプドキュメントの「接続の設定」セクションをご確認ください。

Basic 認証の設定

続いて、ご利用のKintone ドメインでBasic 認証を有効にしている場合は、接続プロパティの「詳細」設定で以下の項目を追加設定してください。
- BasicAuthUser：Basic 認証のユーザー名
- BasicAuthPassword：Basic 認証のパスワード
クライアント証明書認証の設定

Basic 認証の代わりにクライアント証明書による認証をご利用になる場合は、以下の項目を設定してください。
- SSLClientCert：クライアント証明書のパス
- SSLClientCertType：証明書の種類
- SSLClientCertSubject：証明書のサブジェクト
- SSLClientCertPassword：証明書のパスワード
- Driver Type: Custom
- Class Name: cdata.jdbc.kintone.KintoneDriver
- User Name: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Password: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Connection URL: jdbc:kintone:User=myuseraccount;Password=mypassword;URL=http://subdomain.domain.com;

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