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

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

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

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

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

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

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

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

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

Adobe Target のConnectionの作成

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

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

そしてJDBC Driver の接続設定を行います。
Adobe Target に接続するには、以下に記載されているOAuth 接続プロパティとともにTenant プロパティを指定する必要があります。他の接続プロパティは処理動作に影響を与える可能性がありますが、接続には影響しません。

以下のステップでTenant 名を確認できます。
1. Adobe Experience にログインします。URL は「https://experience.adobe.com/#/@mycompanyname/preferences/general-section」です。
2. 「/#/@」の後の値を抽出します。この例では「mycompanyname」です。
3. Tenant 接続プロパティをその値に設定します。
ユーザーアカウント（OAuth）

すべてのユーザーアカウントフローでAuthScheme をOAuthClient に設定する必要があります。

注意：OAuth を介したAdobe 認証では、2週間ごとにトークンを更新する必要があります。

すべてのアプリケーション
CData では、OAuth 認証を簡素化する組み込みOAuth アプリケーションを提供しています。または、カスタムOAuth アプリケーションを作成することもできます。詳細については、ヘルプドキュメントの「カスタムOAuthアプリの作成」をご確認ください。

OAuth アクセストークンの取得

接続するには以下のプロパティを設定します：
- InitiateOAuth：GETANDREFRESH に設定して、OAuth 交換を自動的に実行し、必要に応じてOAuthAccessToken を更新します。
- OAuthClientId：アプリを登録した際に割り当てられたクライアントID に設定します。
- OAuthClientSecret：アプリを登録した際に割り当てられたクライアントシークレットに設定します。
- CallbackURL：アプリを登録した際に定義されたリダイレクトURI に設定します。例：https://localhost:3333
これらの設定により、プロバイダーはAdobe Target からアクセストークンを取得し、それを使用してデータを要求します。OAuth値はOAuthSettingsLocation で指定された場所に保存され、接続間で確実に保持されます。
- Driver Type: Custom
- Class Name: cdata.jdbc.adobetarget.AdobeTargetDriver
- User Name: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Password: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Connection URL: jdbc:adobetarget:Tenant=mycompanyname;InitiateOAuth=GETANDREFRESH

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