Intro to SuiteScript 2.0 Modules and How to use “N/record”

define(['N/record'], function (record) {
    /**
     * Example script to test the Record module. Copies essential information from an SO and creates a new SO from that info.
     * 
     * Deploy To: Sales Orders
     * @NApiVersion 2.x
     * @NScriptType UserEventScript
     * @author Ben Rogol (SuiteRep)
     */
    var exports = {};

    /**
     * @function afterSubmit Function to be executed after record is submitted to server.
     * @governance XXX
     * 
     * @param {Object} context 
     * @param {Record} context.newRecord  Record as submitted to server
     * @param {Record} context.oldRecord  Record as loaded from server
     * @param {String} context.type  The type of UE with which the record is being accessed (create, copy, edit)
     * 
     * @return {void}
     * @since 2015.2
     */
    function afterSubmit(context) {
        log.debug("context.type", context.type); // If SO is being created, returns "create"; if being edited, returns "edit"
        if (context.type != 'create') { // The script will only run if a SO is being created
            log.debug("Record not being created. Script will not copy record.");
            return; 
        }

        // Retrieving info from original SO
        var date = context.newRecord.getValue({ fieldId: 'trandate' }); // Getting important field values...
        var entity = context.newRecord.getValue({ fieldId: 'entity' });
        var lineCount = context.newRecord.getLineCount({ sublistId: 'item' })

        var items = [];
        var qtys = [];
        var amounts = [];

        for (var i = 0; i < lineCount; i++) { // Getting all the sublist values
            var item = context.newRecord.getSublistValue({
                sublistId: 'item',
                fieldId: 'item',
                line: i
            });
            var qty = context.newRecord.getSublistValue({
                sublistId: 'item',
                fieldId: 'quantity',
                line: i
            });
            var amount = context.newRecord.getSublistValue({
                sublistId: 'item',
                fieldId: 'amount',
                line: i
            });

            items.push(item);
            qtys.push(qty);
            amounts.push(amount);
        }

        // *** USING THE RECORD MODULE ***
        var newSalesOrder = record.create({ // Creating a new SO
            type: record.Type.SALES_ORDER,
            isDynamic: true // Important: Dynamic Mode
        })
        newSalesOrder.setValue({ // Setting the date
            fieldId: 'trandate',
            value: date
        })
        newSalesOrder.setValue({ // Setting the entity (company)
            fieldId: 'entity',
            value: entity
        })

        for (var i = 0; i < items.length; i++) {
            newSalesOrder.selectNewLine({ // Select line to input info to
                sublistId: 'item'
            });
            newSalesOrder.setCurrentSublistValue({ // Set item for line
                sublistId: 'item',
                fieldId: 'item',
                value: items[i]
            });
            newSalesOrder.setCurrentSublistValue({ // Set qty for line
                sublistId: 'item',
                fieldId: 'quantity',
                value: qtys[i]
            });
            newSalesOrder.setCurrentSublistValue({ // Set amount for line
                sublistId: 'item',
                fieldId: 'amount',
                value: amounts[i]
            });
            newSalesOrder.commitLine({ // Commit the line
                sublistId: 'item'
            });
        }

        try {
            var newSalesOrderID = newSalesOrder.save(); // Attempting to save the record
            log.debug("New Sales Order ID", newSalesOrderID)
        } catch (e) {
            log.error("Not able to save new Sales Order - " + e.name, e.message);
        }
    }

    exports.afterSubmit = afterSubmit;
    return exports;
});