Deploy Local Source Files to SSP...

TL;DR

This article explains how to deploy local source files to an SSP (SuiteCommerce Advanced) application in NetSuite. After verifying customizations, deploying files is essential for updating websites with these enhancements.

Overview

After testing your SuiteCommerce Advanced (SCA) customizations locally, the next step is to deploy your local source files to the SCA Development SSP application. This process ensures that your customizations are integrated into your website, allowing for real-time updates.

Important Folder Structure

When the SCA bundle is first installed in your NetSuite account, two main types of distributions are created under Commerce > Hosting > Web Site Hosting Files > Live Hosting Files > SSP Applications > NetSuite Inc. - SCA:

Folder Name	Description
Source	Contains the original SSP applications and their supporting files, including a `sources.zip` for local development. All files are locked; do not deploy customizations here.
Development	Holds your customizations post-deployment. This is the target folder for your code.

Steps to Deploy Local Source Files

To deploy your customizations to the NetSuite SSP application, follow these steps:

Open your command line or terminal.
Navigate to your SCA source directory containing the package.json file. Depending on your release version:
- For 2020.1 and later, the directory is SC_xxx within your root source directory (e.g., SC_20.1).
- For 2019.2, it’s located in the *_Live directory (e.g., SC_19.2_Live/).
- For 2019.1 and earlier, use the top-level root directory.
Enter the command to deploy:
```
undefined
```

gulp deploy

1 
2> **Note:** If you are running the **2021.2.1** release or later and have account-specific domains, specify your account number with the command. Refer to the Gulp Command Reference for more information.
3 
44. When prompted, input your authentication information:
5- **Authentication ID:** An ID representing your NetSuite account and role.
6- **Account and Role:** Select the appropriate NetSuite account and role, ensuring you have the necessary permissions, generally provided by the Administrator or SCDeployer roles.
75. Choose:
8- **Live Hosting Files** for folder selection.
9- **NetSuite Inc. - SCA** for Application Publisher.
10- **Development** for the SSP application.
11 
12After these settings are entered, the content of your deploy directories will upload to the NetSuite File Cabinet. This process may take several minutes. Wait until it completes before proceeding.
13 
14> **Note:** On your first deployment, the connection settings are stored in the **.nsdeploy** file. This file can later be edited if you need to change the SSP application.
15 
16### Conclusion
17Following these steps will ensure your local customizations are successfully deployed to the SSP application in NetSuite. This deployment process not only updates your site but also provides a structured environment for managing your configurations effectively.
18 
19## Key Takeaways
20- Deploy local source files to update your SCA development SSP.  
21- Maintain a clear understanding of folder structures: Source vs. Development.  
22- Ensure correct authentication roles for successful deployment.  
23- Utilize Gulp.js commands for effective management of your deployment process.

Frequently Asked Questions (4)

What are the prerequisites for deploying local source files to SSP applications in NetSuite?

To deploy local source files to SSP applications, you need to ensure you have the necessary permissions, typically provided by Administrator or SCDeployer roles. You also need to have your customizations tested and be familiar with your SCA source directory structure.

Where should I deploy my customizations for SuiteCommerce Advanced?

Your customizations should be deployed to the 'Development' folder under 'SSP Applications > NetSuite Inc. - SCA'. This ensures that your updates are managed separately from the original source files, which are locked.

How does the deployment process differ for various release versions of SuiteCommerce Advanced?

For releases 2020.1 and later, deploy from the 'SC_xxx' directory. For 2019.2, use the '*_Live' directory, and for 2019.1 and earlier, deploy from your root directory. If using 2021.2.1 or later with account-specific domains, specify your account number in the command.

What steps should I follow when deploying using the Gulp.js command?

Navigate to your SCA source directory, then run 'gulp deploy'. Enter your authentication ID, select the appropriate NetSuite account and role, and ensure your customizations are uploaded to the correct SSP application folder. Authentication and deployment preferences are stored in the '.nsdeploy' file.

Deploy Local Source Files to SSP Applications in NetSuite

TL;DR

Overview

Important Folder Structure

Steps to Deploy Local Source Files

Frequently Asked Questions (4)

More in Commerce