「Elixir Report」を使ってクラウド上のデータをグラフ化してみよう 2ページ

「CData JDBC Driver for Salesforce 4J」を使ってSalesforce上のデータをレポートとして出力する

 近年、ビジネスの現場での顧客関係管理(CRM)ツールとしてよく利用されているのがSalesforceだ。Salesforceはセールスフォース・ドットコムが提供しているクラウドサービスの総称で、営業支援ツール「Sales Cloud」やサポート支援ツール「Service Cloud」、マーケティングツール「Marketing Cloud」といったビジネスアプリケーション、そしてさまざまなアプリケーションを構築できる「Salesforce1 Platform」などが提供されている(図2)。

図2 Salesforceの「レポート&ダッシュボード」画面
図2 Salesforceの「レポート&ダッシュボード」画面

 Salesforceで使用するデータベースや各種アプリケーションサーバーはすべてSalesforce側で管理されており、Webブラウザやクライアントアプリケーション経由でこれらにアクセスすることになる。そのため、ユーザーはこのようなインフラの管理を行うことなしにアプリケーションを利用できる。

 今回使用するJDBC Driver for Salesforceは、このSalesforce上のデータにアクセスできるJDBCドライバだ。以下ではこれを利用し、Salesforce上にある商談データにアクセスして、取引先ごとの売り上げをグラフ形式で表示するレポートを作成する流れを紹介する。

 また、Salesforce自体は有償のサービスだが、開発者向けに無料で利用できる「Force.com Developer Edition」も提供されている。今回はこちらを利用してテストを行った。商談データおよび顧客データとしては、あらかじめ用意されているサンプルデータを使用している。Force.com Developer Editionは、Salesforceの開発者向けサイトの「サインアップ」から登録が行える。

JDBC Driver for Salesforceのインストールと設定

 JDBC Driver for Salesforceは、ZIP形式のアーカイブで配布されている。アーカイブを展開し、含まれているJAR形式のインストーラを実行するとインストールが開始される。Windowsの場合、Javaランタイム(JRE)がインストールされていればJARファイルをダブルクリックするだけで実行できるはずだ。

 インストーラはウィザード形式となっており、指示に従って操作していくことでインストールが完了する(図3)。

図3 JDBC Driver for Salesforceのインストーラ
図3 JDBC Driver for Salesforceのインストーラ

 インストール時にこのインストーラ上でプロダクトキーの入力が必要となるので、あらかじめ確認しておこう(図4)。なお、評価版ではプロダクトキーの入力は不要で、ライセンスアクティベーション画面自体も表示されない。

図4 「ライセンスアクティベーション」画面
図4 「ライセンスアクティベーション」画面

 

 JDBC Driver for Salesforceはデフォルトでは「C:¥Program Files¥CData¥CData JDBC Driver for SAlesforce 4J」というディレクトリにインストールされる。また、JDBCドライバ本体はインストールディレクトリ内の「lib」ディレクトリ以下にライセンスファイルなどとともに格納される。JDBC Driver for Salesforceを使用する際は、アプリケーションからこれらのファイルにアクセスできるよう設定を行う必要がある。

 Elixir Reportの場合、インストールディレクトリ(デフォルトでは「C:¥Program Files¥ElixirReport8.4JT」)直下の「ext」ディレクトリ内にこれらのファイルをすべてコピーすることで、JDBC Driver for Salesforceが利用できるようになる(図5)。

図5 JDBC Driver for SalesforceのjarファイルなどをElixir Reportのインストールディレクトリ以下にあるextディレクトリにコピーすることで、ElixirからJDBC Driver for Salesforceを利用できるようになる
図5 JDBC Driver for SalesforceのjarファイルなどをElixir Reportのインストールディレクトリ以下にあるextディレクトリにコピーすることで、ElixirからJDBC Driver for Salesforceを利用できるようになる

JDBC Driver for Salesforceをデータソースとして利用する

 JDBC Driver for Salesforceのインストールが完了したら、続いてElixir Reportのレポートデザイナを起動し、データソースとして利用する設定を行って行く。まずレポートデザイナでデータソースを作成し、データソースウィザードでデータソースタイプとして「JDBC」を選択する(図6)。

図6 データソースウィザードの「新しいデータソース」画面
図6 データソースウィザードの「新しいデータソース」画面

 次に、JDBCデータソースのパラメータを入力する画面が表示されるので、ここで作成するデータソースの名前や説明、ドライバの指定などを行って行く(図7)。

