各製品の資料を入手。
詳細はこちら →
製品をチェック
JDBI からNetSuite データ のデータアクセスオブジェクトを作成
JDBI でNetSuite のデータ 用のSQL オブジェクトAPIを作成する方法を概説します。
最終更新日：2022-05-25
この記事で実現できるNetSuite 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for NetSuite は、Java アプリケーションとリアルタイムNetSuite のデータ のデータ連携を実現します。これらの技術を組み合わせることによって、NetSuite のデータ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO（Data Access Object ）とそれに付随するNetSuite のデータ の読み書きのためのコードの作成について説明します。
NetSuite SalesOrder Entity のDAO を作成
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MySalesOrderDAO {
//insert new data into NetSuite
@SqlUpdate("INSERT INTO SalesOrder (Class_Name, SalesOrderTotal) values (:class_Name, :salesOrderTotal)")
void insert(@Bind("class_Name") String class_Name, @Bind("salesOrderTotal") String salesOrderTotal);
//request specific data from NetSuite (String type is used for simplicity)
@SqlQuery("SELECT SalesOrderTotal FROM SalesOrder WHERE Class_Name = :class_Name")
String findSalesOrderTotalByClass_Name(@Bind("class_Name") String class_Name);
/*
* close with no args is used to close the connection
*/
void close();
}
NetSuite への接続を開く
必要な接続プロパティを収集し、NetSuite に接続するための適切なJDBC URL を作成します。
Netsuite への接続
NetSuite は現在、2つの異なるAPI を提供しています。
- SuiteTalk はNetSuite との通信に使用する、SOAP ベースのより古いサービスです。多くのエンティティを幅広くサポートし、INSERT / UPDATE / DELETE を完全にサポートします。 しかしデータの抽出用ツールは低機能で、SELECT 時のパフォーマンスは極めて低いです。テーブルを結合するよい方法もありません。データのグループ化および集計はこのAPI からは利用できず、 そのためこれらの操作をサポートするには、すべてをクライアントサイドで実行しなければなりません。
- SuiteQL は新しいAPI です。サービスとのSQL ライクな通信方法を実現するため、JOIN の機能はより豊富になり、GROUP BY や集計機能もサポートします。 加えて、抽出したいカラムだけを取得する機能も完全にサポートします。そのため、データを抽出する際のパフォーマンスがSuiteTalk より大幅に向上しています。ただし、サポートされるのはデータの抽出のみです。
NetSuite に接続するには、以下を行う必要があります。
- Schema を設定して、接続に使用するAPI を指定。データを取得するだけの場合は、SuiteQL の使用をお勧めします。データの取得および変更が必要な場合は、SuiteTalk の使用をお勧めします。
- 使用するAPI に適した接続オプションを設定します。（それぞれのAPI で利用可能な接続オプションが異なります。ヘルプドキュメントの「許可の設定」を参照してください。）
Netsuite への認証
SuiteTalk またはSuiteQL
NetSuite は3つの形式のOAuth 認証を提供します。
- トークンベース認証（TBA）は、基本的にOAuth 1.0 で、OAuthAccessToken とOAuthAccessTokenSecret を実行時ではなくNetSuite UI 内で作成します。 TBA は、2020.2 以降のSuiteTalk およびSuiteQL の両方で利用可能です。
- OAuth 2.0 認証は、SuiteQL でのみ利用できます。OAuth 2.0 認証を強制するには、次のいずれかを実行します。
- OAuthVersion を使用するAPI に明示的に設定、または
- Schema をSuiteQL に設定
- OAuth JWT 認証は、OAuth 2.0 クライアント認証フローであり、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。この認証方法は、Schema がSuiteQL に設定されている場合にのみ使用できます。
認証方法の詳細はヘルプドキュメントの「はじめに」を参照してください。
ビルトイン接続文字列デザイナー
JDBC URL の構成については、NetSuite JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.netsuite.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
NetSuite の接続文字列は、通常次のようになります。
jdbc:netsuite:Account Id=XABC123456;Password=password;User=user;Role Id=3;Version=2013_1;
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:netsuite:Account Id=XABC123456;Password=password;User=user;Role Id=3;Version=2013_1;");
MySalesOrderDAO dao = dbi.open(MySalesOrderDAO.class);
//do stuff with the DAO
dao.close();
NetSuite データ について
NetSuite への接続を開いた状態で以前定義したメソッドを呼び出すだけで、NetSuite のSalesOrder エンティティからデータを取得できます。
//disply the result of our 'find' method
String salesOrderTotal = dao.findSalesOrderTotalByClass_Name("Furniture : Office");
System.out.println(salesOrderTotal);
NetSuite データ の書き方
以前定義した方法を使用すれば、NetSuite にデータを書き込むことも簡単になります。
//add a new entry to the SalesOrder entity
dao.insert(newClass_Name, newSalesOrderTotal);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for NetSuite と統合することで、SQL Object API for NetSuite を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムNetSuite を操作しましょう。
関連コンテンツ
