こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。
APOS Live Data Gateway(LDG)は、SAP Analytics Cloud をはじめとするSAP ソリューションのリアルタイムデータ接続やデータソースオプションの拡張を実現する、データ連携およびデータ変換ソリューションです。CData コネクタと組み合わせると、ユーザーはリアルタイムWooCommerce データのセマンティックレイヤービューを構築し、リレーショナルデータベースを扱うのと同じようにWooCommerce のリアルタイム分析を行うことができます。
最適化されたデータ処理が組み込まれたCData コネクタは、リアルタイムWooCommerce データを扱う上で比類のないパフォーマンスを提供します。WooCommerce に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をWooCommerce に直接プッシュし、サポートされていない操作(主にSQL 関数とJOIN 操作)は組み込みSQL エンジンを利用してクライアント側で処理します。
組み込みの動的メタデータクエリを使用すると、ネイティブデータ型を使ってWooCommerce データを操作および分析できます。
コネクタファイルのダウンロードおよびインストール
APOS Live Data Gateway を経由してWooCommerce データにアクセスするには、APOS からコネクタファイルをダウンロードしてLive Data Gateway をホストするマシンにインストールする必要があります。APOS の担当者から必要なファイルが届きます。
- CData DLL ファイル(System.Data.CData.WooCommerce.dll)をAPOS Live Data Gateway のインストールディレクトリ(デフォルトではC:\Program Files\Live Data Gateway\Admin\)にインストールします。
- CData JAR ファイル(cdata.jdbc.woocommerce.jar)をインストールディレクトリ(デフォルトではC:\Program Files\Live Data Gateway\Admin\ConnectionTest_lib\)のConnectionTest_lib フォルダにインストールします。
- CData JAR ファイル(cdata.jdbc.woocommerce.jar)をWeb UI インストールディレクトリ(例:C:\LDG_WebUI\lib\)のlib フォルダにインストールします。
WooCommerce 接続文字列の設定
APOS Live Data Gateway からWooCommerce への接続を確立する前に、WooCommerce のJDBC 接続文字列を構築する必要があります。
組み込みの接続文字列デザイナー
JDBC 接続文字列作成の補助として、WooCommerce JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。
java -jar cdata.jdbc.woocommerce.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
WooCommerce は、one-legged OAuth1.0 認証と通常のOAuth2.0 認証をサポートします。
one-legged OAuth 1.0 認証を使って接続する
次のプロパティを指定してください(NOTE:次の資格情報はWooCommerce の設定ページで生成されるもので、WordPress OAuth2.0 プラグインで生成されるものとは異なります)。
- ConsumerKey
- ConsumerSecret
WordPress OAuth 2.0 認証を使って接続する
[ プラグインを設定した後、
次の接続プロパティを指定することでWooCommerce に接続できます。
]
- OAuthClientId
- OAuthClientSecret
- CallbackURL
- InitiateOAuth - GETANDREFRESH または REFRESH のどちらかに設定してください
どちらの場合方法でも、Url プロパティをWooCommerce インスタンスのURL に設定する必要があります。
接続文字列は以下のようになります。
jdbc:WooCommerce:Url=https://example.com/; ConsumerKey=ck_ec52c76185c088ecaa3145287c8acba55a6f59ad; ConsumerSecret=cs_9fde14bf57126156701a7563fc87575713c355e5;
WooCommerce への接続とセマンティックレイヤービューの作成
コネクタファイルのインストールと接続文字列の設定が完了したら、Live Data Gateway Admin ツールでWooCommerce に接続し、Live Data Gateway Web UI でセマンティックレイヤービューを構築していきましょう。
WooCommerce への接続を構成
- APOS Live Data Gateway Manager にログインします。
- まだAPOS LDG のライセンスファイルを更新していない場合は、更新してください。
- 「File」->「Configurations」をクリックします。
- License の「...」メニューをクリックします。
- APOS チームで CData Connector ライセンスを含むライセンスファイルを選択します。
- APOS Live Data Gateway Manager で、「Add」をクリックします。
- APOS Live Data Gateway のConnection タブで、接続を設定します。
- Data Source を「Database」に設定します。
- Database を「CData Drivers」に設定します。
- Database CData Drivers を「WooCommerce」に設定します。
- Connection String を、以下の例のような先に構築した接続文字列に設定します。
jdbc:WooCommerce:Url=https://example.com/; ConsumerKey=ck_ec52c76185c088ecaa3145287c8acba55a6f59ad; ConsumerSecret=cs_9fde14bf57126156701a7563fc87575713c355e5;
- Driver Class を「cdata.jdbc.woocommerce.WooCommerceDriver」(デフォルト設定)に設定します。
- 「Test Connection」をクリックします。
- 「Save」をクリックします。
- 接続に固有の接頭辞を付けます(例:"woocommerce")。
- 新しく作成した接続をハイライトし、「File」->「Approve Users For Web UI」をクリックします。
- ビューを作成する適切なDB ユーザーを承認し、「Save」をクリックします。
これで、Live Data Gateway Web UI でセマンティックレイヤービューを構築する準備が整いました。
セマンティックレイヤービューを作成
- ブラウザで、APOS Live Data Gateway Portal に移動します。
- Connection(例:"woocommerce")を選択します。
- WooCommerce は認証にUser やPassword を必要としないため、User Name とPassword には任意の値を使用できます。
- 「Login」をクリックします。
- 接続後、「Semantic Layer」をクリックし、新しいセマンティックレイヤービューを作成します。
- 「New Semantic Layer View」をクリックします。
- Semantic Layer View Prefix およびSemantic Layer View Name を設定します。
- 「Step 2」をクリックします。
- ビューに追加したいテーブルとカラムを選択します。
- 「Step 3」をクリックします。
- 利用可能なテーブルのカラムでMeasure を選択します。
- 「Step 5」をクリックします(「Extra Dimensions」ステップはスキップします)。
- 任意のVariable Prompt を追加します。
- 「Step 6」をクリックします。
- 任意のTable Join を定義します。
- 「Review」をクリックします。
- セマンティックレイヤービューを確認し、「Save」をクリックします。
セマンティックレイヤービューを作成できたので、APOS Live Data Gateway を経由してWooCommerce データにアクセスする準備が整い、SAP Analytics Cloud や他のSAP ソリューションからWooCommerce データへのリアルタイムデータ接続が可能になりました。
詳細と無料トライアル
APOS Live Data Gateway でリアルタイムWooCommerce データを扱うための詳細は、APOS Systems - APOS Solutions - Request Evaluation Software で評価用ソフトウェアをリクエストするか、[email protected] にメールでお問い合わせください。