netsuite-cabinet
v1.0.1
Published
Upload and download files from netsuite.
Downloads
4
Maintainers
Readme
netsuite-cabinet
Upload/download files to a netsuite account, using the included restlet.
Forked from https://github.com/suiteplus/nscabinet
PS: This is actually also a gulp plugin.
Required
- node.js 8+
Quick start
npm install netsuite-cabinet
Install the nscabinet restlet bundle in your netsuite account (or manually create the script using the file in the repo) *
Create a
nsconfig.json
file in the root of you project with at least email , password, account, script number and deployment number.Use it with gulp or with the CLI (see CLI section below)
var nscabinet = require('nscabinet');
gulp.src('myProject/dist/**/*.js').pipe(nscabinet({ rootPath : '/Templates' }));
(*) if installing from the bundle, the minor version must match your current version of nscabinet
Accepted input ways
The parameters may be stored in config files, in environment variables, or passed directly as object.
For environment variables, prefix the options with "NSCONF_" and write in uppercase.
The following priority is taken for each parameter (using _.extend
)
Options argument
nscabinet(options)
./nsconfig.json
, then../nsconfig.json
, up to 5 levels.~/.ns/nsconfig.json
Environment variables
For instance, let's say you call nscabinet({ account : '1234' })
. Even if no e-mail is supplied, we also look up in the sources listed above for it. You may set a nsconfig.json
for the project without the password, setting the latter machine-wise using an environment variable.
Common parameters
The following parameters are common through most of the methods:
Connection
realm
defaults tonetsuite.com
. (No longer used, now using account specific domain based on account #)role
defaults to the account's default role.account
email
password
script
deployment
defaults to 1.conffile
overrides defaultnsconfig.json
file name, allowing multiple project setting.
Path
rootPath
sets the root path on the server. Defaults to/SuiteScripts
. Must begin with/
.
Example: Upload file with path img/image.jpg
to rootPath /Templates
will "upsert" the file
onto '/Templates/img/image.jpg'.
Token Based Authentication
consumerKey
consumerSecret
token
tokenSecret
Setup:
- Enable Token-based Authentication (Enable Features > SuiteCloud > Manage Authentication)
- Create an integration record to generate a consumer key and secret
- Generate a user token (must enable a role with User Access Tokens permission - Administrator role cannot be used)
The email and password are ignored when token based authentication is used. (They are still required but can just have placeholder values)
nscabinet.upload
var nscabinet = require('nscabinet') ,
gulp = require('gulp') //or just vinyl-fs
gulp.src('foo.js')
.pipe(nscabinet({
email : '[email protected]' ,
password : '123456' ,
account : '123456' ,
realm : 'sandbox.netsuite.com' ,
role : 3 ,
rootPath : '/SuiteScripts/MyProject'
script : 95 ,
deployment : 1
}))
isonline
(boolean) lets you set the uploaded files to be avaliable without login.flatten
all files are uploaded to the root path, regardless of their source path.
nscabinet.download( files , [opts] )
nscabinet.download(['MyProject/*.js','/Web Site Hosting Files/My Site/*.html'])
.pipe(vinylfs.dest('local'))
files
file selector (one or many).*
is accepted on the file part. The restlet then runs a file search by name in which*
is replaced with%
.Paths are also relative to
opts.rootPath
. If a file selector begins with/
, files will be queried by absolute path in netsuite, but saved locally inside thecabinet_root
folder.If a path has
/**/
, a recursive search will be done. This can be used to search just by file name, regardless of path.(PS: While the syntax is similar, don't expect full glob funcionality. It's not a glob!)
opts
Common options.
nscabinet.url ( file : string , [opts] ) : Promise[string]
Get the url (internal or external) of a cabinet file. Returns a promise. Useful for email campaign stuff.
Options: receives the ones which make sense here (ex: rootPath, realm, etc...) in the same fashion.
nscabinet.url('emails/img/header.jpg').then( url => {
cheerio_img.attr(src,url);
return cheerio_doc.html();
});
CLI
npm install -g nscabinet
$ nscabinet u "file.txt" --rootpath "/SuiteScripts/MyProject"
$ nscabinet u "file.txt" -p "/SuiteScripts/MyProject"
$ nscabinet u "file.txt"
$ nscabinet d "remote.txt" --rootPath "/Downloads"
$ nscabinet d "remote.txt" -p "/Downloads"
$ nscabinet d "remote.txt"
Takes in the same arguments (always lowercased).
Encase path parameters in string quotes (avoids bash expansion).
As usual, the arguments are defaulted from nsconfig.json
.
Sent file paths are taken relative to the config file path. Ex:
$ nscabinet u file.txt
Uploading file.txt to /SuiteScripts
$ cd Views
$ Views nscabinet u view.html
Uploading Views/view.html to /SuiteScripts
Contributing
- If you add new funcionality, also add a new test!
At the time tests are run locally. To set up the tests:
Install the restlet in an available account;
Set up nsconfig.json, pointing to that account; Don't forget to set a rootPath to where the tests will play around and create its lots of files;
Run 'gulp'