図7 「JDBCデータソースの定義」画面
図7 「JDBCデータソースの定義」画面

 ここで、「名前」および「説明」は任意の適当な文字列で構わない。今回はそれぞれ「salesforce_oppotunity」、「Salesforce・商談」とした。「ドライバ」には「cdata.jdbc.salesforce.SalesforceDriver」を指定する。また、「URL」は以下のようになる。

jdbc:salesforce:User=<ユーザー名>;Password=<パスワード>;Security Token=<セキュリティトークン>;

 ここで、「ユーザー名」および「パスワード」にはSalesforceに登録しているユーザー名およびパスワードを、「セキュリティトークン」にはSalesforceから取得したセキュリティトークンを指定する。セキュリティトークンの取得方法はSalesforceのヘルプドキュメントに記載されているのでそちらを参照してほしい。

 また、「ユーザー」および「パスワード」欄は空白のままで構わない。これらの入力が完了したら「次へ」をクリックし、「JDBCデータソースの定義」画面を表示されたら「クエリビルダー」ボタンをクリックする(図8)。

図8 「JDBCデータソースの定義」画面
図8 「JDBCデータソースの定義」画面

 Salesforceへの接続が成功すれば、このクエリビルダー画面の左ペインにテーブル情報が表示されるはずだ(図9)。

図9 クエリビルダー画面
図9 クエリビルダー画面

 あとは一般的なデータベースをデータソースとして使用する場合と同様、データが格納されているデータベースやカラム名を指定してクエリを作成すれば良い。なお、Salesforceの管理画面では各データの項目名が日本語で表示されるが、JDBC Driver for Salesforceではこれらに対応するテーブル名およびカラム名が英語で表示される点には注意したい。また、テーブル名/カラム名や各データの項目名一覧はJDBC Driver for Salesforceのヘルプで確認できる(図10)。

図10 JDBC Driver for Salesforceのヘルプ
図10 JDBC Driver for Salesforceのヘルプ

 今回は、商談データベース(JDBC Driver for Salesforce上では「Opportunity」テーブルに相当)および取引先データベース(「Account」テーブルに相当)に格納されている、表2の情報をクエリで取り出している。

表2 今回クエリで取り出す項目
テーブル名カラム名説明
OpportunityName商談名
OpportunityAmount金額
OpportunityCloseDate成立日
OpportunityCreatedDate作成日
OpportunityIsClosed商談が完了しているか
OpportunityIsWon契約を獲得できているか
OpportunityStageName商談の段階
AccountName取引先名

 ここで使用するクエリは以下のようになる。

SELECT
Opportunity.Name, Opportunity.Amount, Opportunity.CloseDate,
Opportunity.CreatedDate, Opportunity.IsClosed, Opportunity.IsWon, 
Opportunity.StageName, Account.Name
FROM Salesforce.Opportunity, Salesforce.Account

 なお、Salesforceではあらかじめテーブルおよびカラム同士の関連性が設定されているため、複数のテーブルに対してクエリを実行した場合は自動的に対応するデータが結合されて出力される。このとき、結合は左側のテーブルを優先させた外部結合(LEFT JOIN)のようになる。今回は商談データベースを優先させるため、FROM節では次のように「Salesforce.Opportunity」を左側に書く必要がある。

FROM Salesforce.Opportunity, Salesforce.Account

 クエリビルダーを使ってSQLを作成した場合、カラム名やテーブル名といった順序が入れ替わっている場合があるので注意が必要だ。その場合、手動でSQL文を編集する必要がある。

 クエリの作成後、「JDBCデータソースの定義」画面で「更新」ボタンをクリックし、データソースの名前と型を確認する(図11)。

図11 「JDBCデータソースの定義」画面
図11 「JDBCデータソースの定義」画面

 ここで、「Name」というカラムはOpportunityテーブルおよびAccountテーブルの両方に含まれているので、片方のカラム名が「Name1」というものに変更されている点に注意したい。最後に「完了」ボタンをクリックすると、データソースが作成される。このデータソースで抽出されたデータは図12のようになる。

図12 作成したデータソースで抽出されたデータ
図12 作成したデータソースで抽出されたデータ

コンポジットデータソースを使って取得したデータを集計・加工する

 続いて、取得したデータから取引先ごとの契約金額を集計するための作業を行っていく。Salesforceの取引データベースには、「IsWon」という名前のカラムがあり、これが「true」であればその商談を獲得できていることになる。以下ではElixir Reportのコンポジットデータソース機能を使用し、「IsWon」が「true」のカラムを対象に、取引先ごとの合計金額を集計してみよう。

 コンポジットデータソースは、指定したデータソースから取得したデータに対しフィルタやソート、フィールド(カラム)の追加といった操作を行い、その結果を新たなデータソースとして提供する機能だ。レポートデザイナ上ではフローチャートのような画面でデータに対し適用する処理を指定することで、コンポジットデータソースを作成できる(図13)。

