TIBCO Data Virtualization で Salesloft のデータ にリアルタイムアクセスする方法
TIBCO Data Virtualization（TDV）は、複数の多様なデータソースへのアクセスを一元管理するエンタープライズデータ仮想化ソリューションです。CData TIBCO DV Adapter for Salesloft と組み合わせることで、TIBCO Data Virtualization 内からSalesloft のデータに直接フェデレーテッドアクセスが可能になります。この記事では、アダプターのデプロイと Salesloft に基づく新しいデータソースの作成手順を解説します。
CData TIBCO DV Adapter は、最適化されたデータ処理機能が組み込まれており、Salesloft のデータ とのインタラクションにおいて比類のないパフォーマンスを発揮します。Salesloft に対して複雑な SQL クエリを発行すると、アダプターはフィルタや集計などサポートされている SQL 操作を直接 Salesloft にプッシュします。組み込みの動的メタデータクエリにより、ネイティブのデータ型を使用してSalesloft のデータを操作・分析できます。
Salesloft TIBCO DV Adapter のデプロイ
コンソールで、TDV Server のインストールディレクトリ内の bin フォルダに移動します。現在のバージョンのアダプターがインストールされている場合は、先にアンデプロイする必要があります。
.\server_util.bat -server localhost -user admin -password ******** -undeploy -version 1 -name SalesLoft
CData TIBCO DV Adapter をローカルフォルダに解凍し、解凍した場所から JAR ファイル（tdv.salesloft.jar）をサーバーにデプロイします。
.\server_util.bat -server localhost -user admin -password ******** -deploy -package /PATH/TO/tdv.salesloft.jar
新しい JAR ファイルが正しくロードされるように、サーバーの再起動が必要な場合があります。再起動は、C:\Program Files\TIBCO\TDV Server <version>\bin にある composite.bat スクリプトを実行して行えます。サーバーを再起動した後は、TDV Studio への再認証が必要です。
再起動コマンドの例
.\composite.bat monitor restart
OAuth を使用して Salesloft で認証する
Salesloft は OAuth プロトコルを使用して認証を行いますが、TDV Studio は内部でブラウザベースの認証をサポートしていないため、OAuth トークンを取得するための簡単な Java アプリケーションを作成して実行する必要があります。取得したトークンは、アダプターから直接 Salesloft に接続するために使用されます。
以下のコードサンプルは、Salesloft での認証方法を示しています。tdv.salesloft.jar ファイルをクラスパスに含めて Java アプリケーションを実行するだけです。
SalesLoftOAuth oauth = new SalesLoftOAuth();
oauth.generateOAuthSettingsFile("InitiateOAuth=GETANDREFRESH;" +
"AuthScheme=OAuth;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackUrl=http://localhost:33333;" +
"OAuthSettingsLocation=C:\salesloft\OAuthSettings.txt;");
アダプターをデプロイして認証が完了したら、TDV Studio で Salesloft 用の新しいデータソースを作成できます。
TDV Studio で Salesloft データソースを作成する
CData TIBCO DV Adapter for Salesloft を使用すると、Salesloft 用のデータソースを簡単に作成し、データソースをイントロスペクトしてリソースを TDV に追加できます。
データソースの作成
- データソースを追加するフォルダを右クリックし、New -> New Data Source を選択します。
- アダプター（例：Salesloft）が表示されるまでスクロールし、Next をクリックします。
- データソースに名前を付けます（例：CData Salesloft Source）。
必要な接続プロパティを入力します。
SalesLoft はOAuth 認証標準またはAPI キーを使って認証します。OAuth では認証するユーザーにブラウザでSalesloft との通信を要求します。OAuth
OAuth で認証するには、OAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得するためにOAuth アプリを作成する必要があります。認証手順は、ヘルプドキュメントのOAuth セクションを参照してください。API キー
または、APIKeyで認証します。SalesLoft ユーザーインターフェース：https://accounts.salesloft.com/oauth/applications/ で、API キーをプロビジョニングします。リクエストを発行し、使用するキーを受け取ります。
NOTE：DV Adapter の OAuthSettingsLocation プロパティには、OAuth 認証（上記参照）を実行したときと同じ値を設定してください。
- Create & Close をクリックします。
データソースのイントロスペクト
データソースを作成したら、右クリックして Open を選択することでデータソースをイントロスペクトできます。ダッシュボードで Add/Remove Resources をクリックし、データソースの一部として含めるテーブル、ビュー、ストアドプロシージャを選択します。Next をクリックし、Finish をクリックして、選択した Salesloft のテーブル、ビュー、ストアドプロシージャをリソースとして追加します。
データソースを作成してイントロスペクトしたら、他のリレーショナルデータソースと同様に TIBCO Data Virtualization でSalesloft のデータを操作できるようになります。ビューの作成、SQL によるクエリ、データソースの公開など、さまざまな操作が可能です。