こんにちは。プロダクトチームの周です。
本記事では CData ODBC Driver for API とロジレス（LOGILESS）向けのAPI Profile を使って、ロジレス からデータを取得してPower BI で分析を行う方法を紹介いたします。
ロジレス とは？
LOGILESS は受注業務・出荷業務・在庫管理を自動化するクラウドサービスです。
https://www.logiless.com/
標準で多くのモール・カートサービスに連携しており、在庫情報を自動で更新できるようになっているのが特徴です。
またロジレス では開発者向けAPI が提供されており、API 経由で商品や仕入先などの各種マスタデータや受注伝票・出荷伝票などのトランザクションデータを取得・更新できるようになっています。
https://app2.logiless.com/developer/
実現イメージ
今回は Microsoft Power BI から ロジレス API に接続する方法を紹介します。
Power BI は汎用のWeb コネクタやPowerQuery を用いることで各種API に接続が可能です。しかしながら、API に関する知識の習得はもちろんのこと、ページネーション・認証・取得したデータのスキーマ対応をどのように対応するかといった課題が存在し、分析担当者が簡単に接続できるとまでは言えません。
そこで、CData API Driver とロジレス向けのAPI Profile を用いて、このボトルネックを解決します。
各ツールが標準で持っているODBC やJDBC のインターフェースを持っています。CData API Driver はその標準インターフェースを利用し、各ツールから受け取ったSQL を変換します。そしてロジレス向けのAPI Profile と組み合わせることで、ロジレス API へのリクエストを適切に行うようにします。
リクエスト後、Jsonフォーマットで返ってきたデータセットはCData API Driver が各インタフェースのテーブル形式に変換してBI ツールに返すようにします。
これにより、各種ツールからアドホックにSQL によるリクエストがあったタイミングで最新のデータを API から取得することが可能です。
なお、今回はPower BI から接続としましたが、Tableau やQlik などからも同じように接続が可能である点が特徴です。各BI ツールでそれぞれロジレス専用のコネクターを作る必要がありません。
お役立ち情報
Power BI から300種類以上のSaaS やDB に簡単接続！～CData Power BI Connectors ポイント解説～
- Power BI × SaaS 連携の現状と課題
- CData Power BI Connectors の特徴
- SaaS への接続方法をわかりやすく解説
製品資料を無料でダウンロード
手順
それでは実際に Power BI と ロジレス API の接続方法を説明します。
Power BI は以下URL から予めデスクトップ版をダウンロードしておいてください。
powerbi.microsoft.com
ロジレス API 用のアプリの作成
まず以下のページに移動して、ロジレスのAPI を使うためのOAuth アプリの登録を行います。（登録にはログインが必要です）
https://app2.logiless.com/developer/console/clients
任意のアプリケーション名を入力し、リダイレクトURLに「htto://localhost:33333」を指定します。
作成後、対象のアプリケーションをクリックすると
クライアントIDとクライアントシークレットが入手できます。この情報を後ほど使用します。
ロジレス（LOGILESS）向けのAPI Profile のダウンロード
次に、ロジレス向けのAPI Profile ファイル「Logiless.apip」を下記ページからダウンロードします。ロジレス以外にも各種データソース向けのAPI Profile が提供されています。
https://www.cdata.com/jp/apidriver/download/#:~:text=Logiless
「Logiless.apip」を書き込み可能な任意のフォルダに保存して、そのフルパス（例：C:\CData_APIProfiles\Logiless.apip）は後ほど使用します。
CData ODBC Driver for API のインストール
Power BI と ロジレス API を繋ぐために必要となるCData ODBC Driver for API をインストールします。
まず、以下のURLからCData ODBC Driver for API の30日間の評価版をダウンロードします。ダウンロードの際には、Emailの登録が必要となります。
https://www.cdata.com/jp/apidriver/download/
ダウンロードしたAPIDriverforODBC.exe ファイルをBI ツールがインストールされているマシンにインストールします。インストールウィザードに従い、EULA を確認した上でインストールを完了します。
※途中、ライセンスサーバーへのオンラインアクティベーションが行われるためネットワーク環境に接続されている必要があります。
インストールが完了すると、ODBC のDSN 設定のウィンドウが立ち上がります。
以下の項目をセットし、保存します。OAuthClientId とOAuthClientSecret には事前に取得したロジレスOAuth アプリの各値を設定してください。また、Other には接続先となるマーチャントIDを指定します。
- Profile：C:\CData_APIProfiles\Logiless.apip
- Profile Settings：'MerchantId=マーチャントIDを指定;'
- Auth Scheme：OAuth
- Initiate OAuth：GETANDREFRESH
- OAuth Version：2.0
- OAuth Client Id：事前に作成したロジレスOAuthアプリのクライアントIDを指定
- OAuth Client Secret：事前に作成したロジレスOAuthアプリのクライアントシークレットを指定
- Callback URL：http://localhost:33333
入力後「接続テスト」をクリックするとブラウザが立ち上がり、以下のようにログインを求められます。
ログイン後、アプリケーションのアクセス許可確認画面が表示されるので「承認」をクリックします。
ODBC DSN 構成画面に戻り、以下のようにメッセージが表示されればOK です。
以上で、CData ODBC Driver for API の準備は完了です。
Power BI からの接続
それでは、Power BI から CData ODBC Driver for API に接続します。
Power BI デスクトップを立ち上げて「データを取得」をクリックし
ODBC 接続を選択します。
データソース名から先程ODBC で登録したDSN を選択し、Windows 認証で接続します。
すると、以下のようにテーブル化された ロジレス API のリソースが選択できるようになります。
以上で、Power BI にフラットな形で ロジレスの商品や受注のが取り込まれます。
あとは Power BI の機能を活用して、ロジレスの受注データや在庫状況を分析できます。
おわりに
本記事では Power BI をもとに解説しましたが、CData API Driver ではPower BI 以外のBI ツールやアナリティクスツールの接続もサポートしています。
以下のURLで各ツールの接続リファレンスを公開していますので、普段使っているツールから是非試してみてください。
https://www.cdata.com/jp/apidriver/
関連コンテンツ
