API Server を使用してSAP Lumira での変更を反映するSurveyMonkey フィードのデータビジュアライゼーションを作成します。
CData API サーバーおよびADO.NET Provider for SurveyMonkey (または230+ の他のADO.NET Providers) を使って、SAP Lumira でSurveyMonkey に基づくビジュアライゼーションを作成できます。API サーバーにより、ライブデータへの接続が可能になります。ダッシュボードとレポートはオンデマンドで更新できます。この記事では、常に最新であるグラフを作成する方法を説明します。
API サーバーをセットアップ
以下のステップに従って、安全なSurveyMonkey OData サービスの作成を開始します。
デプロイ
API サーバーは独自のサーバーで実行されます。Windows では、スタンドアロンサーバーまたはIIS を使用して展開できます。Java サーブレットコンテナで、API Server WAR ファイルをドロップします。詳細とハウツーについては、ヘルプドキュメントを参照してください。
API Server は、Microsoft Azure、Amazon EC2、Heroku にも簡単にデプロイできます。
SurveyMonkey に接続
API サーバーとADO.NET Provider for SurveyMonkey を展開した後、[Settings]->[Connection]をクリックし、API サーバーコンソールで新しい接続を追加してSurveyMonkey に接続するために必要な認証値とその他の接続プロパティを指定します。
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 を参照してください。
接続を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。
次に、[Settings]->[Resources]をクリックして、API サーバーへのアクセスを許可するSurveyMonkey エンティティを選択できます。
API サーバーユーザーを承認
作成するOData サービスを決定したら、[Settings]->[Users]をクリックしてユーザーを承認します。API サーバーは、認証トークンベースの認証を使用して主要な認証スキームをサポートします。IP アドレスに基づいてアクセスを制限することもできます。デフォルトでは、ローカルマシンへの接続のみが制限されています。SSL を使用して、接続を認証及び暗号化することができます。
SAP Lumira からSurveyMonkey への接続
以下のステップに従って、SurveyMonkey をSAP Lumira に取得します。SQL クエリを実行するか、UI を使用できます。
- SAP Lumira で[File]->[New]->[Query with SQL]とクリックします。Add New Dataset ダイアログが表示されます。
- [Generic]セクションを展開し、[Generic OData 2.0 Connector]オプションをクリックします。
-
[Service Root URI]ボックスに、API サーバーのOData エンドポイントを入力します。URL は次の例のようになります。
https://your-server:8032/api.rsc
-
[User Name]と[Password]のボックスにAPI ユーザーのユーザー名と認証トークンを入力します。これらの資格情報は、HTTP 基本認証で使用されます。
ツリーでエンティティを選択するか、SQL クエリを入力します。この記事では、SurveyMonkey MySurvey_Responses エンティティをインポートします。
-
[Connect]をクリックすると、SAP Lumira は対応するOData 要求を生成し、結果をメモリにロードします。その後、フィルタ、集計、要約関数など、SAP Lumira で使用可能な任意のデータ処理ツールを使用できます。
データのビジュアライゼーションを作成
データをインポートした後、[Visualize]ルームでデータのビジュアライゼーションを作成できます。以下のステップに従って、基本グラフを作成します。
[Measures and Dimensions]ペインで、メジャーとディメンションを[Visualization Tools]ペインの[x-axis]フィールドと[y-axis]フィールドにドラッグします。SAP Lumira は、API サーバーのメタデータサービスからディメンションとメジャーを自動的に検出します。
デフォルトでは、SUM 関数はすべてのメジャーに適用されます。メジャーの横にある歯車のアイコンをクリックしてデフォルトの要約を変更します。
- [Visualization Tools]ペインで、グラフの種類を選択します。
- [Chart Canvas]ペインで、フィルタを適用し、メジャーで並べ替え、ランキングを追加して現在のSurveyMonkey でグラフを更新します。