NetSuite の始め方 | N/log: log.emergency(options)メソッド

前の記事NetSuiteの始め方 | Understanding SuiteScript 2.x Modulesで、スクリプト実行の詳細を記録するために使用される NetSuiteの始め方 | N/log Module Overviewの SuiteScriptモジュールおよびN/logモジュールについて学習しました。次に、N/log: log.emergency(options)メソッドのメンバーの1つを詳しく確認します。

log.emergency()メソッドは、スクリプトの実行ログに緊急レベルのメッセージを記録します。これらのメッセージは、スクリプト・デプロイメントのログ・レベル設定に関係なく常に表示されるため、重大なエラーやシステム・クリティカルなイベントのキャプチャに最適です。

可視性が高いため、この方法は緊急の注意を必要とするシナリオに最適です。

スクリプト・タイプの互換性

このロギング方法は、ほとんどのクライアントおよびサーバー側のスクリプトで機能します。

メモ:

クライアント・スクリプトをフォームに直接アタッチしてデプロイする場合、log.emergency()はサポートされていません。このような場合は、かわりにconsole.log()を使用します。

構文

log.emergency(オプション)

パラメータ

options (Object):次のプロパティを持つオブジェクト。

• title (string、 required):ログに記録される内容を説明する短いラベル。
  • 最大長: 99文字
  • 省略、空またはnullに設定すると、NetSuiteに「無題」と表示されます。
• details (string | Object、 required):ログに記録されるメッセージまたはデータ。
  • 文字列、変数またはオブジェクトを含めることができます。
  • オブジェクトが渡された場合、NetSuiteはJSON.stringify()を使用して自動的に変換します。
  • 3,999文字を超えるメッセージは自動的に切り捨てられます。

log.emergencyメソッドの使用例

/**
 * @NApiVersion 2 .x
 * @NScriptType ScheduledScript 
 */
define(['N/log'], function(log) {
// スクリプト・ロギング用のN/logモジュールをロード
    function execute(context) {
        // クリティカル・エラーをシミュレート
        var criticalError = "Database connection failed!";
        log.emergency({
            title: 'Critical System Error',
            details: criticalError
        });
    }

    return {
        execute: execute
    };
});

ここに記載されているサンプルコードは、法律で許可される最大限の範囲で、いかなる種類の保証もなく「現状のまま」提供されます。Oracle + NetSuite Inc. は、サンプルコードの開発プラットフォームへの実装や、独自のWebサーバー構成の使用において、開発者の個々の成功を保証または保証しません。

Oracle + NetSuite Inc. は、サンプルコードに関連するデータまたは情報の使用、使用結果、正確性、適時性、完全性に関して、いかなる保証も行わず、すべての保証（明示的または黙示的）を否認します。特に、商品性、特定の目的への適合性、コードに関連するサービスまたはソフトウェアに関する保証を否認します。

Oracle + NetSuite Inc. は、サンプルコードに関連する行動から生じるいかなる種類の直接的、間接的または結果的な損害や費用についても責任を負いません。

SuiteScriptのデプロイの詳細は、これらのNetSuiteの始め方記事を確認してください。 

• NetSuite の始め方 | スクリプトレコードの作成方法
• NetSuite の始め方 | SuiteScript 2.x レコードでスクリプトタイプを設定する方法
• NetSuite の始め方 | スクリプトレコードの展開方法
• NetSuiteの始め方 | SuiteScript の種類の概要

今後の記事では、個々のSuiteScript 2.xモジュールを分解し、それらをSuiteCloud製品領域内のスクリプトで効果的に使用する方法を説明します NetSuiteの始め方 > SuiteCloud カテゴリをフォローして、新しい記事が公開されるたびに通知を受信しましょう。