NetSuite のデータを使ったCrystal Reports を発行

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

Report Wizard と標準のADO.NET を使用して最新のNetSuite のデータを使用したレポートを作成。

CData ADO.NET Provider for NetSuite は、Crystal Reports for Visual Studio 開発環境に統合されています。標準のADO.NET コンポーネントを使用して、SQL Server と同じようにレポートを作成でき、さらにNetSuite とリアルタイムで連携できます。この記事では、開いたときに更新されるレポートにNetSuite のデータを追加するために必要な3つのステップを完了する方法を説明します。

Note：このチュートリアルを実行するには、Crystal Reports とVisual Studio のデベロッパーバージョンをインストールしてください。

Crystal Reports アプリケーションを作成する

この記事を実行するにはVisual Studio Crystal Reports プロジェクトが必要になります。この記事では、WPF アプリケーションにレポートを追加します。「File」->「New Project」とクリックし、Crystal Reports WPF Application テンプレートを選択することで、作成できます。表示されるウィザードで空のレポートを作成するオプションを選択します。

NetSuite に接続する

Server Explorer からNetSuite のADO.NET データソースを作成すると、Crystal Reports ウィザードおよびCrystal Reports Designer で使用できるDataSet を簡単に作成できます。Server Explorer でNetSuite のデータを操作するためのガイドは、ヘルプドキュメントの「はじめに」の章を参照してください。

NetSuiteへの接続

NetSuite では、2種類のAPI でデータにアクセスできます。どちらのAPI を使用するかは、Schema 接続プロパティで以下のいずれかを選択して指定してください。

SuiteTalk は、NetSuite との通信に使用されるSOAP ベースの従来から提供されているサービスです。幅広いエンティティをサポートし、INSERT / UPDATE / DELETE の操作も対応しています。ただし、SuiteQL API と比べるとデータの取得速度が劣ります。また、サーバーサイドでのJOIN に対応していないため、これらの処理はCData 製品がクライアントサイドで実行します。
SuiteQL は、より新しいAPI です。JOIN、GROUP BY、集計、カラムフィルタリングをサーバーサイドで処理できるため、SuiteTalk よりもはるかに高速にデータを取得できます。ただし、NetSuite データへのアクセスは読み取り専用となります。

データの取得のみが目的でしたらSuiteQL をお勧めします。データの取得と変更の両方が必要な場合は、SuiteTalk をお選びください。

NetSuite への認証

CData 製品では、以下の認証方式がご利用いただけます。

トークンベース認証（TBA）はOAuth1.0に似た仕組みです。2020.2以降のSuiteTalk とSuiteQL の両方で利用できます。
OAuth 2.0 認証（OAuth 2.0 認可コードグラントフロー）は、SuiteQL でのみご利用いただけます。
OAuth JWT 認証は、OAuth2.0 クライアント認証フローの一つで、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。

トークンベース認証（OAuth1.0）

トークンベース認証（TBA）は、基本的にOAuth 1.0 の仕組みです。この認証方式はSuiteTalk とSuiteQL の両方でサポートされています。管理者権限をお持ちの方がNetSuite UI 内でOAuthClientId、OAuthClientSecret、OAuthAccessToken、OAuthAccessTokenSecret を直接作成することで設定できます。 NetSuite UI でのトークン作成手順については、ヘルプドキュメントの「はじめに」セクションをご参照ください。

アクセストークンを作成したら、以下の接続プロパティを設定して接続してみましょう。

AuthScheme = Token
AccountId = 接続先のアカウント
OAuthClientId = アプリケーション作成時に表示されるコンシューマーキー
OAuthClientSecret = アプリケーション作成時に表示されるコンシューマーシークレット
OAuthAccessToken = アクセストークン作成時のトークンID
OAuthAccessTokenSecret = アクセストークン作成時のトークンシークレット

その他の認証方法については、ヘルプドキュメントの「はじめに」をご確認ください。

接続を構成する際に、Max Rows 接続プロパティも設定できます。これにより返される行数が制限されるため、レポートやビジュアライゼーションをデザインするときのパフォーマンスを向上させることができます。

DataSet を作成する

以下のステップに従ってVisual Studio ADO.NET DataSet Designer を使用し、ADO.NET DataSet オブジェクトを作成します。Crystal Reports はNetSuite テーブルのメタデータを含むDataSet オブジェクトにバインドします。またこのアプローチでは、App.config に接続文字列が追加されることに注意してください。後にこの接続文字列を使用してデータをレポートにロードします。