図13 コンポジットデータソースの「設計」画面
図13 コンポジットデータソースの「設計」画面

 コンポジットデータソースを作成するには、データソースウィザードの「新しいデータソース」画面で「コンポジット」を選択する(図14)。今回作成するデータソース名は「salesforce_won_by_account」、説明には「Salesforce・取引先ごとの売り上げ」とした。

図14 「新しいデータソース」画面
図14 「新しいデータソース」画面

 コンポジットデータソースを作成すると、データをどのように処理するかを図で指定できる「設計」画面が表示される。ここでは、ツールバーから「データソース」や「フィルタ」といった要素を選択して画面をクリックすることでそれらの要素を配置し、要素同士を線(フロー)で接続することで、処理を定義できる。今回は、先ほど作成した「salesforce_oppotunity」データソースを元に、「フィルタ」を使って「IsWon」カラムが「true」のものを取り出し、さらに「キューブ」要素を使って集計を行ったものを結果として出力することとする。

 設計画面では、配置した要素をダブルクリックすることでその設定を行える。まずデータソースでは、使用するデータソースとして「salesforce_oppotunity」を指定する(図15)。

図15 データソースの設定
図15 データソースの設定

 また、フィルタの設定では「IsWon」に対し、条件として「等しい」を意味する「Equals」を、比較する値に「true」を指定した(図16)。

図16 フィルタの設定
図16 フィルタの設定

 最後のキューブは、入力されたデータに対し、行/列を対象とした集計処理を行うものだ。今回は、取引先名ごとに行を作成し、取引先名とその取引金額合計という列を持つデータを出力することにする。

 キューブの設定では、まず「キューブ階層」を指定する画面が表示される。今回は階層化をしないので、ここは空のまま「次へ」をクリックする(図17)。

図17 「キューブ階層」画面
図17 「キューブ階層」画面

 次の「キューブ軸」画面では、行、もしくは列として使用する項目を指定する。今回は取引先名ごとに行を作成するので、「Name1」フィールドをテーブル行に指定する(図18)。

図18 「キューブ軸」画面
図18 「キューブ軸」画面

 「キューブの指標」画面では、集計対象とするフィールドと集計方法を指定する。今回は取引金額が格納されている「Amount」フィールドに対し、それぞれの合計を出力する「合計値」演算を適用することにする(図19)。

図19 「キューブの指標」画面
図19 「キューブの指標」画面

 なお、指標を追加するには左側の新規作成アイコンをクリックし、「指標の追加」ウィンドウで「名前」と「演算」を指定すれば良い(図20)。

図20 「指標の追加」ウィンドウ
図20 「指標の追加」ウィンドウ

 次の「キューブオプション」画面では特に設定は不要だ。最後の「キューブスキーマのキャッシュ」で「更新」をクリックし、作成されるフィールドを確認して「完了」をクリックする(図21)。

図21 「キューブスキーマのキャッシュ」画面
図21 「キューブスキーマのキャッシュ」画面

 以上の作業が完了したら、「データ」タブをクリックし、最終的に出力されるデータをプレビューする。今回は「Name1」と「/合計値(Amount)」というフィールドが作成され、各行に取引先名とその取引金額合計が表示されていることが確認できる(図22)。

図22 「データ」タブで出力されるデータをプレビューできる
図22 「データ」タブで出力されるデータをプレビューできる

 また、同様の手順で契約が成立した商談のみを出力するデータソース「salesforce_won」も作成した(図23)。こちらは、先に作成した「salesforce_won_by_account」コンポジットデータソースからキューブ集計処理を取り除き、「IsWon」カラムがtrueのデータのみを出力するものだ。

図23 「salesforce_won」コンポジットデータソース
図23 「salesforce_won」コンポジットデータソース

レポートテンプレートの作成

 続いて、データソースを元に作成するレポートのデザインを決めるレポートテンプレートを作成していく。今回は、「salesforce_won」データソースを元に、表形式で成立した契約のみを出力する「salesforce_won」レポートテンプレートと、「salesforce_won_by_account」データソースを元に円グラフで取引先ごとの契約金額合計を出力する「salesforce_won_by_account」レポートテンプレートを作成する。

 まず表形式で成立した契約のみを出力する「salesforce_won」レポートテンプレートだが、こちらはレポートウィザードで「表形式レポート」を選択して作成した(図24)。

