Download the Source Files

This topic applies to

Applies to

SuiteCommerce Advanced

 

After installing Node.js and Gulp.js, you have completed the basic installation requirements for the developer tools. To begin locally editing and customizing SuiteCommerce Advanced, you must first download the source files from the NetSuite file cabinet.

Note

The following information and steps are valid for SuiteCommerce Advanced release 2019.1 and later. If you have SuiteCommerce Advanced release 2018.2 or earlier installed, refer to Download Source Files for Release 2018.2 and Earlier for instructions specific to your release.


Your File Cabinet includes the following implementations:

  • Source – This implementation contains all of the original installation files. It is locked to prevent changes. The Source implementation can be used for creating diffs against your customizations to troubleshoot issues.

  • Development – The Development implementation is where you begin your work.

    In the _Sources directory of the Development implementation, there is a zipped source file available. Download this file to your local development environment to begin working on your customizations and to create distribution files. When you install the SuiteCommerce Advanced SuiteApp, appropriate default touch points are automatically deployed to this implementation. After deployment to a website, your site is available at the domain defined for that site. Refer to Deploy to NetSuite for details.

  • Source2 – This implementation contains the original installation files for the SCA source modules that have been migrated to SuiteScript 2.0. For more information, see Commerce Migration to SuiteScript 2.0.

  • Development2 – The Development2 implementation is where touch points for customizations to SuiteScript 2.0 modules are automatically deployed. For more information, see Commerce Migration to SuiteScript 2.0.

    Important

    With the Aconcagua release of SuiteCommerce Advanced, these implementations no longer contain HTML and Sass files. To customize the look and feel of your site, you must use the theme developer tools. See Theme Developer Tools for details. These tools can be used simultaneously with the SCA developer tools.


To download the SuiteCommerce Advanced source files:

  1. Login to your NetSuite account where SuiteCommerce Advanced is installed.

  2. Access the File Cabinet at Documents > Files > File Cabinet.

  3. In the File Cabinet, go to Web Site Hosting Files > Live Hosting Files > SSP Applications > [SSP Application] > Development > _Sources.

    The SSP Application for SCA is named: NetSuite Inc. - SCA <release_name>.

  4. Click the name of the .zip file to download it.

  5. Extract the .zip file to the directory where you want to store your source files.

    Rename the top-level directory or accept the default name. However, do not change the names of subfolders, files, or their structure within this directory.

  6. To complete your development environment set up, follow the procedure in Install Additional Files in the Source Directory.

After completing these steps, you can begin editing or customizing SuiteCommerce Advanced. If necessary, you can add these files to a version control system.

Note the following:

  • The source files for SuiteCommerce Advanced 2019.1 and earlier are JavaScript files with .js filename extensions. The source files for SuiteCommerce Advanced 2019.2 and later are TypeScript files with .ts filename extensions. For more information about TypeScript, see TypeScript.

  • Generally, you only need to download the source files the first time you set up your local development environment. You may also need to download the source files to ensure you have the correct base version or the most recent version after a bundle update.

Download Source Files for Release 2018.2 and Earlier

The following information and steps are valid for SuiteCommerce Advanced release 2018.2 and earlier.

Your File Cabinet includes the following implementations:

  • Source – This implementation contains all of the original installation files. It is locked to prevent changes. In the _Sources directory of the Source implementation, there is a zipped source file available. Download this file to your local development environment to begin working on your customizations and to create distribution files. The Source implementation can also be used in the future for creating diffs against your customizations to troubleshoot issues.

  • Development – The Development implementation is where you deploy your customizations. When you install the SuiteCommerce Advanced SuiteApp, appropriate default touch points are automatically deployed to this implementation. Refer to Deploy to NetSuite for details.

    Important

    With the Aconcagua release of SuiteCommerce Advanced, these implementations no longer contain HTML and Sass files. To customize the look and feel of your site, you must use the theme developer tools. See Theme Developer Tools for details. These tools can be used simultaneously with the SCA developer tools.


To download the source files for release 2018.2 and earlier:

  1. Login to your NetSuite account where SuiteCommerce Advanced is installed.

  2. Access the File Cabinet at Documents > Files > File Cabinet.

  3. In the File Cabinet, go to Web Site Hosting Files > Live Hosting Files > SSP Applications > [SSP Application] > Source > _Sources.

    The SSP Application for SCA is named: NetSuite Inc. - SCA <release_name>.

  4. Click the name of the .zip file to download it.

  5. Extract the .zip file to the directory where you want to store your source files.

    Rename the top-level directory or accept the default name. However, do not change the names of subfolders, files, or their structure within this directory.

  6. Install additional files to complete your development environment set up as described in Install Additional Files in the Source Directory.

After completing these steps, you can begin editing or customizing SuiteCommerce Advanced. If necessary, you can add these files to a version control system.