TIBCO SpotfireでTalkdesk のデータをADO.NET経由で可視化

この記事では、CData ADO.NET Provider for Talkdesk をTIBCO Spotfire で使う方法を説明します。接続を確立して、簡単なダッシュボードを作成していきます。

1. ［Add Data Tables］をクリックして、CData ADO.NET データソースを追加します。
2. ［Add］>［Database］をクリックします。
3. プロバイダーを選択して［Configure］をクリックします。
4. 接続設定を定義します。一般的な接続文字列は次のとおりです。

   AccountName=myAccount;Region=US;OAuthClientId=myClientId;OAuthClientSecret=myClientSecret;

   Talkdesk では OAuth 2.0 の Client Credentials グラントを使用します。ブラウザでの認可ステップやコールバック URL は必要ありません。

   以下の接続プロパティを設定します。

   • AccountName：Talkdesk アカウントの名前。
   • Region：Talkdesk インスタンスがデプロイされているリージョン。指定できる値は US（デフォルト）、EU、CA、AU、UK、FedRamp です。
   • OAuthClientId：カスタム OAuth アプリケーションの登録時に割り当てられた Client Id。
   • OAuthClientSecret：カスタム OAuth アプリケーションに割り当てられた Client Secret。

   カスタム OAuth アプリケーションの作成

   1. Talkdesk アカウントにログインし、ナビゲーションメニューから OAuth Clients を選択します。
   2. Create OAuth Client をクリックし、クライアントにわかりやすい名前を付けます。
   3. Grant Type を Client Credentials に設定します。
   4. Add scopes をクリックし、アクセスしたいデータに応じたスコープを選択します。
   5. Create をクリックし、Client Id と Client Secret をコピーします。

   接続時、ドライバーは Talkdesk にアクセストークンを自動でリクエストしてキャッシュし、有効期限が切れると更新します。アプリケーションで選択したスコープが、クエリ予定のビューに対応していることを確認してください。対応していない場合、トークンのリクエストが失敗することがあります。

   
5. ダッシュボードに追加したいテーブルを選択します。この例ではUsers を使います。SQL クエリも指定できます。ドライバーは標準SQL シンタックスをサポートしています。
6. リアルタイムデータを使いたい場合は、［Keep Data Table External］オプションをクリックします。このオプションは、データの変更をリアルタイムでダッシュボードに反映します。

   データをメモリにロードしてローカルで処理したい場合は、［Import Data Table］オプションをクリックします。このオプションは、オフラインでの使用、またはスローなネットワーク接続によりダッシュボードがインタラクティブでない場合に使用します。

7. テーブルを追加すると［Recommended Visualizations］ウィザードが表示されます。テーブルを選択すると、Spotfire はカラムのデータ型を使ってnumber、time、category カラムを検出します。この例ではNumbers セクションでName を、Categories セクションでId を使用しています。

［Recommended Visualizations］ウィザードでいくつかビジュアライズしたら、ダッシュボードにその他の修正を加えられます。例えば、ページにフィルタを適用することで、高確率なopportunities にズームインできます。フィルタを追加するには、［Filter］ボタンをクリックします。各クエリで利用可能なフィルタは、［Filters］ペインに表示されます。