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

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

Promises (SuiteScript 2.1+構文)を使用してレコードを非同期に削除するには、record.delete.promise(options)メソッドを使用します。これは、record.delete(options)と同等の非同期です。

スクリプトのパフォーマンスを向上し、コードをよりクリーンに保ち、長時間実行される操作をより適切に処理できるようにします。このアプローチは、Suitelet、Map/Reduceスクリプト、または一時レコードをクリーン・アップするためのツールを構築する場合に特に役立ちます。スクリプトが実行をブロックせずにレコードを処理でき、よりスケーラブルで保守可能なソリューションにつながる可能性があるためです。

構文

require(['N/record'], function(record) {
    record.delete.promise({
        type: record.Type.SALES_ORDER,
        id: 1234
    }).then(function(result) {
        // 成功ロジックはこちら
    }).catch(function(e) {
        // ここでのエラー処理
    });
});

パラメータ

• type: (string)– レコード・タイプ(record.Type.SALES_ORDER、'customer'など)
• ID: (number|string)– 削除するレコードの内部ID。

戻り値

• 削除が失敗した場合に詳細で解決されるか、エラーで拒否される約束。

一般的なユース・ケース

• record.delete.promise(options)は、レコードを非同期に削除する場合(多くの場合、SuiteScript 2.1以上で実行されているスクリプト、または非同期/待機パターンを使用している場合)に使用します。

SuiteScript 2.1定期スクリプトの例: 非同期でのレコードの削除

/**
 * @NApiVersion 2 .1
 * @NScriptType ScheduledScript 
 */
define(['N/record', 'N/log'], (record, log) => {
    /**
     * The main function that NetSuite calls when the scheduled script runs.
     * Uses async/await to delete a specific record asynchronously.
     */
    const execute = async (context) => {
        try {