Pentaho Report Designer でWordPress のデータを連携利用

CData JDBC Driver for WordPress のデータ を使えば、ダッシュボードやレポートからリアルタイムデータにアクセスできます。この記事では、WordPress のデータにJDBC データソースとして接続し、Pentaho でWordPress のデータをもとにしたレポートを公開する方法を説明します。

接続してレポートを作成

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）をクリックし、新しいWordPress 接続を作成して、ドライバーで新しいデータソースを作成します。 表示されるダイアログで、以下のように接続プロパティを設定します。

   • Custom Connection URL property：JDBC URL を入力します。JDBC URL はjdbc:wordpress: で始まり、その後にセミコロン区切りで接続プロパティを指定します。

     WordPress 接続プロパティの取得・設定方法

     現時点では、CData JDBC Driver for WordPress はセルフホスト型のWordPress インスタンスへの接続のみをサポートしています。データに接続するには、Url を自身のwordpress サイトに指定し、次に以下に説明するように認証を行います。

     URL を完全な形式で記入します。例えば、あなたのサイトが'http://localhost/wp/wordpress' でホストされている場合、URL は'http://localhost' ではなく、'http://localhost/wp/wordpress' となるべきです。 URL を完全な形式で入力しないと、'site not found' というエラーが発生します。

     WordPress は2種類の認証をサポートします。

     • Basic 認証は、テスト環境での使用が推奨されます。
     • OAuth 2.0 認証は、デスクトップアプリケーション、Web アプリケーション、またはヘッドレスマシンからのブラウザベースのアクセスをサポートします。

     Basic 認証

     Basic 認証を使用するようにWordPress を設定する前に：

     • WordPress ログインに管理者権限があることを確認してください。
     • ローカルホストで実行されているWordPress のバージョンを確認します。（WordPress 4.7 以降はネイティブでWordPress REST API サポートしていますが、それより前のバージョンでは、REST API へのアクセスを安全に行うには、Basic 認証プラグインの使用が必要です。）
     Basic 認証を構成するには：
     1. WordPress ホストにログインします。
     2. 4.7より前のバージョンのWordPress を実行している場合は、REST API プラグインをインストールしてください。
     3. Basic Authentication プラグインをインストールします。
     4. カスタムタクソノミーを作成するには、Simple Taxonomy Refreshed をインストールします。プラグインを手動でインストールしたい場合は、圧縮されたフォルダをwp-content\plugins フォルダに展開してからWordPress 管理者インターフェース経由でプラグインを有効にします。
     5. 次の接続プロパティを設定します。
        • AuthScheme：Basic。
        • Url：WordPress URL。
        • User：ユーザーネーム。
        • Password：パスワード。
     OAuth 2.0 認証についてはヘルプドキュメントを参照してください。

     組み込みの接続文字列デザイナー

     JDBC URL の構成については、WordPress JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。

     java -jar cdata.jdbc.wordpress.jar
     

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     

     JDBC URL を設定する際、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限されます。特にレポートやビジュアライゼーションを設計する際のパフォーマンス向上に役立ちます。

     一般的なJDBC URL は次のとおりです：

     jdbc:wordpress:Url=http://www.yourwordpresshost.com;

   • Custom Driver Class Name：cdata.jdbc.wordpress.WordPressDriver を入力します。
   • User Name：認証に使用するユーザー名。
   • Password：認証に使用するパスワード。
   

レポートにWordPress のデータを追加

WordPress のデータをもとにレポートを作成する準備が整いました。

1. レポートにWordPress のソースを追加します。Data -> Add Data Source -> JDBC をクリックしてデータソースを選択します。

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

   SELECT Id, Name FROM Categories

   
3. レポートにチャートをドラッグし、ダブルクリックしてチャートを編集します。レポートを実行してチャートを表示します。このクエリの結果を使用して、Categories テーブルのシンプルなチャートを作成できます。
4. 最後に、レポートを実行してチャートを確認します。