Solution Explorer でプロジェクトを右クリックし、「Add」->「New Item」をクリックします。
DataSet を選択します。DataSet Designer が表示されます。
Server Explorer からDataSet Designer にテーブルをドラッグ & ドロップします。この記事ではSalesOrder テーブルを使用します。

NetSuite フィールドをレポートに追加する

以下のステップに従って、DataSet からレポートにカラムを追加します。

Solution Explorer で.rpt ファイルをダブルクリックし、Crystal Reports Designer を開きます。
デザイナーを右クリックし、「Database」->「Database Expert」と進みます。
Project Folder とADO.NET DataSets ノードを展開し、作成したDataSet を「Selected Tables」ボックスにドラッグします。これで、Field Explorer からフィールドにアクセスできます。
Field Explorer からレポートの「Details」セクションまたは別のセクションにフィールドをドラッグ & ドロップします。

DataSet columns in a report.(Salesforce is shown.)

レポートにデータをロードする

メタデータのみを含むDataSet を作成したら、実際のデータを含むDataTable を作成する必要があります。NetSuiteDataAdapter を使用して、SQL クエリの結果をDataTable に入力できます。

System.Configuration.dll への参照をプロジェクトに追加して、App.config から接続文字列を使用できるようにします。
App.config で.NET 4.0 を使用する場合にCrystal Reports との互換性を保つため、次のコードを設定ノードに追加します。
```
  <startup useLegacyV2RuntimeActivationPolicy="true">
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
  </startup>
```

Window.xaml.cs ファイルに以下の参照を追加します。

using System.Configuration;
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System.Data.CData.NetSuite;
using System.Data;

以下のWindow_Loaded メソッドをWindow.xaml.cs に追加し、DataTable を返すSQL クエリを実行します。最低でも、レポートで使用されているカラムと同じカラムは選択する必要があることに注意してください。

private void Window_Loaded(object sender, RoutedEventArgs e) {
  ReportDocument report = new ReportDocument();
  report.Load("../../CrystalReport1.rpt");
 var connectionString = ConfigurationManager.ConnectionStrings["MyAppConfigConnectionStringName"].ConnectionString;
  using (NetSuiteConnection connection = new NetSuiteConnection(connectionString)) {
    NetSuiteDataAdapter dataAdapter = new NetSuiteDataAdapter(
    "SELECT Customer.FirstName AS CustomerName, SalesOrder.Total AS SalesOrderTotal FROM SalesOrder, Customer", connection);
     DataSet set = new DataSet("_set");
     DataTable table = set.Tables.Add("_table");
     dataAdapter.Fill(table);
     report.SetDataSource(table);
  }
  reportViewer.ViewerCore.ReportSource = report;
}

Window.xaml ファイルでLoaded イベントを追加し、Window タグを以下のようにします。


<Window x:Class="CrystalReportWpfApplication4.Window1"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:cr="clr-namespace:SAPBusinessObjects.WPF.Viewer;assembly=SAPBusinessObjects.WPF.Viewer"
        alt="WPF Crystal Report Viewer" Height="600" Width="800" Loaded="Window_Loaded">
        ...
</Window>

レポートを実行します。レポートが読み込まれると、プロバイダはクエリを実行して現在のデータを取得します。

NetSuite のデータのチャートを作成する

Chart Expert などのエキスパートとともにDataSet を使用することもできます。

Crystal Reports Designer を右クリックして「Insert」->「Chart」とクリックします。
「Report Header」または「Report Footer」セクションを選択します。Chart Expert が表示されます。
「Type」タブでチャートタイプを選択します。この記事では、サイドバイサイドの棒グラフを使用します。
「Data」タブでx 軸のカラムと条件を選択します。例えば、DataSet ノードのCustomerName カラムを「On Change Of」メニューの下のボックスにドラッグします。
x 軸のカラムを選択し、「TopN」ボタンと「Order」ボタンをクリックして並べ替えと制限を構成します。
y 軸のカラムとサマリー操作を選択します。例えば、DataSet ノードのSalesOrderTotal カラムを「Show Values」ボックスにドラッグします。
レポートを実行します。

Crystal Reports は、NetSuite API などに対してGROUP BY を実行する代わりに、DataTable にロード済みのデータに対して集計を実行することに注意してください。これは、レポート作成ウィザードにも当てはまります。

別のDataSet を作成し、他のクエリを入力することで、NetSuite に対して実行されるクエリをより細かく制御できます。ドライバのSQL エンジンの詳細については、ヘルプドキュメントを参照してください。