Clear Analytics でApprovalMax のデータを使ってチャートを作成

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Clear Analytics でApprovalMax のデータ を基にした動的なチャートを作成し、分析を実行。



CData ODBC ドライバー for ApprovalMax は、ODBC 標準を介してApprovalMax のライブデータへのアクセスを可能にし、さまざまな BI、レポート、ETL ツールでApprovalMax のデータ を直接扱うことができます。この記事では、Microsoft Excel のアドインである Clear Analytics を使って、ApprovalMax に ODBC データソースとして接続し、ApprovalMax のデータ を基にしたクエリ、テーブル、チャート（PivotTable を含む）を作成する方法を説明します。

ApprovalMax のデータに接続


ODBC データソース名の設定

まだ設定していない場合は、データソース名（DSN）で必要な接続プロパティを指定します。Microsoft ODBC データソースアドミニストレーターを使って DSN を作成・設定できます。これはドライバーインストールの最終ステップでも可能です。Microsoft ODBC データソースアドミニストレーターを使った DSN の作成と設定方法については、ヘルプドキュメントの「はじめに」を参照してください。

まず、Profile 接続プロパティをディスク上の ApprovalMax プロファイルの場所に設定します（例：C:\profiles\ApprovalMax.apip）。次に、ProfileSettings 接続プロパティを ApprovalMax の接続文字列に設定します（以下を参照）。

ApprovalMax API プロファイル設定

ApprovalMax Public API では、OAuth 2.0 の認可コードフローで認証を行います。自分のデータに接続するだけでなく、他のユーザーが各自のデータに接続できるようにすることも可能です。

まず、ApprovalMax に OAuth アプリケーションを登録する必要があります。ApprovalMax Developer Portal（https://developer.approvalmax.com/applications）にサインインし、新しいアプリケーションを作成します。OAuth アプリケーションには Client ID と Client Secret が割り当てられます。また、Redirect URI（Callback URL）を少なくとも1つ登録しておく必要があります。

Public API を利用するには、ApprovalMax の Premium サブスクリプション（または有効なトライアル）が必要です。

以下の接続プロパティを設定すると、接続できるようになります。

  • AuthScheme：OAuth に設定します。
  • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
  • OAuthClientId：ApprovalMax Developer Portal のアプリケーション設定に表示される Client ID に設定します。
  • OAuthClientSecret：ApprovalMax Developer Portal のアプリケーション設定に表示される Client Secret に設定します。
  • CallbackURL：アプリケーション設定で登録した Redirect URI に設定します。
  • Scope：（オプション）デフォルトの OAuth スコープを上書きします。デフォルト値の openid offline_access https://www.approvalmax.com/scopes/public_api/read は、このプロファイルのすべてのテーブルへの読み取り専用アクセスを許可し、リフレッシュトークンを有効にします。スコープを絞り込む際は、最小権限の原則に従ってください。

OAuth の Authorization URL は https://identity.approvalmax.com/connect/authorize、Token URL は https://identity.approvalmax.com/connect/token です。グラントタイプは authorization_code と refresh_token の両方に対応しています。

DSN を設定する際、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションを作成する際のパフォーマンス向上に役立ちます。

Clear Analytics でデータソースを設定

  1. Excel を開き、CLEAR ANALYTICS リボンに移動します。Data Manager を開きます。
  2. データソースとして Database を選択します。
  3. Set Connection セクションで、新しいデータベースを作成するオプションをクリックします。
  4. データソースとして Microsoft ODBC Data Source を選択し、OK をクリックします。
  5. ドロップダウンメニューから、先ほど設定した DSN を選択します。 DSN の選択
  6. Set Connection セクションに戻り、SQL Builder Provider として Standard (ANSI ODBC) Query Builder を選択して Next をクリックします。
  7. Schema/Owner を選択し、Clear Analytics で使用するドメイン（テーブル）を選択します。 データテーブル（Clear Analytics ではドメインと呼ばれます）の選択
  8. 必要に応じて、テーブルやカラムの表示名と説明をカスタマイズしてデータオブジェクトを準備します。
  9. CData ODBC ドライバーの大半では、ドメインにキー日付を設定する必要はありません。
  10. Domain Relations セクションで、テーブル間のリレーション情報を追加します。
  11. Domain Tree セクションで、データのグループを作成し、利用可能な項目をグループに追加します。 Domain Tree でドメイン（テーブル）をグループに追加
  12. データのサマリーを確認し、Finish をクリックします。

ApprovalMax のデータでチャートを作成

これでApprovalMax のデータ を使ったチャートを作成する準備ができました。

新規クエリの作成

  1. CLEAR ANALYTICS リボンの Repository をクリックします。
  2. 新しいクエリを作成します。
  3. 取得するカラムを選択します。
  4. データの集計タイプを設定します（データを集計しない場合は空白のエントリを使用します）。
  5. カラムを下のウィンドウにドラッグして、フィルタと数式を設定します。
  6. クエリに名前を付けて Save をクリックします。 新規クエリの作成

クエリレポートに基づいてチャートを作成

クエリを作成したら、レポートを実行してチャートを表示する準備ができました。
  1. CLEAR ANALYTICS リボンの Report Explorer をクリックします。
  2. Report Explorer ペインで、ツールバーの「New Report」アイコンをクリックします。
  3. 先ほど作成したクエリを選択します。
  4. レポートに名前を付けて「Save and Execute」をクリックします。 レポートの作成と実行
  5. Report Explorer 内の Results タブをクリックします。
  6. レポートを展開し、チャートを Excel スプレッドシートにドラッグします。
  7. 表示される PivotChart ウィンドウで、フィールド（カラム）を Filters、Legends、Axis (Categories)、Values ウィンドウにドラッグします。 PivotChart の作成

Clear Analytics で新しいデータソースを確立し、チャートを作成したら、ApprovalMax のデータ の分析を始める準備ができました。ODBC Driver for ApprovalMax と Clear Analytics を使用すると、ApprovalMax からのライブデータを使って Excel でセルフサービス分析を実行できます。

はじめる準備はできましたか？

API Driver で ApprovalMax のライブデータに接続

ApprovalMax に接続

この記事の内容

関連記事