FineReport で Sage Intacct のデータ を利用する

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

はじめに

---

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

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

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

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

1. Database: Others
2. JDBC Driver: cdata.jdbc.sageintacct.SageIntacctDriver
3. URL: セミコロン区切りの接続プロパティを使用した標準のJDBC 接続文字列を入力します。

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

   独自のWeb サービスクレデンシャル、埋め込みクレデンシャル（Basic 認証）、またはOkta クレデンシャルのいずれかを使用して、Sage Intacct への接続を確立できます。

   Sage Intacct への認証

   Sage Intacct は2種類の認証をサポートします。Basic およびOkta です。選択した認証方法に関連するプロパティを設定して、接続を構成します。

   Basic 認証

   Basic 認証スキームでは、埋め込みクレデンシャルを使用してデータの読み書きが可能です。オプションとして、独自のWeb サービスクレデンシャルを指定することもできます。

   Basic 認証を使用して認証を行うには、以下のプロパティを設定します。

   • AuthScheme：Basic。
   • CompanyID：Sage Intacct にログインする際に会社を識別するために使用するID。
   • User：Sage Intacct へのログインに使用するログイン名。
   • Password：ログインクレデンシャル用のパスワード。
   • （オプション）SenderID およびSenderPassword：Web サービスのSender ID およびパスワード（独自のWeb サービスクレデンシャルを使用している場合のみ）。

   独自のWeb サービスクレデンシャルではなく、埋め込みクレデンシャルを使用する場合は、以下を実行する必要があります：

   • Web サービスダッシュボードで、会社 -> 会社情報 -> セキュリティタブに移動します。
   • Web サービス認証に"CData" を追加します。これは大文字・小文字が区別されます。これを行うには、会社 -> 会社情報（新しいUI では、設定 -> 会社）-> セキュリティ -> Web サービス認証 / 編集に移動します。
   Okta 認証についてはヘルプドキュメントを参照してください。

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

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

   java -jar cdata.jdbc.sageintacct.jar
   

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

   

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

   JDBC URL の例を以下に示します。

       jdbc:sageintacct:User=myusername;CompanyId=TestCompany;Password=mypassword;SenderId=Test;SenderPassword=abcde123;
     


4. Connection pool attributesをクリックし、Test before getting connectionsをNoに設定します。

Test connectionをクリックして、接続が正しく設定されていることを確認します。これで、Sage Intacct への接続を設定し、FineReport のデータソースとして使用できるようになります。

レポートデザイナーで Sage Intacct のデータ を選択する

1. クリックして新しいテンプレートデータセットを追加し、DB queryを選択してデータベースクエリウィンドウを開きます。

2. ドロップダウンリストから、作成したJDBC 接続を選択します。
3. 左ペインにSage Intacct のエンティティがテーブルとして表示されます。
4. ロードするSage Intacct のデータ のテーブルとカラムに対してSELECT 文を記述します。

5. プレビューをクリックすると、データがテーブルとして表示されます。

このように簡単な手順で、FineReport で Sage Intacct をJDBC データソースとして利用できるようになります。