図24 レポートウィザードで「表形式レポート」を選択
図24 レポートウィザードで「表形式レポート」を選択

 表に出力するフィールドには「Name」(商談名)および「Name1」(取引先)、「Amount」(金額)、「CloseDate」(成立日)を指定した(図25)。

図25 「フィールドの選択」画面
図25 「フィールドの選択」画面

 以上の設定で生成されたレポートテンプレートは図26のようになる。

図26 出力されたレポートテンプレート
図26 出力されたレポートテンプレート

 これにフォントサイズや要素の幅に関する若干の調整を加えたものが図27だ。

図27 完成したレポートテンプレート
図27 完成したレポートテンプレート

 このレポートテンプレートを使って実際に表を出力すると、図28のようになる。

図28 レポートの出力例
図28 レポートの出力例

 続いて取引先ごとの契約金額合計を出力するレポートテンプレートだが、こちらはレポートのタイプとして「白紙レポート」を選択し、空のレポートテンプレートをまず生成する。続いて「セクションヘッダー」内にレポートのタイトル(「取引先ごとの売り上げ」)を入力したテキストエリアと、「チャート」要素を配置し、チャートの設定を行っていく。

 チャート要素を配置すると、「チャートウィザード」が表示されるので、続いてチャートの設定を行っていく。まず「データソースの選択」画面では使用するデータソースを選択する(図29)。ここではデフォルトの「<セクションデータソース>」のままで良い。

図29 「データソースの選択」画面
図29 「データソースの選択」画面

 「チャートタイプの選択」画面では、「円グラフ」を指定する(図30)。

図30 「チャートタイプの選択:画面
図30 「チャートタイプの選択:画面

 続いてデータを指定する「円グラフ」画面となる。まず「キー」タブでキーとして使用するフィールドに「Name1」を、「値」タブで値として使用するフィールドに「/合計値(Amount)」を指定する(図31、32)。

図31 「円グラフ」画面の「キー」タブ
図31 「円グラフ」画面の「キー」タブ
図32 「円グラフ」画面の「値」タブ
図32 「円グラフ」画面の「値」タブ

 これで「プレビュー」タブを選択すると、指定したキーと値に応じたグラフがプレビュー表示される(図33)。

図33 「円グラフ」画面の「プレビュー」タブ
図33 「円グラフ」画面の「プレビュー」タブ

 「判例」や「円グラフ」タブで円グラフや判例の表示方法も設定可能だ。これらを調整し、最終的に完成したレポートテンプレートは図34のようになる。

図34 完成したレポートテンプレート
図34 完成したレポートテンプレート

 このテンプレートを使って実際に出力したレポートは図35のようになる。

図35 出力されたレポート例
図35 出力されたレポート例

 あとはレポートサーバーにデータソースやレポートテンプレートが格納されたディレクトリを登録すれば、任意のアプリケーションからこの表やグラフが出力できるようになる。これらの作業については、『コードを記述することなしにデータを表やグラフとして出力できる帳票ツール「Elixir Report」』記事で紹介しているので、そちらを参照してほしい。

SQLデータベースを使用するのとほぼ同じ流れでクラウド上のデータも処理可能に

 さて、今回はSalesforce上にあるデータを元にレポートを作成する例を紹介した。Salesforce上にあるデータの参照には内部的にはSalesforceが提供しているAPIを利用しているのだが、JDBC Driver for Salesforceという外部ツールを併用することで、特にプログラミングを行うことなく、データベースをデータソースとして使用した場合と同じようにデータにアクセスできた。SalesforceのAPIに関する知識がなくても、SQLの知識だけでデータを利用できるのは非常に便利だろう。

 また、データベース内のデータを集計しようとする場合、従来は個別にプログラムを記述するか、もしくは複雑なSQL文を組み合わせて処理を行う必要があった。しかし、Elixir Reportのコンポジットデータソース機能を利用すれば、データの集計作業も簡単に実行できる。ただし、集計処理はレポートサーバー側で行われるため、処理内容によってはレポートサーバー側の負荷が大きくなる可能性がある点には注意したい。

 さて、今回はデータソースやレポートテンプレートについて注目したが、実際にElixir Reportを利用する場合は、クライアントアプリケーションからレポートサーバーにアクセスしてレポートの生成・表示を行うことになる。次回はこのクライアントアプリケーション側から見た、Elixir Reportを利用するための方法を紹介する。