製品をチェック

ShipStation Driver の30日間無償トライアルをダウンロード

 30日間の無償トライアルへ

製品の詳細

ShipStation アイコン ShipStation JDBC Driver 相談したい

ShipStation データに連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。

ShipStation のデータをWagby に繋いでみた

ShipStation を高速開発ツールの Wagby にデータ接続して、データソースとする方法。

杉本和也
リードエンジニア

最終更新日:2022-04-13
shipstation ロゴ

CData

jdbc ロゴ画像
Wagby ロゴ

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

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

完成イメージ

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

Wagby

1.CData ShipStation JDBC Driverのダウンロード・インストール

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

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

https://www.cdata.com/jp/drivers/shipstation/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です。
  2. 「cdata.jdbc.shipstation.jar」

    「cdata.jdbc.shipstation.lic」

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

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

  1. 以下の内容で「database.txt」というファイルを作成します。
  2. cdata.database_label=CData ShipStation Driver cdata.database_type=cdata cdata.driver=cdata.jdbc.shipstation.ShipStationDriver cdata.url=jdbc:shipstation:APIKey='YourAPIKey';APISecret='YourAPISecret' 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
  3. 作成したファイルは「/repository/trunk」へ配置します。

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

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

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

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

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

    データベース:CData ShipStation Driver

    接続URL:jdbc:shipstation:APIKey='YourAPIKey';APISecret='YourAPISecret'

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

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

4.モデルの作成

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

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

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

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

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

5.ビルドの実行

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

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

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

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

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

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

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

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。