Deploying to a NetSuite Sandbox for Testing and Development

Deploy your applications to a NetSuite sandbox for safe testing and development, enhancing workflow without affecting production data.

·2 min read·View Oracle Docs

Deploying to a NetSuite sandbox is a crucial step in testing applications and customizations before making changes to your production account. This allows developers to ensure the quality and stability of their deployments without risking any disruption to live operations.

Why Use a Sandbox for Deployment?

Sandbox accounts are mirrors of your production environment, making them ideal for:

  • Testing new features and customizations
  • Troubleshooting existing implementations
  • Training personnel on new processes
  • Safely experimenting with third-party integrations

Actions taken in a sandbox do not affect the production environment, ensuring a safe space for development. However, it is essential to follow specific deployment procedures to avoid issues.

Steps to Deploy to a Sandbox Account

Follow these steps to successfully deploy your application to a sandbox account:

  1. Prepare Your Environment
    Open your command line or terminal window.

  2. Execute Deployment Command
    From the top-level directory of your source files, use one of the following commands based on your development environment:

    • For theme development:
      bash
      gulp theme:deploy
    • For extension development:
      bash
      gulp extension:deploy
    • For Core SuiteCommerce Advanced development:
      bash
      gulp deploy

    On first deployment, this will create a DeployDistribution folder that will house the compiled source files.

    Important Note:
    If you have previously deployed to a different account, delete the .nsdeploy file first to enter the sandbox login credentials.

  3. Enter Authentication ID
    When prompted, input the authentication ID associated with your sandbox account.

  4. Select Sandbox and Role
    In NetSuite, choose the appropriate sandbox account and required role. Click Allow to generate your authentication token and secret.

    Permissions Warning:
    Ensure the role you select has the necessary permissions to deploy. In most cases, the Administrator and SCDeployer roles will suffice. For details on creating custom roles, refer to the guide on Developer Tool Roles and Permissions.

  5. Upload Files
    Navigate to your Web Site Hosting Files, selecting the appropriate path:

    • For SuiteCommerce:
      Web Site Hosting Files > Live Hosting Files > SSP Applications > NetSuite Inc. - SCS
    • For SuiteCommerce Advanced:
      Web Site Hosting Files > Live Hosting Files > SSP Applications > NetSuite Inc. - SCA <version> Development

After setting up the connection, the contents from your DeployDistribution directory will upload to the NetSuite File Cabinet of your sandbox account. Monitor the process completion, as it may take a while depending on file sizes.

Conclusion

Deploying to a sandbox effectively protects your production environment while allowing extensive testing and development. This structured approach ensures you can innovate freely in a controlled setting, thus maintaining operational integrity.

Source: This article is based on Oracle's official NetSuite documentation.

Frequently Asked Questions (4)

What steps should I follow to deploy an application to a NetSuite sandbox?
To deploy your application to a NetSuite sandbox, you need to prepare your environment, execute the appropriate deployment command, enter your authentication ID, select the sandbox and role, and upload your files to the correct location in the NetSuite File Cabinet.
What happens if I accidentally deploy to the wrong sandbox account?
If you have previously deployed to a different account, you need to delete the '.nsdeploy' file to ensure you're prompted for the correct sandbox login credentials.
Do I need specific permissions to deploy to a NetSuite sandbox?
Yes, the role selected for deployment must have necessary permissions. Normally, Administrator and SCDeployer roles have sufficient permissions; custom roles must be configured appropriately.
Is there a command difference when deploying themes versus extensions in NetSuite sandbox?
Yes, different 'gulp' commands are used based on your development type: 'gulp theme:deploy' for themes and 'gulp extension:deploy' for extensions.
Source: Deploy to a NetSuite Sandbox Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

More in Sandbox

View all Sandbox articles →