公開データ

CData ADO.NET Provider for NetSuite は、NetSuite テーブルに関する情報を実行時に動的に取得します。公開されるテーブルとカラムは、いくつかの接続プロパティで制御されます。このセクションでは、リストされているテーブルとカラムの制御に使用できる接続プロパティについて、および探しているNetSuite データを取得する方法について説明します。テーブルの種類と、各種類のテーブルにINSERT と更新を行う方法の例を含むより詳しい説明は、Tables を参照してください。

NetSuite デフォルトのレコードの種類

NetSuite には、カスタマイズせずとも多くのデフォルトのレコードの種類が存在します。勘定科目（Account）、顧客（Customer）、仕入先（Vendor）などのエンティティです。注文書（SalesOrder）、請求書（Invoice）、発注書（PurchaseOrder）といったトランザクションも含まれます。これらの各デフォルトのレコードの種類は、 Version 接続プロパティに基づいて実行時に決定されます。この方法で見つかった各レコードの種類について、1つのテーブルが公開されます。

これらの「デフォルトのレコードの種類」は、以下で子テーブルについて記述する際には、しばしば親テーブルとも呼称します。

バージョン

少なくとも年2回、NetSuite は新バージョンをリリースします。新バージョンには、すべてのユーザーが利用可能な、新しいデフォルトのレコードの種類が含まれます。最新のレコードの種類をテーブルとして公開するには、Version 接続プロパティを設定してください。各メジャーリリース毎にNetSuite の最新バージョンと合致するよう、デフォルトのレコードの種類が更新されます。

子テーブル

NetSuite 内の多くのデフォルトのレコードの種類は、さまざまなデータのコレクションを含みます。例えば、顧客（Customer）には複数の住所を登録できます。請求書（Invoice）には複数の明細を登録できます。これらの子コレクションは、子テーブルに公開されます。例えば、Invoice_itemList は親テーブルであるInvoice の子テーブルと捉えられます。

子コレクションの数が多いため、これらを公開すると全表示テーブル数が何百の単位で大幅に増加します。子テーブルは IncludeChildTables 接続プロパティをtrue に設定することで有効化できます。デフォルト値はfalse です。

子テーブルは初期レベル以上は公開されません。例えば、Purchase Order のExpense List は、リンクされたOrder List を含みます。リンクされたOrder List には何のテーブルも公開されません。その代わり、下記のように、このデータを取得するには集計カラムを使用する必要があります。

集計カラム

また、AggregateColumnMode 接続プロパティを使って、子コレクションを別の方法で公開することもできます。集計カラムは住所や明細のコレクションのような、複雑なデータのコレクションを返します。これらの値を１つのカラムに収めることはできないので、XML の値として集計されます。ほとんどの子コレクションの情報は、 IncludeChildTables をtrue に設定した方が、簡単に取得でき、可読性も高いです。集計はデフォルトでは無効になっています。

集計は子テーブル上にさらにコレクションを公開するのに便利です。例えば、リンクされたOrder List をPurchase Order のExpense List から取得したいとしましょう。 IncludeChildTables をtrue に、AggregateColumnMode をList に設定してください。これらの設定をするとExpenseList_linkedOrderList カラムが表示され、PurchaseOrder_expenseList テーブルのデータが返されます。

集計カラムからINSERT を行う場合やデータの概要を確認するためのサンプルの取得のような、非常に小さなサンプルを試す場合以外では、AggregateColumnMode をListAndRetrieve に設定することは非推奨です。 AggregateColumnMode をListAndRetrieve に設定すると、集計カラムのデータがすべてのテーブルに常にリクエストされるようになります。このデータがリクエストされる場合、 NetSuite がデータを返す速度が大幅に遅くなるので、Customer、PurchaseOrder、Invoice といった親テーブルのパフォーマンスを大きく低下させます。 AggregateColumnMode がList に設定されると、 NetSuite がデータをパフォーマンスの低下なしで取得するため、子テーブルからデータを取得する際に、集計カラムは必ずデータを返します。

カスタムレコード

カスタムレコードはフルテーブルとして公開されます。 NetSuite にデフォルトで公開されているレコードの種類のいくつかは、カスタムレコードとみなされます。NetSuite の［カスタマイゼーション］->［リスト］->［レコードとフィールド］->［レコードの種類］で利用可能なものは、CData ではすべてカスタムレコードとみなします。この設定を変えるには、 IncludeCustomRecordTables を変更してください。

カスタムリスト

カスタムリストは、デフォルトでは公開されていません。NetSuite のカスタムリストは、いくつかの種類のカスタムフィールド用に選択可能な情報のリストです。これらはほとんど変更されないため、通常重要なデータを含みません。しかし、これらのリストはIncludeCustomListTables 接続プロパティをtrue に設定することで、テーブルとして公開することもできます。

カスタムフィールド

カスタムフィールドはデフォルトで公開されており、適切なテーブルに直接表示されます。カスタムフィールドはInvoice やCustomer のような親テーブルと、Invoice_itemList やCustomer_addressbookList のような子テーブルの両方に表示されます。カスタムフィールドの公開は、IncludeCustomFieldColumns 接続プロパティで設定できます。

参照カラム

参照カラムはレコード参照を含むカラムです。例えば、Invoice は1つのEntity レコード参照を含みます。レコード参照は常にInternalId とName を、場合によってはType やExternalId など、さまざまな情報を返します。 NetSuite のレコード参照カラムの数が多いため、デフォルトではInternalId とName のみ表示されます。この動作は、IncludeReferenceColumns 接続プロパティから変更できます。

レポート

レポートはNetSuite API ではサポートされていません。これはAPI 側の制限で、そのためCData およびサードパーティ製のツールではレポートが利用できません。NetSuite は代わりに、PostingTransactionSummary を使用して、レポートにあるような情報を取得することを推奨しています。 PostingTransactionSummary ビューはこうした情報にアクセスするために使用できます。

保存検索

NetSuite の保存検索はサポートされていますが、NetSuite API のためいくらか制限があります。詳しくは、保存検索を参照してください。