こんにちは！テクニカルディレクターの桑島です。
Boomi AtomSphere https://boomi.com/は、Boomi 社が提供する、 シングルインスタンス、マルチテナントアーキテクチャを特徴としているデータ統合サービス（iPaaS）です。データ統合機能だけでなく、マスターデータのハブ機能、EDI、APIManagement、WorkFlow といったビジネスユースに必要なデータ連携のすべてを実現する機能をシングルプラットフォームで提供しています。
この記事では、Boomi AtomSphere のオンプレミスAtom deployment 機能を使って、CData JDBC ドライバ経由でSage 300 のデータにアクセスする方法を紹介します。CData Drivers を使うことで、RDB のようにBoomi 内でSage 300 のデータを扱うことができるようになります。
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 ファイルをダウンロードします。
![Boomi on-premise Atom]()
- ダウンロードした「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 の作成は以上です。
![オンプレミスAtom のインストールを確認]()
Boomi on-Premise Atom deployment モジュールへのJDBC ドライバの配置
次に別途ダウンロード・インストールしたCData JDBC Driver for Sage300 をBoomi on-premise Atom モジュールに配置していきます。
JDBC Drivers ファイルをCData 製品のインストールフォルダからon-Premise Atom deployment インストールパス配下のパスにコピーします。
- cdata.jdbc.sage300.jar
- cdata.jdbc.sage300.lic （試用版では.lic ファイルは不要）
- コピー元：C:\Program Files\CData\CData JDBC Driver for Sage300 2019J\lib
- コピー先：C:\Boomi AtomSphere\Atom - 10.211.55.9\lib
コピーしたらBoomi Atom をブラウザからリスタート(Restart Atom)してください。作成したon-Premise Atom deployment のInstalledLibraries にJDBCの.jar ファイルが表示されれば成功です。
![JDBC Driver のon-premise Atom への配置]()
Sage 300 のConnectionの作成
Boomi Atom からSage 300 のデータソースに接続するためのConnection を作成します。
- Welcom 画面の「Component > Connetion」を選択するとCreate Component ウィザードが開きます。
- Sage 300 への接続用のConnection 設定として以下の値をセットします。
- Type: Connection
- Component Name: ConnectionCDataSage300
- Folder: 任意のパス
- Connector: Database
![Sage 300 のデータ Connection 作成1]()
- そしてJDBC Driver の接続設定を行います。
Sage 300 には、Sage 300 Web API で通信するための初期設定が必要となるます。
- Sage 300 のユーザー向けのセキュリティグループを設定します。Sage 300 のユーザーに、Security Groups の下にあるbSage 300 Web API
オプションへのアクセスを付与します（各モジュール毎に必要です）。
- /Online/Web と/Online/WebApi フォルダ内のweb.config ファイルを両方編集して、AllowWebApiAccessForAdmin
のキーを
true 設定します。webAPI アプリプールを再起動すると設定が反映されます。
- ユーザーアクセスを設定したら、https://server/Sage300WebApi/ をクリックして、web API
へのアクセスを確認してください。
Basic 認証を使用してSage 300 へ認証します。
Basic 認証を使用して接続する
Sage 300 に認証するには、次のプロパティを入力してください。プロバイダーは、クッキーを使用してSage 300 が開いたセッションを再利用することに注意してください。
そのため、資格情報はセッションを開く最初のリクエストでのみ使用されます。その後は、Sage 300 が返すクッキーを認証に使用します。
- Url：Sage 300 をホストするサーバーのURL に設定します。Sage 300 Web API 用のURL を次のように作成してください。
{protocol}://{host-application-path}/v{version}/{tenant}/ 例えば、
http://localhost/Sage300WebApi/v1.0/-/ です。
- User：アカウントのユーザー名に設定します。
- Password：アカウントのパスワードに設定します。
- Driver Type: Custom
- Class Name: cdata.jdbc.sage300.Sage300Driver
- User Name: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Password: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Connection URL: jdbc:sage300:User=SAMPLE;Password=password;URL=http://127.0.0.1/Sage300WebApi/v1/-/;Company=SAMINC;
![Sage 300 のデータ Connection 作成2]()
- Connection の値を設定したら接続テストを行います。右上のTest Connection ボタンをクリックします。実行するAtom を選択する画面が表示されるので、上記手順で作成したon-Premise Atom deployment を選択します。
- テスト接続が成功することを確認してFinish ボタンでウィザードを閉じます。
- 作成した Sage 300 のデータ への接続Connection を保存（Save）します。
Boomi Atom でのSage 300 のデータ Profile の作成
次にProfile を設定していきます。ProfileとはSQL（SELECT/INSERT/UPDATE/DELETE）実行時のフィールド定義です。
- Sage 300 のデータ のテーブルをSELECT するProfile を作成していきます。
-
- Type: Profle
- Component Name: ProfileCDataSage300
- Folder: 任意のパス
- Connector: Database
![Sage 300 のデータ Profile の作成1]()
-
二つのパラメータに、Display Name: デフォルト, Type: Select と値をセットしたら右上のImportボタンをクリックします。
![Sage 300 のデータ Profile の作成2]()
- Database Import Wizardが開くので、以下のパラメータをセットして次に進みます。
- Browse in: 上記手順で作成したon-Premise Atom deployment
- Connection: 上記手順で作成した接続Connection
![Sage 300 のデータ Profile の作成3]()
- Sage 300 のデータ 内のオブジェクトがテーブル一覧として表示されます。取得するテーブルにチェックをオンにして次に進みます。
![Sage 300 のデータ Profile のテーブル選択]()
- テーブル内のカラム一覧が表示されます。使用する項目のチェックをオンにして次に進みます。
![Sage 300 のデータ Profile のカラム選択]()
- Import ウィザードが完了します。
- DataElements のField アイコンをクリックすると選択テーブル内のカラムが定義されていることを確認できます。また、SQL Script には取得時のSQL（SELECT）が表示されています。作成したProfile を保存します。
![Sage 300 のデータ Profile の確認]()
- これでSage 300 のデータ がBoom Atom で利用できるProfile として登録されました。
Boomi AtomSphere でのSage 300 のデータ の利用
あとは、設定されたProfile はRDB と同じようにBoomi Atom 内で利用することができます。カラムにマッピングを行うこともできます。
![Sage 300 のデータ Profile をBoomi 内でマッピング]()
このようにCData JDBC ドライバをアップロードすることで、簡単にBoomi AtomSphere でSage 300 のデータ データをノーコードで連携し、使うことが可能です。
是非、CData JDBC Driver for Sage300 30日の無償評価版 をダウンロードして、お試しください。
