Skip to content

In this step, you will:

  • Connect your Vault to the Vault Java SDK Debugger

Before deploying code changes, you may want to test it first through the Debugger. Once connected to your Vault, the Debugger allows you to run code locally on your machine without enabling the code for all users in your Vault. This allows you to test and troubleshoot code locally before deploying finished code.

You must have the standard Vault Owner security profile to run the Debugger. Learn more in related permissions.

To set up the debugger in IntelliJ:

  1. Navigate to Run > Edit Configurations....
  2. Click Add New Configuration and select Application from the drop-down.
  3. Give your configuration a Name. For example, Vault Java SDK Debugger.
  4. Add the following data to your new configuration:

Main Class: com.veeva.vault.sdk.debugger.SdkDebugger. The SDK Debugger Main Class should auto-complete as you begin to type. If it does not autocomplete, or if your IDE cannot recognize this Main Class, you may have completed a previous step incorrectly.

Program Arguments:

  • -h {host name}: The host name of your Vault. For example, myvault.veevavault.com. You should not include https://.
  • -u {user name}: Your Vault user name, which you use to log in.
  • -p {password}: Your Vault password.
  • Optional: -s {sessionId}: You can choose to authenticate using other tools, such as a browser or PostmanTM, and provide an authenticated sessionId in this switch instead of providing -u and -p.
  • Optional: -?: Display debugger help and exit.
Debugger program arguments configuration.Debugger program arguments configuration.
  1. Click Apply and then OK.
  2. Click Run to run the project and attach the debugger to your Vault.

If your connection to the debugger is successful, you will see a console message stating Welcome to the Vault Java SDK Debugger and additional information such as your user, host, and debugger version.

You may encounter the following errors when running the debugger: