NetSuiteSDF Extension

Notice

Beginning with 2020.2, you will need to upgrade your sdfcli version. You can use homebrew to do this, or follow the NetSuite help docs.

You will also need to upgrade to Java 11. This project officially supports Amazon Corretto (https://corretto.aws/) instead of OpenJDK or the official Java SDK.

Also starting with 2020.2, this project no longer supports username and password authentication for the plugin. You will need to use the save token option in the command palette to setup your environments. Make sure to add authid in your .sdfcli.json config file.

Here's a sample .sdfcli.json:

{
  "projectName": "SDF",
  "environments": [
    {
      "name": "SANDBOX 1",
      "account": "123456_SB1",
      "url": "system.netsuite.com",
      "role": 3,
      "email": "your@email.com",
      "authid": "DEV - ADMINISTRATOR"
    }
  ]
}

Introduction

This is a Visual Studio Code wrapper around the NetSuite SDF command-line interface. It also provides a series of defaults for the SDF CLI to make utilizing the CLI more user-friendly.

Inspiration

This is a port of the functionality provided by tjtyrrell's Sublime SDF plugin (https://github.com/limebox/sublime-sdf). And we are borrowing the work he did in getting the Windows and Mac SDFCLI installers working.

Features

• Currently updated to work with 2020.2.
• Wraps SDF CLI commands
• Environment (Sandbox, Production, etc.) selector
• Output window integrated with VS Code
• Now webpacked to speed up VS Code load time
• Quick Deploy option available in Extension Preferences

Status

All commands can be found with the SDF prefix in the Command Palette (Win: Ctrl+Shift+P, Mac: Cmd+Shift+P).

SDF CLI Commands

Command	Implemented	Shortcut
adddependencies	✔
deploy	✔
importbundle
importconfiguration
importfiles	✔
importobjects	✔
issuetoken	✔
listbundles	✔
listconfiguration	✔
listfiles	✔
listmissingdependencies	✔
listObjects	✔
preview	✔
project	(Handled by extension)
revoketoken	✔
savetoken	✔
update	✔
updatecustomrecordwithinstances	✔
validate	✔

VS Code Commands

Command	Description
Refresh Config	Force the extension to re-read .sdfcli.json
resetPassword	Enter password for use with environment
selectEnvironment	Select active environment from list in .sdfcli.json. If only one, will automatically select it.
sync	Grabs all available customizations from NetSuite that is normally possible by the plugin.
remove folders	Removes all created folders from the current directory. Used in conjunction with sync.

Hotkeys

Note: All hotkeys are preceded by Ctrl-; on Windows or Cmd-; on Mac. For example, if I wanted to run the command addDependencies on a Mac, I would press Cmd-;, then press a. <p> below stands for that OS-specific prefix. These commands are case sensitive.

Command	Shortcut
addDependencies	<p> a
addFileToDeploy	<p> +
deploy	<p> d
importBundle	<p> d
importFiles	<p> F
importObjects	<p> O
issueToken	<p> t
listBundles	<p> b
listConfiguration	<p> c
listFiles	<p> f
listMissingDependencies	<p> m
listObjects	<p> o
preview	<p> p
refreshConfig	<p> r
revokeToken	<p> R
saveToken	<p> T
selectEnvironment	<p> s
update	<p> u
updateCustomRecordWithInstances	<p> U
validate	<p> v
resetPassword	<p> P

Quick Deploy

Enable this feature in VS Code settings. Currently it is opt-in, as it is a beta feature.

If enabled, when a Deploy is triggered, the files and objects listed in the deploy.xml will be copied to a subdirectory along with the manifest.xml, and the deploy will be triggered from there.

To facilitate more rapid development, there is a command to add a file directly to your deploy.xml. Either through selecting it in the File Browser, right-clicking, and selecting Add File to Deploy.xml, or by running the command while the file is being edited to add it.

Pros:

• Avoids the node_modules issue
• Allows for larger SDF projects
• Reduction in deploy time from 8-10 minutes down to 8-10 seconds

Cons:

• Untested on Windows

ToDo

Command	Description
New Project	Will generate SDF project file structure in the same manner as sdfcli-createproject
Update .sdf	Automatically update .sdf with active environment information

Installation

1. Install SDFCLI. Either use the SDF documentation or tjtyrrell's brew or chocolatey. I recommend tjtyrell's.

Windows

Install via Chocolatey

choco install sdfcli # This installs Java 8 and Maven 3.5

Mac

Install via Homebrew

Warning: the Brew Cask has been renamed. If you used it previously as sdfcli, please untap the cask and uninstall:

brew untap limebox/netsuite
brew uninstall sdfcli

Install SDFSDK:

brew cask install corretto
brew install limebox/netsuite/sdfsdk

2. The plugin is activated when a project is opened that has a .sdf or .sdfcli.json file in the root directory. So open a SDF project folder that contains a .sdf file.

3. If the Extension is activated, you should see a SDF button in the bottom left status bar. Click the button to open up the Select Environment inputs. This will generate a .sdfcli.json in your root directory of your project.

4. Fill in your environments that you want to be able to switch between inside of the extension inside of the .sdfcli.json.

5. Hit Ctrl+Shift+P for Windows, or Cmd+Shift+P to bring up the command palette again, and type SDF to see all the options.