Pentaho Report Designer にAvalara AvaTax のデータに連携して分析

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

CData JDBC Driver for AvalaraAvatax はダッシュボードや帳票ツールからリアルタイムAvalara AvaTax のデータへの連携を可能にします。この記事では、Avalara AvaTax をJDBC データソースとして接続する方法と、Pentaho でAvalara AvaTax を元に帳票を作成する方法を説明します。

接続と帳票の作成

1. インストールディレクトリの［lib］サブフォルダ内のJAR ファイルをコピーし、Pentaho のディレクトリ内の\Report-Designer\lib\jdbc\ フォルダに配置します。
2. \Report-Designer\ フォルダのreport-designer.bat ファイルを起動し、Report-Designer UI を開きます。

3. 以下の手順でドライバーを新しいデータソースに設定します。［Data］>［Add Data Source］>［Advanced］>［JDBC (Custom)］とクリックし、新しいAvalara AvaTax 接続を作成します。ダイアログが表示されたら、次のように接続プロパティを設定します。

   • Custom Connection URL property：JDBC URL を入力。初めに以下を入力し jdbc:avalaraavatax: 次にセミコロン区切りで接続プロパティを入力します。

     Basic 認証を実行する通常の方法は、次のログイン資格情報を提供することです。

     • User：ユーザー名に設定します。
     • Password：パスワードに設定します。

     サンドボックス環境を使用している場合には、オプションで次を設定してください。

     • UseSandbox：サンドボックスアカウントで認証する場合にはこれをtrue に設定します。

     アカウント番号とライセンスキーを使用して認証する

     または、アカウント番号とライセンスキーを使用して認証することもできます。次を使用してデータに接続します。

     • AccountId：これをアカウントId に設定します。アカウントId は管理コンソールの右上端にリストされています。
     • LicenseKey：これをAvalara Avatax のライセンスキーに設定します。ライセンスキーの生成は、Avalara Avatax アカウント管理者としてログインして Settings -> Reset License Key に移動して実行できます。

     以下は一般的なJDBC URL です：

     jdbc:avalaraavatax:User=MyUser;Password=MyPassword;
   • Custom Driver Class Name：cdata.jdbc.avalaraavatax.AvalaraAvataxDriver と入力。
   • User Name：認証するユーザーネーム。
   • Password：認証するパスワード。

レポートに Avalara AvaTax のデータを追加

これで、Avalara AvaTax の帳票を作成する準備が整いました。

1. 帳票にAvalara AvaTax のデータソースを追加します：［Data］>［Add Data Source］>［JDBC］をクリックし、データソースを選択します。

2. クエリを設定します。この記事では次を使います：

   SELECT Id, TotalTax FROM Transactions WHERE Code = '051349'
3. 帳票にチャートをドラッグし、ダブルクリックしてチャートを編集します。帳票を実行して、チャートを表示します。このクエリ結果を使って、Transactions テーブルのシンプルなチャートを作成することができます。
4. 帳票を実行して、チャートを見てみましょう。