freee データをPower BI Service にインポートしてビジュアライズ

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Power BI を使えば会社のデータを美しいビジュアルに変換して収集および整理することができるため、重要なことだけに集中できます。CData Connect Serverと組み合わせることで、ビジュアライゼーションやダッシュボードなどのためにfreee データを使用できます。この記事では、CData Connect Server を使用してfreee のOData フィードを生成し、freee データをPower BI にインポートして、freee データを使ったレポートをPower BI サービスで作成する方法について説明します。

注意：Connect Server のオンプレミスデータゲートウェイとSQL インターフェースを使って（データをインポートする代わりに）リアルタイムでfreee データに接続することもできます。詳細については、関連するKnowledge Base の記事を参照してください。

freee データの仮想SQL データベースを作成

CData Connect Server は、簡単なポイントアンドクリックインターフェースを使用してAPI を生成します。

1. Connect Server にログインし、「Databases」をクリックします。
2. 「Available Data Sources」から「freee」を選択します。
3. 必要な認証プロパティを入力し、freee に接続します。

   まずはOAuth アプリを作成します。https://app.secure.freee.co.jp/developers/applications にアクセスして、「新しいアプリケーションの作成」ボタンをクリックします。アプリケーション名を指定し、リダイレクトURL を設定して登録をクリックします。そうすると、クライアントシークレットとクライアントID が発行されます。

   次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。

   その後、Companies ビューからCompanyId を取得します。以下の接続プロパティを設定したら、接続する準備ができます。

   • AuthScheme：OAuth に設定します。
   • OAuthClientID：アプリ設定で指定されたOAuth クライアントID に設定します。
   • OAuthClientSecret：アプリ設定で指定されたOAuth クライアントシークレットに設定します。
   • CallbackURL：アプリ設定で指定したリダイレクトURI に設定します。
   • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
4. 「 Test Database」をクリックします。
5. 「Permission」->「 Add」とクリックし、適切な権限を持つ新しいユーザー（または既存のユーザー）を追加します。

Power BI からConnect Server に接続

Power BI サービスにfreee データをインポートしてビジュアライズするには、Connect Server API ユーザーを追加してConnect Server にfreee OData エンドポイントを追加し、Power BI Desktop からサービスにデータセットを作成して公開します。

Connect Server ユーザーの追加

Power BI からConnect Server を介してfreee に接続するユーザーを作成します。

1. ［Users］->［ Add］とクリックします。
2. ユーザーを構成します。
3. ［Save Changes］をクリックして新しいユーザーの認証トークンをメモします。
4. 「Database」をクリックし、freee 仮想データベースを選択します。
5. 「Permission」タブで、新規作成した（少なくともSELECT 権限を持つ）ユーザーを追加して「Save Changes」をクリックします。

Connect Server にfreee OData エンドポイントを追加

freee に接続したら、目的のテーブルのOData エンドポイントを作成します。

1. ［OData］->［Tables］->［Add Tables］とクリックします。
2. freee データベースを選択します。
3. 使用するテーブルを選択し、［Next］をクリックします。
4. （オプション）テーブルの定義を編集して特定のフィールドなどを選択します。
5. 設定を保存します。

Power BI デスクトップからデータセットを公開

Connect Server にOData エンドポイントを追加すると、OData 接続を使用してPower BI デスクトップにデータセットを作成し、そのデータセットをPower BI サービスに公開できます。

1. Power BIを開いて「Get Data」->「More」とクリックし、OData フィードを選択して「Connect」をクリックします。
2. URL をConnect Server インスタンスのBase URL（例： CONNECT_SERVER_URL/api.rsc）に設定し、「OK」をクリックします。
3. User name とPassword を上記のユーザー名と認証トークンに設定します。
4. 設定を適用するレベルとして、フルのBase URL（CONNECT_SERVER_URL/api.rsc）を選択します。
5. 「Navigator」ダイアログでテーブルを選択し、ビジュアライズします。
6. 「Load」をクリックしてPower BI にデータをプルします。
7. 「Relationships」タブで選択したエンティティ間の関係性を定義します。
8. 「Home」メニューから「Publish」をクリックして「Workspace」を選択します。

Power BI Service のfreee データでレポートとダッシュボードを作成

Power BI サービスにデータセットを公開したので、公開されたデータを使って新しいレポートとダッシュボードを作成できます。

1. PowerBI.com にログインします。
2. 「Workspaces」をクリックし、ワークスペースを選択します。
3. 「Create」をクリックし、「Report」を選択します。
4. レポートに使用する公開済みデータセットを選択します。
5. フィールドとビジュアライゼーションを選択してレポートを追加します。

アプリケーションからfreee データへSQL でアクセス

Power BI サービスからリアルタイムfreee データへの直接接続ができるようになりました。これで、freee を複製することなく多くのデータソースや新しいビジュアライゼーション、レポートを作成することができます。

アプリケーションから直接250+ SaaS 、Big Data 、NoSQL ソースへのSQL データアクセスを取得するには、CData Connect Server を参照してください。