gin-sfdx-plugin ===============
npm install gin-sfdx-plugingin-sfdx-plugin
===============








* Debugging your plugin
``sh-session`
$ npm install -g gin-sfdx-plugin
$ sfdx COMMAND
running command...
$ sfdx (-v|--version|version)
gin-sfdx-plugin/1.1.1 darwin-x64 node-v10.16.3
$ sfdx --help [COMMAND]
USAGE
$ sfdx COMMAND
...sfdx gin:bourne:generateconfigfile [-f
* [](#sfdx-ginbournegenerateconfigfile--f-filepath--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:bourne:generatecustommetadata [-f
* [](#sfdx-ginbournegeneratecustommetadata--f-filepath---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:cpq:configure [-u
* [](#sfdx-gincpqconfigure--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:sharing:suspend [-s
* [](#sfdx-ginsharingsuspend--s-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:sharing:waitready [-t
* [](#sfdx-ginsharingwaitready--t-minutes--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:source:trigger [-t
* [](#sfdx-ginsourcetrigger--t-string--m-string--o-string--h-string--v-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:user:activateusers -f
* [](#sfdx-ginuseractivateusers--f-filepath--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:user:assignpsg -f
* [](#sfdx-ginuserassignpsg--f-filepath--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:user:assignpsl [-f
* [](#sfdx-ginuserassignpsl--f-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:user:create -p
* [](#sfdx-ginusercreate--p-string--e-string--a--d-string--r-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)sfdx gin:user:resetpassword -t
* [](#sfdx-ginuserresetpassword--t-string--o-string--n-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
Generates Bourne Config file based on Custom Metadata Type Records on the org
`
USAGE
$ sfdx gin:bourne:generateconfigfile [-f
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-f, --bournefile=bournefile [default:
./scripts/cpq-export-template.json]
file name to generate
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:bourne:generateconfigfile"
config file generated
`
_See code: lib/commands/gin/bourne/generateconfigfile.js_
Waits until all Permission Set Groups are updated
`
USAGE
$ sfdx gin:bourne:generatecustommetadata [-f
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-f, --bournefile=bournefile [default:
./scripts/cpq-export-template.json]
file path to generate CMT from
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:bourne:generatecustommetadata
custom metadata generated
`
_See code: lib/commands/gin/bourne/generatecustommetadata.js_
Suspend/Enable sharing calculation
`
USAGE
$ sfdx gin:cpq:configure [-u
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:cpq:configure -u username
`
_See code: lib/commands/gin/cpq/configure.js_
Suspend/Enable sharing calculation
`
USAGE
$ sfdx gin:sharing:suspend [-s
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-s, --scope=sharingRule|groupMembership [default: sharingRule] scope...
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:sharing:suspend"
Sharing calculations suspended
`
_See code: lib/commands/gin/sharing/suspend.js_
Waits until all Permission Set Groups are updated
`
USAGE
$ sfdx gin:sharing:waitready [-t
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-t, --timeout=timeout [default: [object Object]] During in
minutes before command fails
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:sharing:waitReady"
all permission set groups were successfully updated
`
_See code: lib/commands/gin/sharing/waitready.js_
Code generation for Migration ids metadata
`
USAGE
$ sfdx gin:source:trigger [-t
[--apiversion
OPTIONS
-h, --triggerhnddir=triggerhnddir [default:
force-app/main/default/classes/adapt
er/trigger-handler] output directory
for trigger handlers
-m, --metadatadir=metadatadir [default:
force-app/main/default/customMetadat
a] output directory for custom
metadata records
-o, --objectdir=objectdir [default:
force-app/main/default/objects]
output directory for objects
-t, --triggerdir=triggerdir [default:
force-app/main/default/triggers]
output directory for triggers
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
-v, --targetdevhubusername=targetdevhubusername username or alias for the dev hub
org; overrides default dev hub org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:source:trigger
`
_See code: lib/commands/gin/source/trigger.js_
Acitvates Users based on User Names specified in the file
`
USAGE
$ sfdx gin:user:activateusers -f
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-f, --permissionfile=permissionfile (required) [default:
./data-migration/psa.json] file with
permission set assignments
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
DESCRIPTION
The file format:
{
"userName": "Tom Sanders",
"groupName": "AwesomeAdmin"
}
EXAMPLE
$ sfdx gin:user:activateusers -f ./file/path.json -u target_org"
`
_See code: lib/commands/gin/user/activateusers.js_
Inserts Permission Set Groups to Users based on User Names specified in the file
`
USAGE
$ sfdx gin:user:assignpsg -f
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-f, --permissionfile=permissionfile (required) [default:
./data-migration/psa.json] file with
permission set assignments
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
DESCRIPTION
The file format:
{
"userName": "Tom Sanders",
"groupName": "AwesomeAdmin"
}
EXAMPLE
$ sfdx gin:user:assignpsg -f ./file/path.json -u target_org"
`
_See code: lib/commands/gin/user/assignpsg.js_
Inserts CPQ Permission Set License to Users
`
USAGE
$ sfdx gin:user:assignpsl [-f
trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-f, --userfilter=userfilter filter string for users
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:user:assignpsl -u target_org"
`
_See code: lib/commands/gin/user/assignpsl.js_
Creates user
`
USAGE
$ sfdx gin:user:create -p
[--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-a, --generateuniqusername Generate a unique user name
-d, --usernamedomain=usernamedomain [default: globalinter.net] UserName
domain. E.g globalinter.net
-e, --permissionsetnames=permissionsetnames (required)
PermissionSet/PermissionSetGroup
names
-p, --profilename=profilename (required) Profile name
-r, --rolename=rolename Role name
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:user:create --profilename Sales --permissionsetnames "Marketing, Sales" --roleName="SVP Manager"
`
_See code: lib/commands/gin/user/create.js_
Suspend/Enable sharing calculation
`
USAGE
$ sfdx gin:user:resetpassword -t
[--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
OPTIONS
-n, --password2=password2 [default: GinTest@0@2!] New password
-o, --password1=password1 [default: GinTest@0@2!1] Temporary
password
-t, --testusername=testusername (required) username to reset
password
-u, --targetusername=targetusername username or alias for the target
org; overrides default target org
--apiversion=apiversion override the api version used for
api requests made by this command
--json format output as json
--loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
this command invocation
EXAMPLE
$ sfdx gin:user:resetpassword -t testuser@example.test -u targetorg@org.test
`
_See code: lib/commands/gin/user/resetpassword.js_
directory of this plugin is a launch.json config file, which allows you to attach a debugger to the node process when running your commands.To debug the
hello:org command:
1. Start the inspector
If you linked your plugin to the sfdx cli, call your command with the dev-suspend switch:
`sh-session
$ sfdx hello:org -u myOrg@example.com --dev-suspend
`
Alternatively, to call your command using the bin/run script, set the NODE_OPTIONS environment variable to --inspect-brk when starting the debugger:
`sh-session
$ NODE_OPTIONS=--inspect-brk bin/run hello:org -u myOrg@example.com
``2. Set some breakpoints in your command code
3. Click on the Debug icon in the Activity Bar on the side of VS Code to open up the Debug view.
4. In the upper left hand corner of VS Code, verify that the "Attach to Remote" launch configuration has been chosen.
5. Hit the green play button to the left of the "Attach to Remote" launch configuration window. The debugger should now be suspended on the first line of the program.
6. Hit the green play button at the top middle of VS Code (this play button will be to the right of the play button that you clicked in step #5).
Congrats, you are debugging!