Skip to content

In this step, you will:

  • Prepare your Vault environment for the Getting Started
  • Learn how to deploy Vault configuration & custom code to Vault with a VPK

As the first step in the Getting Started, you need to configure your Vault with the provided SDK record trigger. Besides the custom code for the record trigger itself, the sample trigger runs on the vSDK Hello World object, which you must also add to your Vault. Instead of manually configuring your Vault, you will deploy a prepackaged set of components called a Configuration Migration Package, or VPK (.vpk). This VPK is included in the downloaded vSDK Hello World project, and you can import this into Vault in just a few clicks.

In the future, you can also use this VPK process to copy the configuration of your production environment and replicate it in your sandbox Vault. You can learn more about Configuration Migration Packages (VPKs) in Vault Help.

  1. Log in to your Vault and navigate to Admin > Deployment > Inbound Packages.
  2. Click Import.
  3. Locate and select the deploy-vpk/vsdk-helloworld-components.vpk file in your downloaded or cloned project folder. The import should take less than a minute to complete. Refresh the page to find the imported package.
  4. From the Actions menu, which looks like an ellipsis icon (), select Review & Deploy. Vault displays a list of all components in the package.
  5. Click Next.
  6. On the confirmation page, review and click Finish.
  7. In the warning dialogue that appears, click Continue to start the deployment. This warning appears because the provided VPK uses the replace_all Vault Java SDK deployment option, which ensures your getting started environment will not have any conflicting configuration. You can learn more about replace_all and other Vault Java SDK deployment options in the SDK documentation. When the deployment is complete, you will receive a notification. Deployment should take less than 5 minutes.
  8. Once deployment is complete, you need to verify that the VPK imported successfully by locating the new Vault objects and sample record trigger in your Vault. To find these objects, navigate to Business Admin > Objects and search for Hello World. If the vSDK Hello World (vsdk_hello_world__c) and vSDK Hello World Child (vsdk_hello_world_child__c) objects exist here, the VPK imported the Vault objects successfully!
    The Hello World object in the Vault UI.The Hello World object in the Vault UI.
  9. To verify the VPK imported the sample record trigger, navigate to Admin > Configuration > Record Triggers. Verify that a trigger named com.veeva.vault.custom.triggers.HelloWorld exists here. If the HelloWorld trigger exists, your Vault setup is complete! You can learn more about the information and options available on this page in Vault Help, such as how to download deployed code and how to turn deployed code on and off.
    Record triggers viewed in the Vault UI in Admin > Configuration > Record Triggers.Record triggers viewed in the Vault UI in Admin > Configuration > Record Triggers.