SuiteCloud Extension for Visual Studio Code

SuiteCloud Extension for Visual Studio Code is part of the SuiteCloud Software Development Kit (SuiteCloud SDK), a set of tools to customize your NetSuite accounts. SuiteCloud Extension for Visual Studio Code allows you to customize your SuiteCloud projects for NetSuite. The available SuiteCloud projects include SuiteApp projects — self-contained, standalone projects that you can publish in the SuiteApp Marketplace for other users to download and install, and Account Customization Projects — intended for customizations on accounts you own, such as your production, development, and sandbox accounts.

Read more about SuiteCloud SDK and SDF in SuiteCloud SDK Overview and SuiteCloud Development Framework Architecture.

Installation Prerequisites

The following software is required to work with SuiteCloud Extension for Visual Studio Code:

• Oracle JDK version 17
• VS Code version 1.91.1 or higher

Read the detailed list of prerequisites in Installation Prerequisites for SuiteCloud Extension for Visual Studio Code.

Supported Versions

You should use the latest version of the SuiteCloud Extension for Visual Studio Code available in the Marketplace. The table below is informative and correlates extension versions in the Marketplace and NetSuite versions.

Installing SuiteCloud Extension for Visual Studio Code

To install SuiteCloud Extension for Visual Studio Code, follow these steps:

1. Launch Visual Studio Code and select the Extensions icon in the Activity Bar.
2. In the search field, enter SuiteCloud Extension for Visual Studio Code.
3. Click Install.
4. Restart Visual Studio Code after installation.

See more details about installation in Installing and Setting Up SuiteCloud Extension for Visual Studio Code.

Getting Started

How to Trigger the Command Palette

Interact through the Command Palette to use SuiteCloud Extension for Visual Studio Code. To trigger it, click View > Command Palette or use the relevant shortcut:

• Ctrl+Shift+P if you are using Windows or Linux.
• Cmd+Shift+P if you are using Mac OS.

How to Work with a SuiteCloud Project

To start working with a SuiteCloud project, you can do any of the following actions:

1. Create a SuiteCloud project. To do this, open the Command Palette, enter SuiteCloud and, from the dropdown list, select SuiteCloud: Create Project.
2. Open a SuiteCloud project. To do this, go to File > Open Folder... and select the root folder of your SuiteCloud project.

How to Work with Multiple SuiteCloud Projects

To add a SuiteCloud project to an already opened Visual Studio Code window, go to File > Add Folder To Workspace ... and select the root folder of your SuiteCloud project. This lets you work with multiple SuiteCloud projects at the same time.

Making a File Active in the Editor

For the extension to detect the working SuiteCloud project and run any command against it, you first need to select a file from the current workspace to make it active in the editor.

Setting Up an Account

To start using your NetSuite accounts with SuiteCloud Extension for Visual Studio Code, you first need to set them up. The account set up includes adding an account to the extension and setting it as default. As a prerequisite to adding an account, a SuiteCloud project must be open in Visual Studio Code.

To add an account, follow these steps:

1. Open the Command Palette.

2. Enter SuiteCloud and from the dropdown list, select SuiteCloud: Set Up Account.

3. Once the dropdown list is shown, select New authentication ID.

4. Once the dropdown list is shown, select one of the following options:

   • Browser-based authentication
   • Machine-to-machine authentication

5. In the text field, enter an authentication ID.

6. If you selected the browser-based authentication, press Enter to confirm your NetSuite domain and follow the instructions in the browser prompt. If you selected machine-to-machine authentication, do the following:

   • Enter the account ID.
   • Enter the certificate ID.
   • Select the private key file in the prompted file explorer.

   Your account is successfully set up.

To set an account as default for a project, follow these steps:

1. Open the Command Palette.
2. Enter SuiteCloud and from the dropdown list, select SuiteCloud: Set Up Account.
3. From the dropdown list, select the authentication ID of the account you want to set as default. The selected account is set as default for the project.

SuiteCloud Commands

The following SuiteCloud commands are available through the Command Palette:

To read more about what you can do with SuiteCloud Extension for Visual Studio Code, visit SuiteCloud Extension for Visual Studio Code Usage.

Using SuiteCloud Extension for Visual Studio Code with SuiteCloud CLI for Node.js

SuiteCloud CLI for Node.js is compatible with your Visual Studio Code integrated terminal, so you can run SuiteCloud CLI for Node.js commands directly there, independently from VS Code. To read more about it, visit SuiteCloud CLI for Node.js.

Release Notes & Documentation

To read the 2024.2 NetSuite's release notes and documentation, check the following sections of NetSuite's Help Center:

• Read the release notes for NetSuite 2024.2 in SuiteCloud SDK Release Notes.
• Read the latest updates under SuiteCloud SDK in the Help Center Weekly Updates.
• Read the SuiteCloud Extension for Visual Studio Code documentation in NetSuite's Help Center.

Contributing

SuiteCloud Extension for Visual Studio Code is an open source project. Pull Requests are currently not being accepted. See Contributing for details.

License

Copyright (c) 2022, 2023, 2024 Oracle and/or its affiliates The Universal Permissive License (UPL), version 1.0. See License for details.

By installing SuiteCloud Extension for Visual Studio Code, you are accepting the installation of the SuiteCloud SDK dependency under the Oracle Free Use Terms and Conditions license.