FineReport で Acumatica のデータを利用する

Jerod Johnson
Senior Technology Evangelist

FineReport で Acumatica のデータをJDBC データソースとして設定する方法。

CData JDBC Driver for Acumatica は、JDBC 標準を完全に実装しており、さまざまなBI、レポート、ETL ツール、カスタムアプリケーションに Acumatica のデータへの接続を提供します。この記事では、FineReport で Acumatica のデータをJDBC データソースとして設定し、レポートデザイナーで Acumatica のデータをテーブルとして表示する方法を説明します。

Acumatica のデータのJDBC データソースをセットアップする

以下の手順に従って、FineReport のデータベース接続として Acumatica のデータを設定します。

CData JDBC Driver for Acumatica のインストールディレクトリにあるlib フォルダから、cdata.jdbc.acumatica.jar ファイルをFineReport のインストールディレクトリにあるlib フォルダにコピーします。cdata.jdbc.acumatica.lic ファイルも同様にコピーしてください。
ServerタブからDefine Data Connectionを選択し、クリックして新しい接続を追加してJDBCをクリックします。

続いて、ウィンドウでデータ接続の定義を設定します。

Database: Others
JDBC Driver: cdata.jdbc.acumatica.AcumaticaDriver
URL: セミコロン区切りの接続プロパティを使用した標準のJDBC 接続文字列を入力します。
Acumatica 接続プロパティの取得・設定方法

Acumatica への接続

Acumatica データソースに接続するには、次の接続プロパティを指定する必要があります。
- URL：（必須）Acumatica ERP インスタンスのベースURL。例：https://domain.acumatica.com/。
- Schema：（オプション）異なるデータを含む2つのスキーマがあります。デフォルトはREST で、Acumatica REST コントラクトベースのAPI を使用し、OData スキーマはAcumatica OData API を使用します。OData スキーマはAcumatica Generic Inquiries へのクエリに使用されます。
- Company：（一部必須）会社名またはテナント名に設定。Schema がOData に設定されている場合は必須です。
- EndpointVersion：（オプション）Web Services エンドポイントのバージョン。例：24.200.001。これはREST スキーマにのみ適用されます。
- EndpointName：（オプション）Web Services エンドポイントの名前。例：Default。これはREST スキーマにのみ適用されます。
詳細はヘルプドキュメントの「接続の確立」セクションを参照してください。
Acumatica への認証

Acumatica データソースへの接続に使用できる認証方法は2つあります。Basic およびOAuth です。 Basic 認証では、AuthScheme をBasic に設定し、User とPassword をログイン資格情報に設定します。 OAuth 認証については、ヘルプドキュメントの「接続の確立」セクションにある「OAuth」を参照してください。

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

JDBC URL の作成には、Acumatica JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。
```
java -jar cdata.jdbc.acumatica.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

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

JDBC URL の例を以下に示します。
```
    jdbc:acumatica:Url = https://try.acumatica.com/ISV/;EndpointName=Default;EndpointVersion=24.200.001;User=user;Password=password;Company=CompanyName;
  
```