NetSuite管理者ヒント| SuiteScriptsのエラー処理にTry/Catchを活用

SuiteScriptソリューションを構築する場合、特に外部データ、統合またはユーザー入力に依存する操作では、実行時に潜在的なエラーを予測することが重要です。これらの危険な操作を try/catchブロック内にラップすると、エラーを正常に取得してログに記録でき、スクリプトの異常な障害を防ぎ、システムの信頼性を向上させることができます。

Try/Catchの使い方

• 例外の取得:スクリプトが暗黙的に失敗したり、予期しない実行を停止したりしないようにします。
• サポート性の向上:捕捉されたエラーは、有用なコンテキストでログに記録できるため、管理者や開発者がより迅速にトラブルシューティングできます。
• ユーザー・エクスペリエンスの保護:エンド・ユーザーに対してタスク、フォールバック・アクションまたはよりクリーンなエラー・メッセージングの一部を完了できます。

定期スクリプトのサンプル・パターン

define(['N/log'], function(log) {
    function execute(context) {
        try {
            // エラーが発生しやすいロジック
            var result = riskyOperation();
            log.audit({title: 'Operation Succeeded', details: result});
        } catch (e) {
            log.error({title: 'Error Occurred', details: e.message});
            // 必要に応じて詳細を追加するか、必要に応じて再発させる
        }
    }
    return { execute: execute };
});

この例では、tryブロックには、データの処理、計算の実行、レコードの取得などのエラーをスローする可能性のあるコードが含まれています。

エラーが発生した場合、制御はただちに catchブロックに移動します。このブロックでは、スクリプトによって実行が突然停止されるのではなく、エラーの詳細が記録されます。

これにより、1つの操作が失敗しても、残りのスクリプト(またはシステム)をスムーズに実行し続けることができます。

Try/Catchエラー処理を含む定期スクリプトのサンプル

/**
 * @NApiVersion 2 .x
 * @NScriptType ScheduledScript 
 */

define(['N/log', 'N/search'], function(log, search) {
    function execute(context) {
        try {
            // 例: 保存済検索のロードと結果の処理
            var mySearch = search.load({ id: 'customsearch_customer_list' });
            var searchResultCount = mySearch.runPaged().count;

            log.audit({
                title: 'Search Succeeded',
                details: 'Total records found: ' + searchResultCount
            });

            // 処理を続行

        } catch (e) {
            log.error({
                title: 'Error Occurred',
                details: e.message || e.toString()
            });
            // オプションで、特定のエラーを再発または処理させる
        }
    }

    return {
        execute: execute
    };
});

• スクリプトでは、検索および処理ロジックをtry/catchブロックで囲みます。
• log.audit