Slingshot でTaxJar のデータ連携してダッシュボードを作成

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

Slingshot はインフラジスティックス社が提供するオールインワンのデジタルワークプレイスサービスです。この記事では、CData Connect Server を経由してSlingshot からTaxJar に連携するダッシュボードを作成する方法を説明します。

CData Connect Server は、TaxJar のデータのクラウド to クラウドの仮想OData インターフェースを提供し、Slingshot からリアルタイムにTaxJar のデータへ連携することができます。

TaxJar の仮想OData API エンドポイントを作成

まずCData Connect Server でデータソースへの接続およびOData API エンドポイント作成を行います。

1. CData Connect Server にログインして、Databases をクリックします。
2. 利用できるデータソースアイコンから"TaxJar" を選択します。
3. TaxJar に接続するために必要なプロパティを入力します。

   TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。

   NOTE：API の利用は、Professional およびPremium TaxJar プランでのみ可能です。

   すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、「アカウント」->「TaxJar API」に移動するとAPI キーを確認することができます。 API キーを取得したら、APIKey 接続プロパティに設定できます。

   その他の注意事項

   • デフォルトでは、エンティティが日付範囲フィルタをサポートしている場合、CData コネクタは過去3か月のデータを取得します。StartDate を設定して、取得するデータの最小作成日を指定することができます。
   • API キーがサンドボックスAPI アカウント用に作成されている場合は、UseSandbox をtrue に設定してください。ただし、すべてのエンドポイントが期待どおりに機能するとは限りません。詳しくは、TaxJar 開発者用ドキュメントを参照してください。
4. Test Database をクリックします。
5. Permission -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
6. API タブをクリックして OData API エンドポイントが生成されていることを確認します。

コネクションとOData エンドポイントを設定したら、Slingshot からTaxJar のデータに接続できます。

Slingshot にデータソースを追加する

CData Connect Server の設定が完了したら、Slingshot 側に接続設定を追加しましょう。

1. Slingshot の対象のワークスペースに移動して「データソース」タブに移動し「＋データソース」をクリックします。
2. データソースの一覧から利用したいサービスを選択します。ここで先程CData Connect Server で設定したOData エンドポイントの接続を追加します。
3. 「URL」にOData エンドポイントのURL を指定し「先制認証を使用する」にチェックを入れます。その上で「資格情報」を追加しましょう。
4. 資格情報の種類は「汎用資格情報」になります。合わせてCData Connect Server のユーザー名を入力し、パスワードには先程生成したトークンを入力します。
5. あとは「データソースの追加」をクリックすれば、データソースの接続設定は完了になります。

ダッシュボードを作成する

すべての準備が整ったのでTaxJar のデータを活用してダッシュボードを作成していきましょう。

1. 「ダッシュボード」タブに移動して「＋ダッシュボード」をクリックします。
2. 先程追加したCData Connect Server へのOData フィードデータソースが表示されるので、これを選択します。
3. すると、事前にCData Connect Server 上で登録しておいたテーブルの一覧がエンティティのセットとして表示されるので、任意のエンティティを選択しましょう。
4. これでSlingshot 上に対象のデータがシームレスに読み込まれます。あとは可視化するためのラベルや値を選択することで、以下のように簡単にビジュアライズが実施できます。

このように、CData Connect Server を経由することで、API を意識することなくSlingshot でダッシュボードを作成できます。他にも多くのデータソースに対応するCData Connect Server の詳細をこちらからご覧ください。