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

こんにちは！テクニカルディレクターの桑島です。

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

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

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

JDBC Drivers ファイルをCData 製品のインストールフォルダからon-Premise Atom deployment インストールパス配下のパスにコピーします。
• cdata.jdbc.cvent.jar
• cdata.jdbc.cvent.lic （試用版では.lic ファイルは不要）

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

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

Cvent のConnectionの作成

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

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

  Cvent への認証を行う前に、ワークスペースとOAuth アプリケーションを作成する必要があります。

  ワークスペースの作成

  ワークスペースを作成するには：

  1. Cvent にサインインし、App Switcher（ページ右上の青いボタン） -> Admin に移動します。
  2. Admin メニューから、Integrations -> REST API に移動します。
  3. Developer Management の新しいタブが立ち上がります。新しいタブでManage API Access をクリックします。
  4. Workspace を作成し、名前を付けます。開発者にアクセスさせたいスコープを選択します。スコープは、開発者がアクセスできるデータドメインを制御します。
     • All を選択すると、開発者は任意のスコープ、およびREST API にこれから追加されるスコープを選択できます。
     • Custom を選択すると、開発者がOAuth アプリで選択できるスコープを、選択したスコープに制限できます。本製品によって公開されるすべてのテーブルにアクセスするには、次のスコープを設定する必要があります。

       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 ページにあります。
  • Driver Type: Custom
  • Class Name: cdata.jdbc.cvent.CventDriver
  • User Name: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
  • Password: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
  • Connection URL: jdbc:cvent:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;InitiateOAuth=GETANDREFRESH
• Connection の値を設定したら接続テストを行います。右上のTest Connection ボタンをクリックします。実行するAtom を選択する画面が表示されるので、上記手順で作成したon-Premise Atom deployment を選択します。
• テスト接続が成功することを確認してFinish ボタンでウィザードを閉じます。
• 作成した Cvent のデータ への接続Connection を保存（Save）します。

Boomi Atom でのCvent のデータ Profile の作成

次にProfile を設定していきます。ProfileとはSQL（SELECT/INSERT/UPDATE/DELETE）実行時のフィールド定義です。

• Cvent のデータ のテーブルをSELECT するProfile を作成していきます。
• • Type: Profle
  • Component Name: ProfileCDataCvent
  • Folder: 任意のパス
  • Connector: Database
• 二つのパラメータに、Display Name: デフォルト, Type: Select と値をセットしたら右上のImportボタンをクリックします。
• Database Import Wizardが開くので、以下のパラメータをセットして次に進みます。
  • Browse in: 上記手順で作成したon-Premise Atom deployment
  • Connection: 上記手順で作成した接続Connection
• Cvent のデータ 内のオブジェクトがテーブル一覧として表示されます。取得するテーブルにチェックをオンにして次に進みます。
• テーブル内のカラム一覧が表示されます。使用する項目のチェックをオンにして次に進みます。
• Import ウィザードが完了します。
• DataElements のField アイコンをクリックすると選択テーブル内のカラムが定義されていることを確認できます。また、SQL Script には取得時のSQL（SELECT）が表示されています。作成したProfile を保存します。
• これでCvent のデータ がBoom Atom で利用できるProfile として登録されました。

Boomi AtomSphere でのCvent のデータ の利用

あとは、設定されたProfile はRDB と同じようにBoomi Atom 内で利用することができます。カラムにマッピングを行うこともできます。

このようにCData JDBC ドライバをアップロードすることで、簡単にBoomi AtomSphere でCvent のデータ データをノーコードで連携し、使うことが可能です。

是非、CData JDBC Driver for Cvent 30日の無償評価版 をダウンロードして、お試しください。