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

@oracle

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

record.create.promise(options)は、標準のrecord.create(options)関数のPromise-basedバージョンです。これにより、開発者は新しいレコードを非同期的に作成できます。つまり、スクリプトでは、レコード作成プロセスの完了を待機しながら他の操作を実行できます。

この関数は、NetSuiteの最新のJavaScriptパターン、特にPromises構文またはasync構文を使用した非同期プログラミングへの継続的な移行の一部です。

パラメータ

次に、record.create.promise(options)関数で受け入れられるパラメータを示します。

パラメータ	タイプ	必須/オプション	説明
options.type	文字列。	要求済	作成するレコードタイプ。この値は、作成するレコードのRecord.typeプロパティを決定します。このプロパティは、既存のレコードでは読取り専用です。 使用上の注意事項: 標準のNetSuiteレコードを作成する場合は、record.Type列挙を使用します。 カスタム・レコードを作成する場合は、カスタム・レコードの種類の文字列IDを使用します。このIDの検索の詳細は、ドキュメントのカスタム・レコードを参照してください。
options.isDynamic	ブール	(オプション)	新しいレコードを動的モードで作成するかどうかを決定します。 trueの場合、レコードは動的モードで作成されます。 falseの場合、レコードは標準モード(デフォルト)で作成されます。
options.defaultValues	オブジェクト	(オプション)	新規レコードのデフォルト・フィールド値を含む名前/値ペア。デフォルトでは、この値はnullです。

たとえば、

/**
 * @NApiVersion 2 .1
 * @NScriptType ScheduledScript 
 */
define(['N/record', 'N/log'], (record, log) => {

    /**
     *例: Promise APIを使用した新規顧客レコードの作成
     */
    const execute = async (context) => {
        try {
            // 新規顧客を非同期に保存
            const customer = await record.create.promise({
                type: record.Type.CUSTOMER,
                isDynamic: true
            });

            // Set required fields for the customer
            customer.setValue({
                fieldId: 'companyname',
                value: 'Sample Customer Promise'
            });
            customer.setValue({
                fieldId: 'email',
                value: 'sample.customer@oracle .com'