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

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

加藤龍彦
デジタルマーケティング

最終更新日:2022-06-11

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

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



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

NetSuite JDBC Driver のインストール

CData JDBC Driver for NetSuite を、ドライバーの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 を再起動します。

NetSuite のデータに接続

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

  1. 新しい空の帳票で、[Create New Connection]>[JDBC (JNDI)]をクリックします。
  2. ウィザードでJDBC 接続URL を選択します。

    jdbc:netsuite:Account Id=XABC123456;Password=password;User=user;Role Id=3;Version=2013_1;
  3. ドライバーのクラス名を設定:

    cdata.jdbc.netsuite.NetSuiteDriver

    Netsuite への接続

    NetSuite は現在、2つの異なるAPI を提供しています。

    • SuiteTalk はNetSuite との通信に使用する、SOAP ベースのより古いサービスです。多くのエンティティを幅広くサポートし、INSERT / UPDATE / DELETE を完全にサポートします。 しかしデータの抽出用ツールは低機能で、SELECT 時のパフォーマンスは極めて低いです。テーブルを結合するよい方法もありません。データのグループ化および集計はこのAPI からは利用できず、 そのためこれらの操作をサポートするには、すべてをクライアントサイドで実行しなければなりません。
    • SuiteQL は新しいAPI です。サービスとのSQL ライクな通信方法を実現するため、JOIN の機能はより豊富になり、GROUP BY や集計機能もサポートします。 加えて、抽出したいカラムだけを取得する機能も完全にサポートします。そのため、データを抽出する際のパフォーマンスがSuiteTalk より大幅に向上しています。ただし、サポートされるのはデータの抽出のみです。

    NetSuite に接続するには、以下を行う必要があります。

    1. Schema を設定して、接続に使用するAPI を指定。データを取得するだけの場合は、SuiteQL の使用をお勧めします。データの取得および変更が必要な場合は、SuiteTalk の使用をお勧めします。
    2. 使用するAPI に適した接続オプションを設定します。(それぞれのAPI で利用可能な接続オプションが異なります。ヘルプドキュメントの「許可の設定」を参照してください。)

    Netsuite への認証

    SuiteTalk またはSuiteQL

    NetSuite は3つの形式のOAuth 認証を提供します。

    • トークンベース認証(TBA)は、基本的にOAuth 1.0 で、OAuthAccessTokenOAuthAccessTokenSecret を実行時ではなくNetSuite UI 内で作成します。 TBA は、2020.2 以降のSuiteTalk およびSuiteQL の両方で利用可能です。
    • OAuth 2.0 認証は、SuiteQL でのみ利用できます。OAuth 2.0 認証を強制するには、次のいずれかを実行します。
      • OAuthVersion を使用するAPI に明示的に設定、または
      • SchemaSuiteQL に設定
    • OAuth JWT 認証は、OAuth 2.0 クライアント認証フローであり、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。この認証方法は、SchemaSuiteQL に設定されている場合にのみ使用できます。

    認証方法の詳細はヘルプドキュメントの「はじめに」を参照してください。

帳票をデザイン

JDBC 接続をNetSuite に追加したら、レポート作成ウィザードを使ってNetSuite を帳票に追加できます。

  1. 帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、SalesOrder テーブルのCustomerName およびSalesOrderTotal カラムを使います。

    NetSuite のデータ accessible as tables and columns in the Report Wizard. (Salesforce is shown.)
  2. チャートの種類を設定 ウィザードを完了すると、Crystal Reports はNetSuite のデータ に実行されるSQL クエリをビルドします。ドライバーは、ライブNetSuite のデータ に対してクエリを実行します。

    Chart type, axes, and summary type in the Report Wizard. (Salesforce is shown.)
  3. 必要に応じて、ほかのフィルタや帳票テンプレートを設定します。
  4. データのインポートが終わったら、データをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。[Insert]>[Chart]をクリックして、チャートエキスパートを開きます。Total SalesOrderTotal by CustomerName を表すグラフを作成するには、CustomerName を[On Change Of]メニューセレクションの下のボックスに追加してからSalesOrderTotal を[Show Values]の下のボックスに追加します。

    The x and y axes of the chart.

完成した帳票をプレビューして、チャートにデータが入っていることを確認します。Null 値を取り除きたい場合は、SelectionFormula を使います。

A chart with null values filtered out. (Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。