GMO MakeShop データをBoard に連携してビジュアライズを作成

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData ODBC Driver for GMOMakeShop は、ODBC 標準に準拠しており、BI ツールからIDE まで幅広いアプリケーションでGMO MakeShop への接続を提供します。 この記事では、CPM/BIツールのBoardからGMO MakeShop に接続、レポートを作成する方法を説明します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持った製品です。

1. GMO MakeShop をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
2. 多様なアプリケーション、ツールにGMO MakeShop データを連携
3. ノーコードでの手軽な接続設定
4. 標準SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてGMO MakeShop の接続を設定、2.board 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとGMO MakeShop への接続設定

まずは、本記事右側のサイドバーからGMOMakeShop ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

1. インストール後、ODBCデータソースアドミニストレーターにて［システムDSN］タブをクリックし、CData GMO MakeShop Source Sys（64bit or 32bit）の接続情報を構成します。（※BoardはシステムDSNのみに対応しています。ユーザーDSNの場合接続できませんので、ご注意ください。）

2. GMO MakeShop に接続するには、MembersAccessCode、OrdersAccessCode、ProductsAccessCode、およびShopId が必要です。

   GMO MakeShop へのアクセスの設定

   MembersAccessCode、OrdersAccessCode、ProductsAccessCode、およびShopId を取得するには、以下の手順に従ってください。

   • GMO MakeShop には各API のAccessCode が必要です。
   • GMO MakeShop Store Manager にログインし、メニューの「ショップ作成」をクリックします。
   • 左ナビゲーションメニューの「外部システム連携」から任意の連携対象設定ををクリックします（メニューに表示されない場合は別途GMO MakeShop にご確認ください）。
   • 商品データ連携設定の場合：認証コードの「発行」ボタンをクリックし、ProductsAccessCode を取得します。
   • 注文データ連携設定の場合：最初に「注文情報参照」と「注文情報変更」の設定を選択します。選択後、認証コードの「発行」ボタンをクリックし、OrdersAccessCode を取得します。
   • 会員データ連携設定の場合：最初に「会員情報の（参照・登録・変更・削除）」の設定を選択します。選択後、認証コードの「発行」ボタンをクリックし、MembersAccessCode を取得します。
   • 会員認証連携設定の場合：認証コードの「発行」ボタンをクリックし、ProductsAccessCode を取得します。

   GMO MakeShop アカウントの認証

   次の接続プロパティを設定して接続します。

   • ShopId：接続先のGMO MakeShop Store ID を設定。GMO MakeShop Store ID はログイン用の ID と同じです。
   • OrdersAccessCode：「注文データ連携設定」から取得した「認証コード」を設定。このプロパティは Orders テーブルにアクセスする場合に必要です。
   • ProductsAccessCode：「商品データ連携設定」から取得した「認証コード」を設定。このプロパティは Products テーブルにアクセスする場合に必要です。
   • MembersAccessCode：「会員データ連携設定」から取得した「認証コード」を設定。このプロパティは Members テーブルにアクセスする場合に必要です。
   • MemberAuthenticationCode：「会員認証連携設定」から取得した「認証コード」を設定。このプロパティは MemberAuthenticationConfirm を実行する場合に必要です。
   • Password：GMO MakeShop Store Manager のログインユーザーのパスワードを指定。このプロパティは ProductCategoryRegistrationOrModification,ProductMemberGroupPriceRegistrationOrModification,ProductOptionRegistrationOrModification,ProductRegistrationOrModification を実行する場合に必要です。

Board DB の作成

最初にBoardの接続情報やキューブ等を格納するDBを作成します。

1. Boardを立ち上げて、任意の接続先へ接続します。
2. ［Database］タブから［New DB］をクリックします。
3. 開いたDB作成用ウィンドウにて、任意の［Database name］［Language］［From Year］［To Year］を入力し［OK］をクリックします。

SQL FastTrackを用いたODBCデータソースからのデータロード

次にSQL FastTrackの機能を用いてODBCデータソースから GMO MakeShop のデータをBoard上にロードします。

1. ［Database］タブの［SQL FastTrack］をクリックし、Data souceの［New］ボタンをクリックします。
2. 接続先を設定するためのウィンドウが表示されますので、［OLE-DB Wizard］をクリックします。
3. 開いたデータリンクプロパティの［プロバイダー］タブから［Microsoft OLE DB Provider for ODBC Drivers］を選択し、［次へ］をクリックします。
4. ［接続タブ］の［1.データソースを指定します］から事前に設定したODBC DSNを選択し、［3.使用する初期カタログを入力します］に［CData］を入力の上、［OK］をクリックします。
5. 任意の［Name］を入力し［Save & Connect］をクリックします。
6. SQL FastTrackの画面に戻った後、［Connect］をクリックします。
7. Connectをクリック後、Data souce画面左側に GMO MakeShop のテーブル一覧が表示されます。分析対象とするテーブルをダブルクリックすると、自動的にSQL クエリが記述されます。記述内容を確認の上、［Execute Query］をクリックします。
8. Execute Queryをクリックすると、テーブルに格納された項目一覧が以下の図のように表示されます。分析で使用したい任意の項目を［Code］［Desc］［Cube］のいずれかにチェックを入れ、Cube/Entityを入力し、Track実行ボタンをクリックします。
9. 確認ダイアログが表示されますので、［Yes］をクリックします。
10. SQL FastTrackの機能により、ODBC データソースからデータがロードされ、自動的にEntityとCubeが生成されます。
11. 以下のダイアログが表示されれば、Boardへのデータロードは完了です。

グラフの作成

ロードしたデータを元に簡単なグラフの作成方法を紹介します。

1. 最初に各種Screenを格納するためのCapsuleを作成します。［Home］タブを選択し［Capsule］から［New Capsule］をクリックします。
2. 任意の［Capsule Name］を入力し［OK］をクリックします。
3. 続いてScreenを作成するための画面が表示されるため任意の［Screen Name］を入力し［OK］をクリックします。
4. Screenが作成されると、ChartやDataViewを配置することが可能になります。［Charts］から［Chart］を選択し、Screenにドラッグ・アンド・ドロップでChartを配置します。
5. 以下のようにChartを配置後、右クリックメニューで［Layout］をクリックします。
6. LayoutでChart上のValueとして扱う値を指定します。［Data］タブから［Double-click here to create a block］の箇所をダブルクリックします。
7. ［Data Selection］から先程のSQL FastTrackにてCubeの指定をした任意の値を選択し［OK］をクリックします。
8. 続いて［Axes］タブをクリックし、先程指定した値の分析軸とするBy Rowに任意の項目を選択し［OK］をクリックします。
9. 設定完了後、以下のようにグラフが表示されます。

このようにGMOMakeShop 内のデータをAPI を書くことなくBoard上で利用することができるようになります。