Qlik Sense Cloud のfreee Ordering からアプリを作成

Qlik Sense Cloud を使用すると、データのビジュアライゼーションを作成および共有して、新しい方法で情報を操作できます。CData API Server は、freee Ordering の仮想データベースを作成し、freee Ordering のOData API（Qlik Sense Cloud でネイティブに使用可能）を生成するために使用できます。Qlik Sense Cloud をCData API Server とペアリングすることで、すべてのSaaS およびビッグデータとNoSQL ソースへの接続が可能になります。データを移行したり統合したりする必要はありません。ほかのREST サービスと同様に、Qlik Sense Cloud からAPI Server に接続するだけで、freee Ordering のデータに瞬時にライブアクセスできます。

この記事では、二つの接続について説明します。

1. API Server からfreee Ordering への接続。
2. Qlik Sense Cloud からAPI Server に接続してモデルを作成し、シンプルなダッシュボードを構築。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなfreee Ordering OData サービスを作成していきましょう。

freee Ordering への接続

Qlik Cloud からfreee Ordering のデータを操作するには、まずfreee Ordering への接続を作成・設定します。

1. API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
2. 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「freee Ordering」を選択します。
3. 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
   CData コネクタの追加方法はこちら >>
4. それでは、freee Ordering への接続設定を行っていきましょう！

5. まずは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 を取得するプロセスを管理できます。
6. 接続情報の入力が完了したら、「保存およびテスト」をクリックします。

まずは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 を取得するプロセスを管理できます。

API Server のユーザー設定

次に、API Server 経由でfreee Ordering にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

1. 「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
2. 次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
3. その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

freee Ordering 用のAPI エンドポイントの作成

ユーザーを作成したら、freee Ordering のデータ用のAPI エンドポイントを作成していきます。

1. まず、「API」ページに移動し、 「 テーブルを追加」をクリックします。
2. アクセスしたい接続を選択し、次へをクリックします。
3. 接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でfreee Ordering への接続を設定してユーザーを作成し、API Server でfreee Ordering データのAPI を追加しました。これで、OData 形式のfreee Ordering データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

（オプション）Cross-Origin Resource Sharing (CORS) を構成

Ajax などのアプリケーションから複数のドメインにアクセスして接続すると、クロスサイトスクリプティングの制限に違反する恐れがあります。その場合には、［OData］->［Settings］でCORS 設定を構成します。

• Enable cross-origin resource sharing (CORS):ON
• Allow all domains without '*':ON
• Access-Control-Allow-Methods:GET, PUT, POST, OPTIONS
• Access-Control-Allow-Headers:Authorization

freee Ordering のデータからQlik Sense アプリケーションを作成

freee Ordering への接続と構成されたOData エンドポイントがあれば、freee Ordering のデータを追加してQlik Sense でビジュアライズ、分析、レポートなどを行うことができます。

新しいアプリケーションの作成とデータのアップロード

1. Qlik Sense インスタンスにログインし、ボタンをクリックして新しいアプリケーション新しいアプリケーションを作成します。
2. 新しいアプリケーションに名前を付けて構成し、「Create」をクリックします。
3. ワークスペース内で、新しいアプリケーションをクリックして開きます。
4. クリックして、ファイルやその他のソースからデータを追加します。
5. REST コネクタを選択し、構成プロパティを設定します。次の箇所以外では、ほとんどの箇所でデフォルト値を使用します。
   • URL：これをfreee Ordering テーブルのAPI エンドポイントに設定します。@CSV URL パラメーターを使用することで、CSV レスポンスを確実に取得できます。（例： https://myserver/api.rsc/API_Deals?@CSV）
   • Authentication Schema：「BASIC」に設定します。
   • User Name：上記で構成したユーザー名に設定します。
   • Password：上記のユーザー用の認証トークンに設定します。
6. 「Create」をクリックしてfreee Ordering のデータのAPI Server をクエリします。
7. 「CSV has header」をチェックし、「Tables」で「CSV_source」を選択します。
8. カラムを選択し、「Add data」をクリックします。

実際にデータを分析する

データがQlik Sense にロードされたので、洞察を引き出すことができます。「Generate insights」をクリックすると、Qlik がデータを分析します。もしくは、freee Ordering のデータを使用してカスタムのビジュアライゼーション、レポート、ダッシュボードを作成できます。

詳細と無料トライアル

これで、リアルタイムfreee Ordering のデータから簡単で強力なダッシュボードが作成されました。freee Ordering（および250 以外のデータソース）のOData フィードを作成する方法の詳細については、API Server ページにアクセスしてください。無料トライアルにサインアップして、Qlik Sense Cloud でリアルタイムfreee Ordering のデータの操作を開始します。