MotionBoard からTypeform のデータに連携してダッシュボードを作成

MotionBoard は、ウイングアーク1st 社が提供する人気のBI ダッシュボードツールです。この記事ではMotionBoard で、Typeform のデータをCData Connect を通じてシームレスに統合利用する方法を説明します。

CData Connect AI は、SaaS 型のデータ仮想化プラットフォームです。Salesforce、Dynamics、Zoho CRM、NetSuite、Marketo、kintone など150以上の多様なSaaS にBI ツール、アナリティクス、iPaaS、ノーコード開発プラットフォームからアクセスするための仮想エンドポイントを提供します。連携方法が異なるSaaS をSQL Server 、SQL Server、OData の3種類のインターフェースに仮想化することで、データ連携をシンプルに実現します。

この記事では、Typeform のデータを仮想SQL Server エンドポイントして利用してMotionBoard からデータを取得、可視化します。

Connect AI からTypeform に接続する

CData Connect AI では、直感的なクリック操作ベースのインターフェースを使ってデータソースに接続できます。

1. Connect AI にログインし、 Add Connection をクリックします。

2. Add Connection パネルから「Typeform」を選択します。

3. 必要な認証プロパティを入力し、Typeform に接続します。

   まず、Profile 接続プロパティにTypeForm プロファイルのディスク上の場所を設定します（例：C:\profiles\TypeForm.apip）。次に、ProfileSettings 接続プロパティにTypeForm の接続文字列を設定します（以下を参照）。

   TypeForm API プロファイル設定

   TypeForm への認証にはOAuth 標準を使用します。

   TypeForm に認証するには、まずTypeForm でOAuth アプリケーションを登録および設定する必要があります：https://admin.typeform.com/account#/section/tokens。アプリにはclient ID とclient secret が割り当てられ、接続文字列で設定できます。OAuth アプリケーションの設定の詳細については、https://developer.typeform.com/get-started/ をご参照ください。

   使用シナリオによって異なるリダイレクトURI が必要です：

   • CData デスクトップアプリケーション：CData デスクトップアプリケーション（Sync、API Server、ArcESB）は/src/oauthCallback.rst でOAuth トークンを受け入れます。ホストとポートはアプリケーションが使用するデフォルトポートと同じです。例えば、http://localhost:8019/ でCData Sync にアクセスする場合、リダイレクトURI はhttp://localhost:8019/src/oauthCallback.rst になります。
   • CData クラウドアプリケーション：CData クラウドアプリケーションはデスクトップ版と同様です。https://1.2.3.4/ でConnect AI にアクセスする場合、リダイレクトはhttps://1.2.3.4/src/oauthCallback.rst を使用します。
   • デスクトップアプリケーション：デスクトップアプリケーションを使用する場合、URI はhttps://localhost:33333 を推奨します。
   • Web アプリケーション：ドライバーを使用してWeb アプリケーションを開発する場合、https://my-website.com/oauth のような独自のURI を使用します。

   以下の接続プロパティを設定すると、接続の準備が整います：

   • AuthScheme：OAuth に設定します。
   • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
   • OAuthClientId：アプリ設定で指定されているClient Id を設定します。
   • OAuthClientSecret：アプリ設定で指定されているClient Secret を設定します。
   • CallbackURL：アプリ設定で指定したRedirect URI を設定します。
   
4. Create & Test をクリックします。

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

MotionBoard への接続には、パスワードの代わりとしてパーソナルアクセストークンを利用します。セキュアなアクセス管理を実現するには、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. Connect AI アプリの右上にある歯車アイコンをクリックします。
2. Settings ページで「Access Tokens」タブに移動し、 Create PAT をクリックします。
3. PAT の名前を入力して Create をクリックします。

4. パーソナルアクセストークンは作成時にしか表示されないため、コピーして安全に保存してください。

MotionBoard からTypeform のデータに接続してダッシュボードを作成

MotionBoardの「システム設定 → 接続/認証 → 外部接続」から新しい外部接続を作成します。接続先タイプはSQL Server を選択します。

• 外部接続名：任意（例：CDataConnect）
• 接続先タイプ：SQL Server
• 中継サービス：使用しない

外部接続の基本情報タブにて以下内容をセットします。

• 外部接続名：任意（例：CDataConnect）
• 接続先タイプ：SQL Server
• 接続先タイプ：SQL Server 4.0(JDBC)
• 中継サービス：使用しない
• サーバー名：tds.cdata.com
• ポート : 14333
• データベース名 : 先ほどConnect AI で作成した接続先データソース名(例：Typeform1)
• ユーザー名 : Connect AI のユーザー名（メールアドレス）
• パスワード : パーソナルアクセストークン

基本情報エリアの最下部に「接続確認」ボタンをクリックして外部接続の確認が取れることを確認します。

「データソース」タブを開き、Typeform 内のテーブルが一覧に表示されることを確認できます。ここまで確認できたら「保存」ボタンで外部接続定義を保存して閉じます。

「ボード新規作成」から新しいボードを作成します。

アイテムウィザードのDS1の接続先に上記の外部接続定義で作成した接続（本例では Cdata Connect）を選択します。次に、左側のデータベースにTypeform のテーブルリストが表示されますので、使用するテーブルを選択します。右側にDealsテーブル内のデータがプレビューされます。

ウィザードを次に進み、作成するアイテムにチャートを選択して、「次へ」をクリックします。データソース エディタが起動します。左側の項目一覧から可視化したい項目を行項目・列項目・集計項目にセットします。もうRDB やCSV などのデータソースを扱う場合と同じ操作でビジュアライズを作成できます。あとは、おすすめチャートから適切なチャート種類を選択します。

まとめ

このように、CData Connect AI を経由することで、API 側の複雑な仕様を意識せずにMotionBoard でデータを可視化できます。他にも多くのデータソースに対応するCData Connect AI の詳細をこちらからご確認ください。