Business b-ridge データをWagby に繋いでみた

こんにちは！リードエンジニアの杉本です。

CData JDBC Driver for BusinessBridge は、JDBC 標準をインプリメントし、BI ツールからIDE まで幅広いアプリケーションでBusiness b-ridge への接続を提供します。この記事では、超高速開発ツールであるWagby からBusiness b-ridge に接続一覧表示する方法を説明します。

完成イメージ

以下のようにWagbyの一覧画面で Business b-ridge から取得したデータを表示する画面を作成します。

1.CData Business b-ridge JDBC Driverのダウンロード・インストール

まず、WagbyとBusiness b-ridgeの連係のために使用するCData Business b-ridge JDBC Driverのダウンロード・インストールを実施します。

CData Business b-ridge JDBC Driverは下記URLより30日間試用版が入手できます。

https://www.cdata.com/jp/drivers/businessbridge/jdbc/

ダウンロード後、ZIPファイルを解凍しsetup.jarを実行します。

2.ドライバーjarファイルおよびlicファイルの配置

1. 続いて、WagbyでCData Salesforce JDBC Driverを利用できるようにするため、Wagbyへライブラリを配置します。 CData Salesforce JDBC Driverインストール後、「C:/Program Files/CData/CData JDBC Driver for Salesforce 2017J/lib」のフォルダに含まれる以下のファイルをWagbyのライブラリフォルダへ配置します。 Wagbyへのファイル配置先は、/customize/tomcat/libです。

「cdata.jdbc.businessbridge.jar」

「cdata.jdbc.businessbridge.lic」

3.データベース設定ファイルの作成

続いてCData DriverをWagbyで使用できるようにするための、データベース設定ファイルをWagby上へ配置します。

1. 以下の内容で「database.txt」というファイルを作成します。
cdata.database_label=CData Business b-ridge Driver cdata.database_type=cdata cdata.driver=cdata.jdbc.businessbridge.BusinessBridgeDriver cdata.url=jdbc:businessbridge: cdata.quoteid=\" cdata.quotewhere= cdata.quoteidinwhere=\" cdata.quoteidforhibernate=\" cdata.hibernateDialect=jp.jasminesoft.jfc.hibernate.dialect.SQLServer2012Dialect cdata.maxTablenameLength=128 cdata.maxIndexnameLength=128 cdata.maxColumnnameLength=128 cdata.maxLengthStringDataType=nvarchar(1000) cdata.characterLargeObjectDataType=NVARCHAR(MAX) cdata.supportTimeDataType=false cdata.searchStringEscapeInLike=\\ cdata.createSequenceDDL=CREATE SEQUENCE $QUOTEID$SEQNAME$QUOTEID $MINVALUE$MAXVALUESTART WITH $START NO CACHE CYCLE cdata.sequenceDML=SELECT NEXT VALUE FOR $QUOTEID$SEQNAME$QUOTEID cdata.springBatchDDL=batch_sqlserver.ddl cdata.masterDDL=master_sqlserver2000.ddl cdata.validationQuery=SELECT 1
2. 作成したファイルは「/repository/trunk」へ配置します。

4.サブデータベースの指定

それでは実際にWagbyで Business b-ridge データを読み込むための設定を行っていきます。

Wagbyはシステムを構成するための基軸となるデータを保管するためのメインデータベースと外部データを参照するためのサブデータベースで構成されています。CData Driver はこのサブデータベースを利用することで、各データソースからシームレスにデータの参照を実施できます。

1. デスクトップに配置されたWagby Designer起動をクリックし、Wagby Designerを立ち上げます。
2. 起動後、以下URLにアクセスし、Wagby Designer画面を表示します。

http://localhost:8920/wagbydesigner/logon.jsp

3. 「環境」→「データベース」→「サブ」を選択し、サブデータベースにて以下のプロパティを設定します。

データベース：CData Business b-ridge Driver

接続URL：jdbc:businessbridge:

ユーザー名：使用しませんが、必須項目のため適当な文字列を入力します。

パスワード：使用しませんが、必須項目のため適当な文字列を入力します。

4.モデルの作成

続いて、対象サービスと連携するモデルの作成を実施します。

1. 「モデル」→「新規モデル」をクリックします。
2. モデル作成画面にて、取得したテーブル情報に合わせて、画面項目を作成します。 「モデルID」と「項目ID」は対象サービスのテーブル名・カラム名に基づいて指定します。
3. 上記設定後、一覧表示にも各行でチェックを入れます。
4. CData Driverはメタデータの生成に対応していないため、Wagbyが自動的に実行するテーブルの作成機能をOFFにする必要があります。 モデル画面から「画面」→「その他」を選択し以下の項目を設定します。

「テーブルを作成する」　←　チェックを外します。

「物理テーブル名」　←　上記テーブル名と同じ名称を指定します。

「サブデータベース」　←　手順2で指定したサブデータベースを選択します。

5.ビルドの実行

ビルドを実行し、サブデータベース・モデルの設定値をビルドファイルに反映させます。ビルドはサブデータベースを指定したため、フルビルドで行ってください。

1. 「ビルド」から「フルビルド」を選択し、「ビルド実行」をクリックします。

6.アプリケーションの起動

実際にユーザーが使用する画面を用いて、動作確認を実施します。

1. Wagby Designerの画面に戻り、「アプリケーション起動」をクリックします。
2. 対象の画面を表示することで、 Business b-ridge データ からシームレスにデータの取得が可能です。

このように BusinessBridge 内のデータを API を書くことなく Wagby 上で処理することができるようになります。

サポートされるSQL についての詳細は、ヘルプドキュメントの「サポートされるSQL」をご覧ください。テーブルに関する情報は「データモデル」をご覧ください。