最近とてもCMが印象的なSANSAN

社長が持っている名刺にキーマンが含まれているにもかかわらず、その情報を部下が持っていないばかりに、商談の機会を逃してしまうというものでした。

社内での顧客管理の大切さを感じながらも、コメディタッチなCMで面白いのがいいですね。

そんな繋がりを、SANSANデータを元に可視化できたら面白いかも！？　と思いSANSANから提供されているAPIを利用して、Network図を作ってみました！

こんな可視化をしてみた

構成イメージとしては以下のような感じです。

人対人だと、対会社で動いている繋がりが見えづらいので、会社情報を中心に、Graph DBのような形でデータをまとめてしまいます。

f:id:sugimomoto:20180419181150p:plain

そして、Power BIのNetwork Network Navigator Chartを使って、以下のようにビジュアライズしました！

f:id:sugimomoto:20180419182452p:plain

appsource.microsoft.com

SANSAN APIについて

SANSANは名刺管理機能をメインとしたSaaS型クラウドアプリケーションです。

詳しくは以下のURLからどうぞ。

jp.sansan.com

SANSAN APIでは、現在以下の7種類のエンドポイントが提供されています。どれも名刺に関連したエンドポイントですね。今回は名刺Set取得の条件指定をベースにAPIを利用していますが、今回のネットワーク図を作るだけであれば、特に意識する必要はありません。

名刺Set取得（期間指定）
名刺Set取得（条件指定）
名刺取得
名刺画像取得
名刺のタグSet取得
人物取得
タグSet取得

なお、ドキュメントは以下のURLで公開されています。

jp-help.sansan.com

実現イメージ

今回はAPIの連係対象BIツールとして、Power BIを使用しますが、各APIは単純にBIツールに接続することはできません。各BIツールがどのようにWeb API側へリクエストを投げるべきかの判断材料やメタデータの情報が無いためです。

f:id:sugimomoto:20180419181256p:plain

そこで、CData REST ODBC Driverを用いて、このボトルネックを解決します。

まず、各BIツール（PowerBI、QlikSence、Tableau）からはODBCインタフェースでSQL（Select文）をCData REST ODBC Driverに向けて発行してもらいます。そのリクエストを受け取った、CData ODBC REST Driverは、SANSANのWebAPIのエンドポイントに対して、SQL文を解釈し、HTTPリクエスト形式に変換して、Getメソッドを発行します。

リクエスト後、Jsonフォーマットで返ってきたデータセットはCData REST ODBC DriverがODBCインタフェースのResultsetに変換してBIツールに返します。

f:id:sugimomoto:20180419181310p:plain

これにより、BIツールからアドホックにSQLによるリクエストがあったタイミングで最新のデータをSANSANから取得することが可能です。

前提条件

本記事では以下のサービスや製品を使用しています。

SANSANアカウント
CData REST ODBC Driver ※30日間の評価版あり
PowerBI Desktop ※無料トライアル版あり

手順

SANSAN Web API 利用準備

まず、SANSANへWeb APIアクセスするにあたって必要となるAPIキーを取得します。

SANSANログイン画面へ移動し、ログインを行います。

https://ap.sansan.com/v/SSLogin.aspx

f:id:sugimomoto:20180419181337p:plain

TOPページに表示されている「外部サービス連携」をクリックし

f:id:sugimomoto:20180419181347p:plain

「API」タブから対象ユーザーを選択し「発行」をクリックします。

f:id:sugimomoto:20180419181356p:plain

すると、以下のようにAPI Keyが発行されます。このAPI Keyを後ほど使用するので、控えておいてください。

f:id:sugimomoto:20180419181403p:plain

以上でSANSAN側の準備は完了です。

REST データ処理用 RSDファイルの作成

続いて、SANSANのWeb APIをCData ODBC REST DeiverがSQLとして解釈できるように設定ファイルを作成します。

サンプルとしてSANSANの名刺データ (bizcard)のデータを取得するための設定ファイルを作成していますので、以下のGitHubから保存して、利用してみてください。

github.com

保存先フォルダは後ほど使用するので「C:\CData_REST\SANSAN」といった書き込み可能な任意のフォルダに配置してください。

CData ODBC REST Driverのインストール

PowerBIとSANSANのAPIを繋ぐために必要となるCData ODBC REST Driverをインストールします。

CData REST ODBC Driverの30日間の評価版をダウンロードします。ダウンロードの際には、Emailの登録が必要となります。

f:id:sugimomoto:20180419181437p:plain

ダウンロードしたsetup.exeファイルをBIツールがインストールされているマシンにインストールします。インストールウィザードに従い、EULAを確認した上でインストールを完了します。

f:id:sugimomoto:20180419181445p:plain

※途中、ライセンスサーバーへのオンラインアクティベーションが行われるためネットワーク環境に接続されている必要があります。

インストールが完了すると、ODBCのDSN設定のウィンドウが立ち上がります。

以下の項目をセットし、保存します。

Schema
- Location : 先程RSDファイルを配置したフォルダパス（例：C:\CData_REST\SANSAN）
その他
- Other　：　ApiKey=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX;range=all;

OtherのApiKeyには、先程取得したSANSANのAPIキーを入力してください。

f:id:sugimomoto:20180419181501p:plain

以上で、CData ODBC REST Driverの準備は完了です。

PowerBIでの接続確認

それでは、実際にPowerBIと接続して、データの取得処理を実施してみましょう。

PowerBI Desktopを起動して、「データを取得」をクリックします。

f:id:sugimomoto:20180419181513p:plain

データ接続先一覧の中から「ODBC」を選択し、「接続」をクリックします。

f:id:sugimomoto:20180419181523p:plain

データソース名は先程登録したSANSANを選択し、「詳細設定オプション」のSQL ステートメントに以下のクエリを入力します。

f:id:sugimomoto:20180419181529p:plain

このSQLでは、まずどの「社内ユーザー」がどの「取引先」と名刺交換したか？　という情報を持ってきます。

/* 社内ユーザーデータと名刺交換先企業データ取得クエリ。このSampleでは1000件リミットをかけています。 */ 

SELECT owner_id as id, owner_name as user, companyName, companyId FROM [REST].[bizcard] LIMIT 1000

クエリ結果のデータを確認し、読み込みを行います。

上記データ取得後、さらにデータ取得を行います。先程と同様の手順でSANSANデータソースへ接続し

f:id:sugimomoto:20180419181537p:plain

今度は、取引先担当者がどの取引先に所属しているか？　の情報を以下のクエリで取得します。

/* 名刺交換先企業データとその担当者データ取得クエリ。このSampleでは1000件リミットをかけています。 */

SELECT id, CONCAT(lastName,' ',firstName) as user, companyName,companyId FROM [REST].[bizcard] LIMIT 1000

それぞれのデータ取得が完了したら、それぞれのクエリ結果をマージします。

「クエリを編集」からPower Query エディター画面を表示し

f:id:sugimomoto:20180419181547p:plain