Crystal Reports でWordPress のデータに連携して帳票を作成

レポートウィザードを使って、最新のWordPress 連携データを使った帳票を作成。

加藤龍彦
デジタルマーケティング
最終更新日：2022-06-11

この記事で実現できるWordPress 連携のシナリオ

CData

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

Crystal Reports には、JDBC 標準向けのサポートが組み込まれています。この記事では、WordPress の機能を持つ帳票を作成するレポート作成ウィザードの使い方を説明します。

WordPress JDBC Driver のインストール

CData JDBC Driver for WordPress を、ドライバーのJAR をCrystal Reports のクラスパスに含めてインストール：DataDriverCommonElement の下のClassPath element のパスに、 .jar を含むファイルのフルパスを追加します。

CRConfig.xml は通常C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java に配置されます。— パスはインストールによって若干異なる場合があります。ドライバーのJAR はインストールディレクトリの［lib］サブフォルダ内にあります。

ClassPath にJAR を追加したら、Crystal Reports を再起動します。

WordPress のデータに接続

下記の手順に従って、レポート作成ウィザードを使ってWordPress 接続を作成します。

新しい空の帳票で、［Create New Connection］>［JDBC (JNDI)］をクリックします。
ウィザードでJDBC 接続URL を選択します。
jdbc:wordpress:Url=http://www.yourwordpresshost.com;
ドライバーのクラス名を設定：
cdata.jdbc.wordpress.WordPressDriver
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 接続をWordPress に追加したら、レポート作成ウィザードを使ってWordPress を帳票に追加できます。

帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Categories テーブルのId およびName カラムを使います。
チャートの種類を設定ウィザードを完了すると、Crystal Reports はWordPress のデータに実行されるSQL クエリをビルドします。ドライバーは、ライブWordPress のデータに対してクエリを実行します。
必要に応じて、ほかのフィルタや帳票テンプレートを設定します。
データのインポートが終わったら、データをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total Name by Id を表すグラフを作成するには、Id を［On Change Of］メニューセレクションの下のボックスに追加してからName を［Show Values］の下のボックスに追加します。