JReport Designer で OData のServicesを連携利用

Jerod Johnson
Jerod Johnson
Senior Technology Evangelist
JReport Designer で OData services をもとにチャートとレポートを作成。

CData JDBC Driver for OData services を使えば、ダッシュボードやレポートから OData をリレーショナルデータベースのように扱い、使い慣れた SQL クエリで OData services のライブデータにアクセスできます。この記事では、JReport Designer で OData services に JDBC データソースとして接続し、OData services のデータをもとにレポートを作成する方法を説明します。

OData データ連携について

CData は、OData サービスのライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています：

  • OData バージョン 2.0、3.0、4.0 にアクセスでき、レガシーサービスと最新の機能・性能の両方に対応できます。
  • $filter、$select、$expand などの高度なクエリオプションを活用し、サードパーティツールからのデータ取得を強化できます。
  • サーバーサイドでの集計とグループ化の実行により、データ転送を最小化し、パフォーマンスを向上させます。
  • Azure AD、ダイジェスト、ネゴシエート、NTLM、OAuth など、さまざまなスキームを使用して安全に認証でき、すべての接続でセキュアな認証を実現します。
  • SQL ストアドプロシージャを使用して、OData サービスエンティティを管理できます。エンティティ間の関連付けの一覧表示、作成、削除などが可能です。

お客様は、Power BI、MicroStrategy、Tableau などのお気に入りのツールと OData サービスを定期的に統合し、OData サービスからデータベースやデータウェアハウスにデータをレプリケートするために CData のソリューションを使用しています。


はじめに


OData のServicesに接続

  1. C:\JReport\Designer\bin\setenv.bat を編集して、JAR ファイルの場所を ADDCLASSPATH 変数に追加します。 
    ...
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\Program Files\CData\CData JDBC Driver for OData 2016\lib\cdata.jdbc.odata.jar;
...
  2. File メニューから New、Data Source と進み、新しいデータソースを作成します。
  3. 表示されるダイアログでデータソース名を入力し（例：CData JDBC Driver for OData）、JDBC を選択して OK をクリックします。
  4. Get JDBC Connection Information ダイアログで、JDBC ドライバーへの接続を設定します。
    • Driver: Driver ボックスにチェックが入っていることを確認し、ドライバーのクラス名を入力します。 
      cdata.jdbc.odata.ODataDriver
    • URL: JDBC URL を入力します。URL は jdbc:odata: から始まり、その後に接続プロパティをセミコロン区切りで記述します。

      OData への接続

      OData に接続するには、Url を有効なOData サービスルートURI に設定する必要があります。 OData サービスにルートドキュメントがない場合、テーブルとして公開したい特定のエンティティをFeedURL に指定してください。

      OData への認証

      OData は、以下を経由する認証をサポートします。

      • HTTP
      • Kerberos
      • SharePoint Online
      • OAuth
      • Azure AD

      HTTP 認証スキーム

      HTTP で認証する場合は、次の表に従ってAuthScheme を設定します。

      SchemeAuthSchemeその他の設定
      NoneNone認証を必要としない場合に使用。
      BasicBasicUser、Password
      NTLMNTLMUser、Password
      Digest（サポートされている場合）DigestUser、Password

      その他の認証方法の詳細は、ヘルプドキュメントの「接続の確立」セクションを参照してください。

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

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

      java -jar cdata.jdbc.odata.jar

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

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

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

      jdbc:odata:URL=http://services.odata.org/V4/Northwind/Northwind.svc;UseIdUrl=True;OData Version=4.0;Data Format=ATOM;
    • User: 認証に使用するユーザー名です。通常は空白のままにします。
    • Password: 認証に使用するパスワードです。通常は空白のままにします。

  5. Add Table ダイアログで、レポートに含めるテーブル（または、このデータソースを使用する今後のレポート用のテーブル）を選択し、Add をクリックします。

    テーブルの読み込みが完了したら Done をクリックします。

  6. Catalog Browser で、レポートを作成するためのクエリを作成できます。これはレポート作成前でも作成後でも行えます。データソース（CData JDBC Driver for OData）を展開（）し、Queries を右クリックして Add Query を選択します。
  7. Add Table/View/Query ダイアログで、JDBC URL と Tables を展開（）し、クエリで使用するテーブルを選択して OK をクリックします。
  8. Query Editor ダイアログで、含めるカラムを選択するか、SQL ボタンをクリックして独自のクエリを手動で入力します。例えば次のようになります。 
    SELECT Orders.Freight, Customers.ContactName FROM Customers INNER JOIN Orders ON Customers.CustomerId=Orders.CustomerId

    クエリが構築できたら、OK をクリックして Query Editor ダイアログを閉じます。これで OData services を新規または既存のレポートに追加する準備が整いました。

    NOTE: クエリが構築できたら、そのクエリをもとに Business View を作成できます。Business View を使用すると、クエリに基づいた Web レポートやライブラリコンポーネントを作成できます。詳しくは、JReport のチュートリアルを参照してください。

OData のServicesをレポートに追加

これで OData services を使用したレポートを作成する準備が整いました。

  1. File メニューから New、Page Report と進んで新しいレポートを作成するか、既存のレポートの Chart Wizard を開きます。
  2. Query を選択します（または新規作成します。上記を参照）。
  3. クエリのカラムからチャートの Category と Value を設定し、Finish をクリックします。
  4. レポートの View タブをクリックして、チャートを表示します。

はじめる準備はできましたか？

OData Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

OData Icon OData JDBC Driver お問い合わせ

使いやすいOData クライアント（コンシューマー）を使用して、OData サービスと通信するJava アプリケーションを簡単に構築できるようになります。

この記事の内容

関連記事