NetSuite の始め方| N/record: record.transform(options)Method

前の記事NetSuiteの始め方| Understanding SuiteScript 2.x Modulesで、レコードの操作に使用されるSuiteScriptモジュールおよびN/recordモジュールNetSuiteの始め方| N/record Module Overviewを学習しました。次に、N/record: record.transform(options) Methodのメンバーの1つを詳しく確認します。

record.transform(options)メソッド。あるタイプの既存のレコードを別のタイプに変換して新しいレコードを作成するために使用されます。

構文

var newRecord = record.transform(options);

パラメータ

optionsパラメータは、次の必須プロパティーを持つオブジェクトです。

• fromType (文字列):ソース・レコードのレコード・タイプ(例: record.Type.SALESORDER)。
• fromId (数値):変換するソース・レコードの内部ID。
• toType (文字列):レコードを変換するレコード・タイプ(例: record.Type.INVOICE)。
• isDynamic (ブール、オプション): trueの場合、レコードを動的モードで作成します。デフォルトはfalse (標準モード)です。
• defaultValues (オブジェクト、オプション):新しいレコードに設定するデフォルトのフィールド値のオブジェクト。

単一の注文書を請求書に変換するSuiteScript 2.x定期スクリプトの例を次に示します

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

    function execute(context) {
        // これを変換する注文書内部IDに置き換えます
        var salesOrderId = 12345;

        try {
            // 注文書を請求書に変換
            var invoiceRecord = record.transform({
                fromType: record.Type.SALES_ORDER,
                fromId: salesOrderId,
                toType: record.Type.INVOICE,
                isDynamic: false // or true, as needed
            });

            // 新規請求書を保存
            var invoiceId = invoiceRecord.save();

            //正常に変換され、新規請求書IDが記録される
            log.audit('Invoice Created', 'Created Invoice ID: ' + invoiceId + ' from Sales Order ID: ' + salesOrderId);