NetSuite の始め方 | N/record: record.copy(options)メソッド

前の記事NetSuiteの始め方 | SuiteScript 2.xモジュールの理解で、レコードの操作に使用されるSuiteScriptモジュールおよびN/recordモジュール、「NetSuiteの始め方 | N/recordモジュールの概要」を学習しました。次に、N/record: record.copy(options) Methodのメンバーの1つを詳しく見ていきます。

record.copy(options)メソッドは、既存のレコードからデータを複製して新しいレコードを作成します。これは、同じ情報をすべて手動で再入力しなくても、別のレコードに似たレコードを作成する必要がある場合に便利です。たとえば、注文書、発注書またはカスタム・レコードをコピーして、元の値を継承する新しいレコードをすばやく生成できます。

このメソッドは、record.Recordオブジェクトを返します。このオブジェクトは、保存する前に変更できます。レコードを操作する場合、標準モード(スクリプト駆動型、明示的なフィールド更新)または動的モード(NetSuiteフォームのように変更がただちにコミットされるUIのような相互作用)のいずれかで操作することを選択できます。

このメソッドは、クライアント・スクリプトとサーバー・スクリプトの両方でサポートされており、開発者はレコード作成プロセスを柔軟に自動化できます。

ガバナンス

• 取引レコード: 10単位
• カスタム・レコード: 2ユニット
• その他のレコード:5台

ガバナンスの使用により、システム・リソースの効率的な消費が保証されます。消費される単位数は、コピーするレコードのタイプによって異なります。

パラメータ	タイプ	必須	説明
options.type	文字列	必須	レコード・タイプ。標準レコードにはrecord.Type列挙を使用します。カスタム・レコードの種類の場合は、レコードの文字列IDを使用します。このIDの検索の詳細は、「カスタム・レコード」を参照してください。
options.id	電話番号	必須	コピーする既存のレコードの内部ID。
options.isDynamic	ブール	オプション	新規レコードを動的モードで作成するかどうかを決定します。デフォルト: false。SuiteScript 2.x標準モードおよび動的モードを参照してください。
options.defaultValues	オブジェクト	オプション	新しいレコードのフィールドのデフォルト値を含む名前と値のペア。デフォルト: null。「N/recordデフォルト値」を参照してください。

サンプル・スクリプト: 注文書レコードのコピー

/**
 * @NApiVersion 2.x
  * @NScriptType Suitelet
 */
define(['N/record'], function(record) {
function onRequest(scriptContext) {
var newSalesOrder = record.copy({
type: record.Type.SALES_ORDER,
id: 18341,
isDynamic: true,
defaultValues: {
entity: 1904
}
});
newSalesOrder.setValue({
            fieldId: 'memo',
            value: 'Copied from Sales Order #18341'
        });
        // Save the new record
        var newRecordId = newSalesOrder.save();
        log.debug('New Sales Order created with ID', newRecordId);
}
    return {
        onRequest: onRequest
    };
});

元の注文書レコード

スクリプトの実行後、元のレコードをコピーして新しい注文書レコードが作成されます:

スクリプト実行ログに、新しく作成された注文書IDが表示されます

ここに記載されているサンプルコードは、法律で許可される最大限の範囲で、いかなる種類の保証もなく「現状のまま」提供されます。Oracle + NetSuite Inc. は、サンプルコードの開発プラットフォームへの実装や、独自のWebサーバー構成の使用において、開発者の個々の成功を保証または保証しません。