QuoteWerks Commands

<< Click to Display Table of Contents >>

Navigation:  QuoteWerks Help > CHAPTER 6: Customizing QuoteWerks > Settings Manager >

QuoteWerks Commands

Important:   Warning! This information is for advanced users only.  Improper settings changes can cause serious issues.  Only make changes if familiar with these settings and what needs to be changed.  Additionally, most settings modified in this window will require a restart of QuoteWerks to take effect.  Please contact tech support before proceeding with any changes.

The Run QuoteWerks Command feature enables users to update settings through command lines, rather than having to update individual users one at a time.  QuoteWerks technical support can provide these commands for users to easily make settings changes rather than explaining the steps to set these settings through the normal user interface.

Also, since multiple commands can be run at the same time, administrators can grab multiple settings and apply them to other users in an automated fashion. QuoteWerks Sales Partners can use these commands to apply standardized customizations to any installation.

Command Syntax


Action: can be SET, GET, or DELETE

Hive: can be SystemSettings, SiteSettings, or UserSettings

Section Name: is the section name like "Defaults"

KeyName: is the key name

KeyValue: is the key value

Command Syntax for UserSettings

When the Hive of UserSettings is used, the syntax changes to include the additional parameter of the UserName


UserName is the QuoteWerks login name. This parameter can also be "&APP_LoggedInUserName". When the SET command is used with this parameter the setting change will be applied to the currently logged in user.


Tip:Right-clicking one one of the values will provide you with the command for setting that key (Copy SET Command).  This is a great way to check syntax and ensure you are updating or removing the correct field AND if you use the delete command on the wrong value you can simply run the SET command to re-add back to the Settings Manager.  If you selected a user setting and you hold down the SHIFT key while clicking on the "Copy SET Command" menu, the actual user name from the setting being copied will be in the SET command. If the SHIFT key is not depressed then the {UserName} parameter of the SET command will be populated with &APP_LoggedInUserName.  You can then save a document with a list of these commands for future use.  



Command Examples

Setting a company message:

If you wanted to set a company message in your system, you would use the following command. Notice the colons (:) separating each parameter and the use of the equal sign (=) to set the value of the field.

1.Click on the [Run QuoteWerks Command] button

2.Type in the command you wish to run.  Use SET, GET, or DELETE followed by a colon, then the table name, the section name, and the key you wish to adjust. For our example, to change the CompanyMessage2 field, the command should look like this: SET:SystemSettings:Company:CompanyMessage2=QuoteWerks is the Premier Quoting and Proposal Solution

3.Once the command has been run, it will include a success or failure message.

4.You can then verify the operation has been completed as well by navigating to the field.

Tip:The Spotlight search at the top of the settings window will enable you to search for specific fields that you want to update or have been updated.  Once you have typed in the spotlight search, simply click the down arrow on your keyboard to see the first result (F3 will work also). The up arrow on the keyboard will go to the previous result (Shift F3 will also work).  The [Remove Non-spotlighted Results from List] button will remove the other settings from view while locating your specific field.

Other Command Examples

If you wanted to use a command on a specific user, you'll need to specify the user's login name.  For example, if you wanted to change the Administrator's default setting to have the QuoteValet Dashboard open when that user logs in, it would look like this:



Note:When running the GET command, the response will be formatted exactly like the SET command so that you can later run the response to SET the value.  For example running: GET:UserSettings:UserConfig:Administrator:AutoOpenQuoteValetDashboardOnStart

would then return:




Or if you wanted to update the default introductory notes for the administrator it would look like this:

SET:UserSettings:UserConfig:Administrator:DefaultIntroduction= Thank you for choosing QuoteWerks as your quoting and proposal solution.

Additionally, multiple commands can be run at once to make it even easier to update multiple settings at by adding the commands to the same command box.   For example if you wanted to update the default layout for the Administrator and have their Active Quotes Panel display by default, it would look like this:


Users can also utilize the %AllUsers% command instead of a specific user name.  This allows you to Set, Get, or Delete a setting for all users in a single command.  For example the command:

SET:UserSettings:UserConfig:%AllUsers%:AutoOpenQuoteValetDashboardOnStart=-1 would update all users to automatically open the QuoteValet Dashboard on the start of QuoteWerks.

You'll receive a confirmation message that the commands have run.