NetSuite の始め方|クライアント・スクリプト: validateLine(scriptContext)

NetSuite の始め方| SuiteScript の種類の概要 の記事で、すべてのタイプのSuiteScriptについて説明しましたので、様々なタイプのクライアント・スクリプトに焦点を当てます。validateLineは、ユーザーがレコードにコミットされる直前に、サブリスト内の行を追加または更新しようとするときに使用されます。これはゲートキーパーとして機能し、サブリストのデータが事前定義済の条件またはビジネス・ルールを満たしていることを確認します。この検証により、保存する前にサブリストに入力されたデータの整合性と正確性が保証されます。

予想される戻り値:

• true: サブリスト行が有効で、追加または更新が成功します。
• false:検証に失敗しました。サブリストへの追加または更新は防止されます。

validateLine関数の簡単な例を次に示します。

/**
 * @NApiVersion 2.x
 * @NScriptType ClientScript
 * @NModuleScope SameAccount
 */
define(['N/error','N/currentRecord'],
function(error,currentRecord) {
    /**
     * Validation function to be executed when sublist line is committed.
     *
     * @param {Object} scriptContext
     * @param {Record} scriptContext.currentRecord - Current form record
     * @param {string} scriptContext.sublistId - Sublist name
     *
     * @returns {boolean} Return true if sublist line is valid
     *
     */
    function validateLine(scriptContext) {
var currentRecord = scriptContext.currentRecord;
        var fieldId = scriptContext.fieldId;
        var sublistId = scriptContext.sublistId;
if (sublistId === 'item') {
            var currentQuantity = currentRecord.getCurrentSublistValue({
                sublistId: 'item',
                fieldId: 'quantity'
            });
            // Ensure quantity is less than 3
            if (currentQuantity > 3) {
                var currentDesc = currentRecord.setCurrentSublistValue({
sublistId: 'item',
fieldId: 'description',
value: 'Quantity must be less than 3.'