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

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

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

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

CData Connect Cloud の設定

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

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

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

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

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

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

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

Connect Cloud からUM SaaS Cloud に接続

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

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

   UM SaaS Cloud 接続プロパティの取得・設定方法

   デフォルトでは、本製品は本番環境に接続します。UMSaaSCloud sandbox アカウントを使用するには、UseSandbox をtrue に設定します。ユーザー / パスワード認証を使用している場合は、User にsandbox のユーザー名を設定してください。

   UM SaaS Cloud への認証

   UM SaaS Cloud は、Basic、OAuth、OAuthJWT（コンシューマーキー）など、複数の認証方式をサポートしています。ここではBasic 認証について説明します。認証情報の詳しい取得方法や他の認証方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。

   Basic 認証

   Basic 認証は、セキュリティトークンとユーザー資格情報の使用に基づきます。Basic 認証を使用するには、AuthScheme をBasic に、User とPassword をログイン資格情報に設定し、SecurityToken を設定します。

   デフォルトではSecurityToken が必要ですが、UM SaaS Cloud で信頼できるIP アドレスの範囲を設定することで、オプションにすることができます。

4. Create & Test をクリックします。
5. Edit UM SaaS Cloud Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

Connect Cloud にUM SaaS Cloud OData エンドポイントを追加する

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

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

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

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

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

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

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

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

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

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