Confirm Bundle installation, Enable Features, and Create Account

This sample is a bundle installation script that makes sure the bundle being installed is version 2.1, confirms that the Work Orders and Multiple Currencies features are enabled, and then creates an account record.

The conversion of this script from SuiteScript 1.0 to SuiteScript 2.1 includes the following:

JSDoc tags are added at the top of the script to indicate the script version and script type
The define statement is added which imports the N/runtime and N/error modules.
The return statement is added with the beforeInstall, beforeUpdate, and afterUpdate entry points.
The beforeInstall, beforeUpdate, and afterUpdate entry point functions are created.
The beforeInstall, beforeUpdate, and afterUpdate entry point functions are converted to SuiteScript 2.1.
- The toversion argument is changed to the params.toVersion or params.version parameter.
- The fromversion argument is changed to the params.fromVersion parameter.
- The nlapiCreateRecord function is changed to the record.create method.
- The setFieldValue function is changed to the Record.setValue method.
- The nlapiSubmitRecord function is changed to the Record.save method.
The checkFeatureEnabled function is converted to SuiteScript 2.1
- The nlapiGetContext function isn't needed anymore.
- The getFeature function is changed to the runtime.isFeatureInEffect method.
- The nlapiLogExecution function is changed to the log.debug method.
- The nlobjError object is changed to the error.create method.

SuiteScript 1.0 Script	SuiteScript 2.1 Script
function beforeInstall(toversion){ checkFeatureEnabled('WORKORDERS'); if (toversion.toString() == "2.0" ){ checkFeatureEnabled('MULTICURRENCY'); } } function afterInstall(toversion){ var randomnumber=Math.floor(Math.random()10000); var objRecord = nlapiCreateRecord('account'); objRecord.setFieldValue('accttype','Bank'); objRecord.setFieldValue('acctnumber',randomnumber); objRecord.setFieldValue('acctname','Acct '+toversion); nlapiSubmitRecord(objRecord, true); } function beforeUpdate(fromversion, toversion){ checkFeatureEnabled('WORKORDERS'); if (toversion.toString() == "2.0" ){ checkFeatureEnabled('MULTICURRENCY'); } } function afterUpdate(fromversion, toversion){ if (fromversion.toString() != toversion.toString()){ var randomnumber=Math.floor(Math.random()10000); var objRecord = nlapiCreateRecord('account'); objRecord.setFieldValue('accttype','Bank'); objRecord.setFieldValue('acctnumber',randomnumber); objRecord.setFieldValue('acctname','Acct '+toversion); nlapiSubmitRecord(objRecord, true); } } function checkFeatureEnabled(featureId){ var objContext = nlapiGetContext(); var feature = objContext.getFeature(featureId); if (feature){ nlapiLogExecution('DEBUG','Feature',featureId+' enabled'); } else { throw new nlobjError('INSTALLATION_ERROR','Feature '+ featureId+' must be enabled. Please enable the feature and try again.'); } }	/** * @NApiVersion 2.1 * @NScriptType BundleInstallationScript / define(['N/runtime', 'N/error', 'N/record'], (runtime, error, record) => { const checkFeatureEnabled = (featureId) => { const isInEffect = runtime.isFeatureInEffect({ feature: featureId }); if (isInEffect) { log.debug({ title: 'Feature Enabled', details: `${featureId} is enabled.` }); return; } throw error.create({ name: 'INSTALLATION_ERROR', message: `Feature ${featureId} must be enabled. Please enable the feature and try again.` }); }; const beforeInstall = (params) => { checkFeatureEnabled('WORKORDERS'); if (String(params.version) === '2.1') { checkFeatureEnabled('MULTICURRENCY'); } }; const beforeUpdate = (params) => { checkFeatureEnabled('WORKORDERS'); if (String(params.toVersion) === '2.1') { checkFeatureEnabled('MULTICURRENCY'); } }; const afterUpdate = (params) => { const fromVersion = String(params.fromVersion); const toVersion = String(params.toVersion); if (fromVersion !== toVersion) { const randomNumber = Math.floor(Math.random() 10000); const accountRecord = record.create({ type: record.Type.ACCOUNT }); accountRecord.setValue({ fieldId: 'accttype', value: 'Bank' }); accountRecord.setValue({ fieldId: 'acctnumber', value: randomNumber }); accountRecord.setValue({ fieldId: 'acctname', value: `Acct ${toVersion}` }); accountRecord.save({ enableSourcing: true }); } }; return { beforeInstall, beforeUpdate, afterUpdate }; });

SuiteScript 1.0 Script

SuiteScript 2.1 Script

                    function beforeInstall(toversion){
    checkFeatureEnabled('WORKORDERS');
    if (toversion.toString() == "2.0" ){
        checkFeatureEnabled('MULTICURRENCY');
    }
}

function afterInstall(toversion){
    var randomnumber=Math.floor(Math.random()*10000);
    var objRecord = nlapiCreateRecord('account');
    objRecord.setFieldValue('accttype','Bank');
    objRecord.setFieldValue('acctnumber',randomnumber);
    objRecord.setFieldValue('acctname','Acct '+toversion);
    nlapiSubmitRecord(objRecord, true);
}

function beforeUpdate(fromversion, toversion){
    checkFeatureEnabled('WORKORDERS');
    if (toversion.toString() == "2.0" ){
        checkFeatureEnabled('MULTICURRENCY');
    }
}

function afterUpdate(fromversion, toversion){
    if (fromversion.toString() != toversion.toString()){
        var randomnumber=Math.floor(Math.random()*10000);
        var objRecord = nlapiCreateRecord('account');
        objRecord.setFieldValue('accttype','Bank');
        objRecord.setFieldValue('acctnumber',randomnumber);
        objRecord.setFieldValue('acctname','Acct '+toversion);
        nlapiSubmitRecord(objRecord, true);
    }
}

function checkFeatureEnabled(featureId){
    var objContext = nlapiGetContext();
    var feature = objContext.getFeature(featureId);

    if (feature){
        nlapiLogExecution('DEBUG','Feature',featureId+' enabled');
    } else {
        throw new nlobjError('INSTALLATION_ERROR','Feature '+ featureId+' must be enabled. Please enable the feature and try again.');
    }
 }

                    /**
 * @NApiVersion 2.1
 * @NScriptType BundleInstallationScript
 */

