NetSuite の始め方｜N/record: record.create(options)モジュール

前回の記事「NetSuiteの始め方｜SuiteScript 2.xモジュールの基本」ではSuiteScriptモジュールとN/recordモジュールの概要について解説しました。今回は、そのメンバーの1つであるN/record: record.create(options)モジュールに焦点を当てます。

record.create(options)関数は、SuiteScript 2.xのN/recordモジュールの一部です。この関数は新しい空のレコードオブジェクトを生成し、必要なデータを入力してシステムに保存できるようにします。

たとえば、次のような用途で使われます：

• 自社ウェブサイトで新規リードが登録された際に顧客（Customer）レコードを作成する
• トランザクションが処理された際に自動で注文書（Sales Order）を作成する

パラメータの詳細

ここでは、record.create(options)内の各パラメータの意味と、その効果的な使い方を説明します。

パラメーター	タイプ	Required	説明
options.type	string	Required	・作成したいレコードタイプを指定します。
options.isDynamic	boolean	Optional	- 標準レコードの場合は、組み込みのrecord.Type列挙体を使用します（例：record.Type.SALES_ORDER、record.Type.CUSTOMERなど）。
options.defaultValues	Object	Optional	- カスタムレコードの場合は、"customrecord_employee_expense"のようなレコードの文字列IDを指定します。これにより、どの種類のレコードを作成するかが明確になります。

例: SuiteScriptを用いて顧客レコードを作成する

/**
 * @NApiVersion 2 .x
 * @NScriptType ScheduledScript 
 */
 
define(['N/search', 'N/record', 'N/log'], function(search, record, log) {

    function execute(context) {
var customerRecord = record.create({
            type: record.Type.CUSTOMER,
            isDynamic: true
        });
        customerRecord.setValue({
            fieldId: 'companyname',
            value: 'Sample Corporation'
        });
        var customerId = customerRecord.save();
        return customerId;
    }
    
    return {
        execute: execute
    };
});

Line(s)	Purpose
/ ... */	・スクリプトヘッダー：このスクリプトがSuiteScript 2.xであり、種類はスケジュールスクリプトであることを定義します。