デジタルワークプレイス Slingshot のダッシュボードでAPI のデータを可視化・分析

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

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

CData Connect AI の設定

Slingshot でAPI のデータをリアルタイムで操作するには、Connect AI からAPI に接続し、コネクションにユーザーアクセスを提供してAPI のデータのOData エンドポイントを作成する必要があります。

（オプション）新しいConnect AI ユーザーの追加

必要であれば、Connect AI 経由でAPI に接続するユーザーを作成します。

1. ユーザーページに移動し、 Invite Users をクリックします。
2. 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
3. ユーザーページからユーザーを確認および編集できます。

パーソナルアクセストークンの追加

OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. Connect AI アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
2. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
3. PAT の名前を入力して Create をクリックします。
4. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

Connect AI からAPI に接続

CData Connect AI では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。

1. Connect AI にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「API」を選択します。
3. 必要な認証プロパティを入力し、API に接続します。

   To connect to your API, configure the following properties on the Global Settings page:

   • In Authentication, select the Type and fill in the required properties
   • In Headers, add the required HTTP headers for your API
   • In Pagination, select the Type and fill in the required properties

   After the configuring the global settings, navigate to the Tables to add tables. For each table you wish to add:

   1. Click "+ Add"
   2. Set the Name for the table
   3. Set Request URL to the API endpoint you wish to work with
   4. (Optional) In Parameters, add the required URL Parameters for your API endpoint
   5. (Optional) In Headers, add the required HTTP headers for the API endpoint
   6. In Table Data click " Configure"
   7. Review the response from the API and click "Next"
   8. Select which element to use as the Repeated Elements and which elements to use as Columns and click "Next"
   9. Preview the tabular model of the API response and click "Confirm"
   
4. Create & Test をクリックします。
5. Edit API Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

Connect AI にAPI OData エンドポイントを追加する

API に接続したら、目的のテーブルのOData エンドポイントを作成します。

1. OData ページに移動し、 Add to create new OData endpoints をクリックします。
2. API 接続（例：API1）を選択し、Next をクリックします。
3. 使用するテーブルを選択し、Confirm をクリックします。

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

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

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

1. Slingshot の対象のワークスペースに移動して「データソース」タブに移動し「＋データソース」をクリックします。

2. データソースの一覧から利用したいサービスを選択します。ここで先程CData Connect AI で設定したOData エンドポイントの接続を追加します。

3. 「URL」にOData エンドポイントのURL を指定し「先制認証を使用する」にチェックを入れます。その上で「資格情報」を追加しましょう。

4. 資格情報の種類は「汎用資格情報」になります。合わせてCData Connect AI へのログインユーザーIDをユーザー名に入力し、パスワードには先程生成したPAT を入力します。

5. あとは「データソースの追加」をクリックすれば、データソースの接続設定は完了になります。

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

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

1. 「ダッシュボード」タブに移動して「＋ダッシュボード」をクリックします。

2. 先程追加したCData Connect AI へのOData フィードデータソースが表示されるので、これを選択します。

3. すると、事前にCData Connect AI 上で登録しておいたテーブルの一覧がエンティティのセットとして表示されるので、任意のエンティティを選択しましょう。

4. これでSlingshot 上に対象のデータがシームレスに読み込まれます。あとは可視化するためのラベルや値を選択することで、以下のように簡単にビジュアライズが実施できます。

このように、CData Connect AIを経由することで、API 側の複雑な仕様を意識せずにAPI 連携をしたダッシュボードをSlingshot で開発できます。他にも多くのデータソースに対応するCData Connect AI の詳細をこちらからご覧ください。