NetSuite管理者ヒント|非同期SuiteScriptを使用した顧客レコードの検証および更新

多くの場合、管理者や開発者は、顧客情報の取得、監査、更新など、レコードとのやり取りを伴う複雑なプロセスを自動化する必要があります。SuiteScript 2.1の導入により、async/awaitやpromise-based APIsなどの強力な最新のJavaScript機能が提供され、レコード操作がより直感的でメンテナンス可能になりました。

この記事では、非同期処理を利用して顧客レコードを安全にロードし、キーの詳細を記録し、欠落している情報をチェックし、ターゲットを絞った更新を行う実際のスクリプトの例について説明します。この例では、フィールド検証、エラー処理およびロギングのベスト・プラクティスを示し、独自の管理自動化タスクに適応できるテンプレートを提供します。

/**
 * @NApiVersion 2 .1
 * @NScriptType ScheduledScript 
 * @NModuleScope SameAccount 
 */
define(['N/record', 'N/log'], (record, log) => {
    /**
     * The main entry point for the scheduled script.
     * This example demonstrates best practices in record loading, conditional field updating, and error handling.
     */ 
    const execute = async (context) => {
        // 環境の有効な顧客内部IDに置き換える
        const CUSTOMER_ID = 123;

        try {
            // PromiseベースのAPIを使用して顧客レコードを非同期にロード
            const customerRecord = await record.load.promise({
                type: record.Type.CUSTOMER,
                id: CUSTOMER_ID
            });

            // 管理監査の基本的な識別情報をログに記録する
            log.audit({
                title: 'Loaded Customer',
                details: `ID: ${CUSTOMER_ID}, Name: ${customerRecord.getValue('entityid')}`
            });

            // 電話番号が現在空白の場合は、チェックして更新
            const currentPhone = customerRecord.getValue('phone');
            if (!currentPhone) {
                const defaultPhone = '800-555-1234';
                customerRecord.setValue({ fieldId: 'phone', value: defaultPhone });
                log.debug({
                    title: 'Phone Updated',