SCA on a Local Server

This topic applies to

Applies to

SuiteCommerce Advanced

View a Related Video

In addition to deploying to NetSuite, you can also run SuiteCommerce Advanced on a local server to quickly test changes you make to the application. The local server is installed with the as part of the Node.js installation and uses the Express web framework. When you enter the gulp local command, the server starts automatically.

When the server starts, Gulp.js initializes watch tasks that listen for changes to files in the JavaScript, Templates, or Sass directories. When you save changes to a file, gulp automatically recompiles the source files and updates the LocalDistribution directory. Gulp also outputs a message to the console when an update occurs.

The local server is primarily used to test frontend changes. When accessing the SuiteCommerce Advanced application on the local server, backend services used by the application are run on NetSuite. Therefore, any local changes you make to services or backend models must be deployed to NetSuite before they are accessible to the local server. Also, you must deploy any changes to services or backend models to NetSuite in order for them to work on the local server.

Note

If you modify the distro.json file to add additional files or modules, you must restart your local server to see changes.


To deploy to the local server:

  1. Go to your command line or terminal window.

  2. Enter the following command from the top-level directory of the SuiteCommerce Advanced source files (the same directory used during the developer tools installation):

    gulp local

    If this is the first time you are running gulp local in this directory, this command creates a sub directory called LocalDistribution. It then compiles the source files and outputs them to this directory.

  3. Navigate to the local version of the application using one of the following URLs:

    • Shopping: http://<DOMAIN_NAME>/c.<ACCOUNT_ID>/<SSP_APPLICATION>/shopping-local.ssp

    • My Account: http://<DOMAIN_NAME>/c.<ACCOUNT_ID>/SSP_APPLICATION/my_account-local.ssp

    • Checkout: http://<DOMAIN_NAME>/c.<ACCOUNT_ID>/SSP_APPLICATION/checkout-local.ssp

    In the above URL patterns, you must replace the following variables with values for your specific environment:

    • DOMAIN_NAME — replace this value with the domain name configured for your NetSuite website record.

    • ACCOUNT_ID — replace this value with your NetSuite account ID.

    • SSP_APPLICATION — replace this value with the URL root that you are accessing.

    The URLs you use should be similar to the following examples:

    http://www.mysite.com/c.123456/my-sca-ssp/shopping-local.ssp
    http://www.mysite.com/c.123456/my-sca-ssp/my_account-local.ssp
    http://www.mysite.com/c.123456/my-sca-ssp/checkout-local.ssp

    Note

    When accessing the secure checkout domain using HTTPS on the local server, you must use a different URL. See Secure HTTP (HTTPS) with the Local Server for more information.


When the local server is running, Gulp.js automatically compiles the application when you save any changes within the Modules directory. You can refresh your browser to see the changes.