スクリプトが時間の経過とともに変更される可能性がある値を使用する場合、それらの値をスクリプト内に直接ハードコーディングするのではなく、通常はスクリプト・パラメータで制御する方が適しています。
スクリプト・パラメータを使用すると、管理者はスクリプト・ファイルを編集せずに、スクリプト・デプロイメントから特定のスクリプト値を更新できます。
シナリオ
スクリプトで、ビジネス・プロセスに応じて変更される可能性がある値を使用する必要があります。
例:
- デフォルト・ステータス
- 保存検索ID
- 従業員レビュアー
- 電子メール受信者
- フォローアップまでの日数
- 処理上限
- カスタム・レコード・タイプ参照
これらの値がハードコーディングされている場合、値が変更されるたびに、開発者はスクリプトを編集して再デプロイする必要がある可能性があります。
解決策
管理者が制御する必要がある可能性がある値を保存するには、スクリプト・パラメータを使用します。
これにより、スクリプトの柔軟性が高まり、保守しやすくなります。
値をスクリプトに直接配置する代わりに、スクリプトはスクリプト・デプロイメントから値を読み取ります。
一般的なスクリプト・パラメータの例
- 保存検索ID – 管理者は、スクリプトで使用する保存検索を変更できます。
- デフォルト・ステータス – 管理者は、スクリプトが適用するステータスを制御できます。
- 電子メール受信者 – 管理者は、コードを編集せずに通知の受信者を更新できます。
- 処理上限 – 管理者は、スクリプトが処理するレコード数を制御できます。
- フォローアップ日数 – 管理者は、スクリプトを変更せずに日付ロジックを調整できます。
サンプル構文
次のサンプルは、スクリプトがスクリプト・デプロイメントからパラメータ値を読み取る方法を示しています。
/**
* @NApiVersion 2 .1
* @NScriptType ScheduledScript
*/
define(['N/runtime', 'N/log'], (runtime, log) => {
function execute(context) {
const script = runtime.getCurrentScript();
const savedSearchId = script.getParameter({
name: 'custscript_saved_search_id'
});
const processingLimit = script.getParameter({
name: 'custscript_processing_limit'
});
log.audit({
title: 'Script Parameters',
details: {
savedSearchId,
processingLimit
}
});
// Add script processing logic here.
}
return {
execute
};
});
仕組み
スクリプトでは、次を使用します。
runtime.getCurrentScript()
これにより、現在のスクリプト実行にアクセスします。
次に、以下を使用します。
script.getParameter({
** name: 'custscript_saved_search_id'**
});
これにより、スクリプト・デプロイメントからパラメータ値を読み取ります。
パラメータIDは、NetSuiteで構成されているスクリプト・パラメータIDと一致している必要があります。
スクリプト・パラメータを設定する場所
スクリプト・パラメータは、スクリプト・レコードまたはスクリプト・デプロイメントで構成します。
一般的な設定は次のとおりです。
- スクリプト・レコードを開きます。
- 必要なパラメータを追加します。
- パラメータIDを設定します。
- スクリプト・デプロイメントを開きます。
- スクリプトで使用する値を入力します。
Netsuite:
次に移動します: Customization > Scripting > Scripts > New または、パラメータを設定する必要がある既存のスクリプトを検索します > Parameters サブタブ
既存のデプロイメントがある場合 > 次に移動します: Customization > Scripting > Script Deployment > 既存のスクリプト・デプロイメントを検索します > Parameters サブタブ > パラメータを設定します
新しいスクリプトの場合は、 Deploy Script > をクリックします。新しいスクリプト・デプロイメントにリダイレクトされます
Netsuite Next:
Explore menu を開きます(ホーム・ボタンの横、左下隅にあるハンバーガー・アイコン)。メニューで Customization > Scripting > Scripts に移動します。次に、次のページで New Script を選択するか、existing Script > Parameters サブタブをクリックします。
既存のデプロイメントがある場合 > Explore menu (hamburger icon in the bottom left corner beside the home button)