define(['N/runtime', 'N/error', 'N/record'], (runtime, error, record) => {
    const checkFeatureEnabled = (featureId) => {
        const isInEffect = runtime.isFeatureInEffect({
            feature: featureId
        });

        if (isInEffect) {
            log.debug({
                title: 'Feature Enabled',
                details: `${featureId} is enabled.`
            });
            return;
        }

        throw error.create({
            name: 'INSTALLATION_ERROR',
            message: `Feature ${featureId} must be enabled. Please enable the feature and try again.`
        });
    };

    const beforeInstall = (params) => {
        checkFeatureEnabled('WORKORDERS');

        if (String(params.version) === '2.1') {
            checkFeatureEnabled('MULTICURRENCY');
        }
    };

    const beforeUpdate = (params) => {
        checkFeatureEnabled('WORKORDERS');

        if (String(params.toVersion) === '2.1') {
            checkFeatureEnabled('MULTICURRENCY');
        }
    };

    const afterUpdate = (params) => {
        const fromVersion = String(params.fromVersion);
        const toVersion = String(params.toVersion);

        if (fromVersion !== toVersion) {
            const randomNumber = Math.floor(Math.random() * 10000);

            const accountRecord = record.create({
                type: record.Type.ACCOUNT
            });

            accountRecord.setValue({
                fieldId: 'accttype',
                value: 'Bank'
            });

            accountRecord.setValue({
                fieldId: 'acctnumber',
                value: randomNumber
            });

            accountRecord.setValue({
                fieldId: 'acctname',
                value: `Acct ${toVersion}`
            });

            accountRecord.save({
                enableSourcing: true
            });
        }
    };

    return {
        beforeInstall,
        beforeUpdate,
        afterUpdate
    };
});

General Notices