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

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

record.attach.promise(options)メソッドは、1つのレコードを別のレコードに非同期にアタッチするために使用します。この方法では、スクリプトの残りの部分をブロックせずに操作を実行できるため、特にクライアント側のスクリプトの効率性と応答性が向上します。

対応しているスクリプト・タイプ:クライアント・スクリプト

戻り値: Promiseオブジェクト

Promiseは、非同期操作の結果を表すJavaScriptオブジェクトです。これにより、操作が保留中の間もスクリプトの実行を続行できます。

Promiseの状態は次のいずれかです。

• 保留中 - 操作がまだ進行中です。
• 履行済 - 操作が正常に完了しました。
• 拒否 - 操作が失敗しました。

パラメータ	タイプ	必須	説明
options.record	record.Record	✅はい	添付するレコード。
options.record.type	文字列	✅はい	添付するレコードのタイプ。record.Type列挙型(ファイルなど)を使用します。
options.record.id	数値|文字列	✅はい	添付するレコードの内部ID。
options.to	record.Record	✅はい	options.recordが添付されるレコード。
option.to.type	文字列	✅はい	添付するレコードのタイプ。record.Type列挙を使用します。
option.to.id	数値|文字列	✅はい	添付先のレコードの内部ID。
options.attributes	オブジェクト	❌いいえ	添付属性を含むオプションの名前/値ペア。デフォルトはnullです。

実行するサンプル・スクリプト

/**
 * @NApiVersion 2.x
 * @NScriptType ClientScript
 * @NModuleScope SameAccount
 */
define(['N/record','N/error','N/currentRecord'],
function(record,error,currentRecord) {
    /**
     * Function to be executed after page is initialized.
     *
     * @param {Object} scriptContext
     * @param {Record} scriptContext.currentRecord - Current form record
     * @param {string} scriptContext.mode - The mode in which the record is being accessed (create, copy, or edit)