TIBCO Data Virtualization で Zoho Projects のデータ にリアルタイムアクセスする方法

TIBCO Data Virtualization（TDV）は、複数の多様なデータソースへのアクセスを一元管理するエンタープライズデータ仮想化ソリューションです。CData TIBCO DV Adapter for Zoho Projects と組み合わせることで、TIBCO Data Virtualization 内からZoho Projects のデータに直接フェデレーテッドアクセスが可能になります。この記事では、アダプターのデプロイと Zoho Projects に基づく新しいデータソースの作成手順を解説します。

CData TIBCO DV Adapter は、最適化されたデータ処理機能が組み込まれており、Zoho Projects のデータ とのインタラクションにおいて比類のないパフォーマンスを発揮します。Zoho Projects に対して複雑な SQL クエリを発行すると、アダプターはフィルタや集計などサポートされている SQL 操作を直接 Zoho Projects にプッシュします。組み込みの動的メタデータクエリにより、ネイティブのデータ型を使用してZoho Projects のデータを操作・分析できます。

Zoho Projects TIBCO DV Adapter のデプロイ

1. コンソールで、TDV Server のインストールディレクトリ内の bin フォルダに移動します。現在のバージョンのアダプターがインストールされている場合は、先にアンデプロイする必要があります。

   .\server_util.bat -server localhost -user admin -password ******** -undeploy -version 1 -name ZohoProjects
   

2. CData TIBCO DV Adapter をローカルフォルダに解凍し、解凍した場所から JAR ファイル（tdv.zohoprojects.jar）をサーバーにデプロイします。

   .\server_util.bat -server localhost -user admin -password ******** -deploy -package /PATH/TO/tdv.zohoprojects.jar
   

新しい JAR ファイルが正しくロードされるように、サーバーの再起動が必要な場合があります。再起動は、C:\Program Files\TIBCO\TDV Server <version>\bin にある composite.bat スクリプトを実行して行えます。サーバーを再起動した後は、TDV Studio への再認証が必要です。

再起動コマンドの例

.\composite.bat monitor restart

OAuth を使用して Zoho Projects で認証する

Zoho Projects は OAuth プロトコルを使用して認証を行いますが、TDV Studio は内部でブラウザベースの認証をサポートしていないため、OAuth トークンを取得するための簡単な Java アプリケーションを作成して実行する必要があります。取得したトークンは、アダプターから直接 Zoho Projects に接続するために使用されます。

以下のコードサンプルは、Zoho Projects での認証方法を示しています。tdv.zohoprojects.jar ファイルをクラスパスに含めて Java アプリケーションを実行するだけです。

ZohoProjectsOAuth oauth = new ZohoProjectsOAuth();
oauth.generateOAuthSettingsFile("InitiateOAuth=GETANDREFRESH;" +
                                  "" +
                                  "OAuthSettingsLocation=C:\zohoprojects\OAuthSettings.txt;");

アダプターをデプロイして認証が完了したら、TDV Studio で Zoho Projects 用の新しいデータソースを作成できます。

TDV Studio で Zoho Projects データソースを作成する

CData TIBCO DV Adapter for Zoho Projects を使用すると、Zoho Projects 用のデータソースを簡単に作成し、データソースをイントロスペクトしてリソースを TDV に追加できます。

データソースの作成

1. データソースを追加するフォルダを右クリックし、New -> New Data Source を選択します。
2. アダプター（例：Zoho Projects）が表示されるまでスクロールし、Next をクリックします。
3. データソースに名前を付けます（例：CData Zoho Projects Source）。

4. 必要な接続プロパティを入力します。

   Zoho Projects 接続プロパティの取得・設定方法

   Zoho Projects に接続するには、Region をサーバーURL のトップレベルドメイン（TLD）に設定します。

   Zoho Projects への認証

   Zoho Projects は、データに接続する2つの方法を提供します。

   • デスクトップ経由で自分のローカルデータに接続する場合（非ブラウザ接続）は、CData が提供する組み込みOAuth アプリケーションを使用します。
   • ネットワーク経由で共有データに接続する場合（ブラウザ接続）は、カスタムOAuth アプリケーションを使用します。

   すべてのOAuth フロー（埋め込みまたはカスタム）で、この認証を有効にするにはAuthScheme をOAuth に設定する必要があります。

   ヘルプドキュメントでは、次の3つの一般的な認証フローでのZoho Projects への認証について詳しく説明します。

   • デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。埋め込みOAuth またはカスタムOAuth で認証されます。
   • Web：共有ウェブサイト経由でデータにアクセスします。カスタムOAuth でのみ認証されます。
   • ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。埋め込みOAuth またはカスタムOAuth で認証されます。

   認証方法の詳細は、ヘルプドキュメントを参照してください。

   NOTE：DV Adapter の OAuthSettingsLocation プロパティには、OAuth 認証（上記参照）を実行したときと同じ値を設定してください。

   
5. Create & Close をクリックします。

データソースのイントロスペクト

データソースを作成したら、右クリックして Open を選択することでデータソースをイントロスペクトできます。ダッシュボードで Add/Remove Resources をクリックし、データソースの一部として含めるテーブル、ビュー、ストアドプロシージャを選択します。Next をクリックし、Finish をクリックして、選択した Zoho Projects のテーブル、ビュー、ストアドプロシージャをリソースとして追加します。

データソースを作成してイントロスペクトしたら、他のリレーショナルデータソースと同様に TIBCO Data Virtualization でZoho Projects のデータを操作できるようになります。ビューの作成、SQL によるクエリ、データソースの公開など、さまざまな操作が可能です。