NetBeans で Talkdesk のデータ に接続

CData JDBC Driver for Talkdesk は、JDBC をサポートする IDE にリアルタイム Talkdesk のデータ 接続を統合します。JDBC 標準により、ビルトインのデータアクセスウィザードや迅速な開発をサポートするその他のツールを使用できます。この記事では、NetBeans で Talkdesk のデータ に接続する方法を説明します。接続を作成し、テーブルエディターで ロードを行います。

NetBeans で Talkdesk 用の JDBC データソースを作成

JDBC データソースを作成するには、サービスウィンドウで Database ノードを展開し、Drivers ノードを右クリックして New Driver を選択します。表示される New Driver ウィザードで、以下の情報を入力します：

• Driver File(s)：Add をクリックし、表示されるファイルエクスプローラーダイアログで cdata.jdbc.talkdesk.jar ファイルを選択します。ドライバー JAR はインストールディレクトリの lib サブフォルダにあります。
• Driver Class：Find をクリックして JAR 内のドライバークラスを検索します。次に、メニューから cdata.jdbc.talkdesk.TalkdeskDriver を選択します。
• Name：ドライバーの名前を入力します。

接続パラメータの定義

以下の手順で、必要な接続プロパティを定義します：

1. サービスウィンドウで Database ノードを右クリックし、New Connection をクリックします。

2. New Connection Wizard で、以下の接続プロパティを入力します：

   • Driver Name：メニューから CData JDBC Driver for Talkdesk を選択します。
   • User Name：ユーザー名を入力します。これは JDBC URL でも定義できます。
   • Password：パスワードを入力します。これは JDBC URL でも定義できます。

   • JDBC URL：JDBC URL を指定します。

     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 にアクセストークンを自動でリクエストしてキャッシュし、有効期限が切れると更新します。アプリケーションで選択したスコープが、クエリ予定のビューに対応していることを確認してください。対応していない場合、トークンのリクエストが失敗することがあります。

     ビルトイン接続文字列デザイナー

     JDBC URL の作成には、Talkdesk JDBC Driver にビルトインされている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

     
     java -jar cdata.jdbc.talkdesk.jar
     

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     

     一般的な JDBC URL は次のとおりです：

     jdbc:talkdesk:AccountName=myAccount;Region=US;OAuthClientId=myClientId;OAuthClientSecret=myClientSecret;

Talkdesk のデータ のクエリ

Talkdesk のデータ に接続するには、Database ノードで接続を右クリックし、Connect をクリックします。接続が確立されたら、展開してスキーマ情報を確認できます。

Data Views ウィンドウにテーブルをロードするには、テーブルを右クリックして View Data をクリックします。。