現在のSurveyMonkey を組み込み型アナリティクスに提供します。
CData JDBC Driver for SurveyMonkey は、SurveyMonkey APIs への接続をデータドリブンJava アプリケーションに統合します。CData JDBC Driver for SurveyMonkey をBIRT (Business Intelligence Reporting Tools) のプラットホームで使用することで、リアルタイムでデータの変更を反映するBIRT レポートを作成できます。
- Eclipse 用のBIRT Framework プラグインとDatabase Development プラグインをインストールします。
- [File]->[New]->[Report]と進みます。[Report Design perspective]が表示されます。
- [Data Explorer]で[Data Sources]を右クリックし、[New Data Source]をクリックします。
- [Following List]オプションから[Create from Data Source Type]を選択し、[JDBC Data Source]を選択します。
- [Manage Drivers]をクリックし、インストールフォルダのlib サブフォルダにあるドライバーのJAR を追加します。
- [Database URL]ボックスに、接続文字列を含む[JDBC URL]を入力します。
SurveyMonkey はOAuth 2 認証標準を利用しています。SurveyMonkey がアンケートの回答を読むためにこれを必要とすることを考えると、アンケートを読むアカウントには有料プランのサブスクリプションが必要です。
SurveyMonkey への接続に使用できる認証方法は2つあります。
- プライベートoauth アプリケーションを登録するときに、個人用アクセストークンを使用します。
- パブリックoauth アプリケーションを登録するときに、OAuth を使用します。
個人用アクセストークンの使用
個人用トークンを使用して、自分のデータをテストし、アクセスします。個人用トークンを取得するには、Creating a Custom OAuth App の手順に従って、次の接続プロパティを設定します。
- OAuthAccessToken:アプリケーション設定で生成されたAccessToken に設定。
- InitiateOAuth:OFF に設定。
OAuth の使用
本製品はすでにSurveyMonkey にOAuth アプリケーションとして登録されています。そのため、デフォルトでは、自動的にEmbedded Credentials を使用して接続します。
独自のカスタムOAuth アプリを使用したい場合は、Custom Credentials を参照してください。
ビルトイン接続文字列デザイナ
JDBC URL の構成については、SurveyMonkey JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.surveymonkey.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。
以下は一般的なJDBC URL です。
jdbc:surveymonkey:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:portNumber;InitiateOAuth=GETANDREFRESH
- [Data Sets]フォルダを右クリックし、[JDBC data source for SurveyMonkey]を選択します。
- 表示されるダイアログで、レポートのデータを取得するために使用するSELECT クエリを構築します。この記事では、以下のクエリを用います。
SELECT RespondentId, ChoiceId FROM MySurvey_Responses
- [Palette]で、[Chart]をエディタにドラッグします。[Chart]ウィザードが表示されます。
- チャートタイプを選択した後、[Select Data]タブのチャートフィールドにカラムをドラッグします。
- [Run]->[View Report]->[In Web Viewer]とクリックして、レポートを表示します。
これによって、BIRT レポートがSurveyMonkey の更新をすべて取得できるようになります。
レポートをアプリケーションサーバーに公開するには、ドライバーのJAR をBIRT Viewer のクラスパスに追加します。より詳しい説明は、Java アプリケーションサーバーにJDBC Driver をデプロイする方法について、CData KB を参照してください。