QuickBooks Time データをYellowfin に連携してビジュアライズ

こんにちは！テクニカルディレクターの桑島です。

CData JDBC Driver for TSheets は、JDBC 標準をインプリメントし、BI ツールからIDE まで幅広いアプリケーションでQuickBooks Time への接続を提供します。この記事では、Yellowfin からQuickBooks Time データ に接続する方法を説明します。

QuickBooks Time データのJDBC データソースを作成

下記の手順に従って、YellowfinからQuickBooks Time のJDBCドライバを追加します。

この手順は主にYellowfinの画面を使って進めていきます。

1. メニューバーの中から「管理」→「管理コンソール」画面へ。 管理コンソール画面の右側にある「管理」メニューから「プラグイン管理」を選択。
2. プラグイン管理画面、右側の「追加」をクリックし、「新規プラグイン」の画面を出す。
3. ここでドロップできる拡張子が.jarか.yfpなのでそれに合わせてファイルを変更する必要があります。
   1. CData JDBC ドライバインストールディレクトリの［lib］サブフォルダ内にcdata.jdbc.tsheets.jar とcdata.jdbc.tsheets.licファイルがあることを確認する。
   2. cdata.idbc.tsheets.licファイルを圧縮。
   3. 圧縮してできたファイルcdata.jdbc.tsheets.zipの名前をcdata.jdbc.tsheets.lic.jarに変更。
4. 上記で作ったcdata.jdbc.tsheets.lic.jarともともとあったcdata.jdbc.tsheets.jarを新規プラグイン画面にドラッグ。

※YellowfinをインストールしたマシンとJDBCドライバーをインストールしたマシンが同じものでないとエラーが起こってしまいます。

次にYellowfinの管理コンソールからデータソースを追加します。下記の手順に従って以下の項目を設定します。

1. 「管理」→「データソース」→「追加」を選択。
2. 新規接続画面で「データベース」を選択すると「接続設定」の画面に行きます。
• 名前：任意（CDataTSheets）
• 説明：任意
• データベースタイプ：Generic JDBC Data Source（選択後以下二つが出てきます）
• ドライバー：cdata.jdbc.tsheets.TSheetsDriver
• 接続文字: jdbc:tsheets: に続けてセミコロン区切りで接続プロパティを入力します。
  一般的なJDBC URL は次の通りです:
  jdbc:tsheets:OAuthClientId=myclientid;OAuthClientSecret=myclientsecret;CallbackUrl=http://localhost:33333; QuickBooks Time向けの接続文字はcdata製品マニュアルの［接続の確立］をご覧ください。
• ユーザー名：QuickBooks Timeのユーザー名
• パスワード：QuickBooks Timeのパスワード

上記の入力が終わったらビュー作成を選択します。

QuickBooks Time データのビューを作成

ビュー作成を行っていきます。

［ビュー作成］で以下の項目を設定します。

• ビューのタイプを選択：任意
• テーブルを選択：分析に用いるテーブルを選択します。
• ビュー名：ビューの名前
• ビュー説明：ビューの説明

［Step1. ドラッグ＆ドロップエディタ］にて、左側のデータベーステーブル一覧から参照するテーブルを選択してドラッグドロップで［カラム］または［ロウ］エリアに配置します。

［Step2. グラフ］にて、グラフの形や詳細設定を行っていきます。

「保存」「有効化」を行いビューを保存します。

このようにTSheets 内のデータをAPI を書くことなくYellowfin 上で表示することができるようになります。

サポートされるSQL についての詳細は、ヘルプドキュメントの「サポートされるSQL」をご覧ください。テーブルに関する情報は「データモデル」をご覧ください。