Download SCA Source Files
To begin locally editing and customizing SuiteCommerce Advanced (SCA), you must first download the source files from the NetSuite File Cabinet.
If you are implementing the Aconcagua Release of SCA or later, the best practice is to use themes and extensions to customize your site. However, if your customizations require access to objects not available using the Extensibility API, you can use the SCA developer tools. You can run the SCA developer tools in parallel with the theme and extension developer tools.
The following information and procedure are valid for SCA 2019.1 and later. If you have SCA release 2018.2 or earlier installed, refer to Download SCA 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 SCA 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 SCA Customizations 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:Unlike earlier releases, Aconcagua and later releases of SCA do not contain HTML and Sass files. So for Aconcagua and later releases of SCA, you must use the theme developer tools to customize the look and feel of your site. See Develop Themes for details. The theme developer tools can be used simultaneously with the SCA developer tools.
To download the SCA source files:
-
Log into your NetSuite account where SCA is installed.
-
Access the File Cabinet at Documents > Files > File Cabinet.
-
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>.
-
Click the name of the .zip file to download it.
-
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.
-
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 SCA. 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 SCA Source Files for Release 2018.2 and Earlier
The following information and procedure are valid for SuiteCommerce Advanced (SCA) 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 SCA SuiteApp, appropriate default touch points are automatically deployed to this implementation. Refer to Deploy SCA Customizations to NetSuite for details.
Important:Unlike earlier releases, Aconcagua and later releases of SCA do not contain HTML and Sass files. So for Aconcagua and later releases of SCA, you must use the theme developer tools to customize the look and feel of your site. See Develop Themes for details. The theme developer tools can be used simultaneously with the SCA developer tools.
To download SCA source files for release 2018.2 and earlier:
-
Log into your NetSuite account where SCA is installed.
-
Access the File Cabinet at Documents > Files > File Cabinet.
-
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>.
-
Click the name of the .zip file to download it.
-
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.
-
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 SCA. If necessary, you can add these files to a version control system.