Automate Vault CRM Integration Tasks from PowerShell

The CData Cmdlets for Vault CRM are standard PowerShell cmdlets that make it easy to accomplish data cleansing, normalization, backup, and other integration tasks by enabling real-time and bidirectional access to Vault CRM.

PowerShell Cmdlets or ADO.NET Provider?

The Cmdlets are not only a PowerShell interface to Vault CRM, but also an SQL interface; this tutorial shows how to use both to create, retrieve, update, and delete Vault CRM data. We also show examples of the ADO.NET equivalent, which is possible with the CData ADO.NET Provider for Vault CRM. To access Vault CRM data from other .NET applications, like LINQPad, use the CData ADO.NET Provider for Vault CRM.

Once you have acquired the necessary connection properties, accessing Vault CRM data in PowerShell can be enabled in three steps.

You are ready to connect after specifying the following connection properties:

• Url: The host you see in the URL after you login to your account. For example: https://my-veeva-domain.veevavault.com
• User: The username you use to login to your account.
• Password: The password you use to login to your account.

PowerShell

1. Install the module:

   Install-Module VaultCRMCmdlets

2. Connect:

   $vaultcrm = Connect-VaultCRM -User "$User" -Password "$Password" -Server "$Server" -Database "$Database"
   

3. Search for and retrieve data:

   $categoryid = "5"
   $northwindproducts = Select-VaultCRM -Connection $vaultcrm -Table "NorthwindProducts" -Where "CategoryId = `'$CategoryId`'"
   $northwindproducts
   

   You can also use the Invoke-VaultCRM cmdlet to execute SQL commands:

   $northwindproducts = Invoke-VaultCRM -Connection $vaultcrm -Query 'SELECT * FROM NorthwindProducts WHERE CategoryId = @CategoryId' -Params @{'@CategoryId'='5'}
   

ADO.NET

1. Load the provider's assembly:

   [Reflection.Assembly]::LoadFile("C:\Program Files\CData\CData ADO.NET Provider for Vault CRM\lib\System.Data.CData.VaultCRM.dll")
    

2. Connect to Vault CRM:

    
   $conn= New-Object System.Data.CData.VaultCRM.VaultCRMConnection("User=myuser;Password=mypassword;Server=localhost;Database=mydatabase;")
   $conn.Open()
   

3. Instantiate the VaultCRMDataAdapter, execute an SQL query, and output the results:

   $sql="SELECT ProductId, ProductName from NorthwindProducts"
   
   $da= New-Object System.Data.CData.VaultCRM.VaultCRMDataAdapter($sql, $conn)
   $dt= New-Object System.Data.DataTable
   $da.Fill($dt)
   
   $dt.Rows | foreach {
   	Write-Host $_.productid $_.productname
   }
    

Update Vault CRM Data

PowerShell

Update-VaultCRM -Connection $VaultCRM -Columns @('ProductId','ProductName') -Values @('MyProductId', 'MyProductName') -Table NorthwindProducts -Id "MyId"

ADO.NET

$cmd = New-Object System.Data.CData.VaultCRM.VaultCRMCommand("UPDATE NorthwindProducts SET CategoryId='5' WHERE Id = @myId", $conn)
$cmd.Parameters.Add((New-Object System.Data.CData.VaultCRM.VaultCRMParameter("@myId","10456255-0015501366")))
$cmd.ExecuteNonQuery()

Insert Vault CRM Data

PowerShell

Add-VaultCRM -Connection $VaultCRM -Table NorthwindProducts -Columns @("ProductId", "ProductName") -Values @("MyProductId", "MyProductName") 

ADO.NET

$cmd = New-Object System.Data.CData.VaultCRM.VaultCRMCommand("INSERT INTO NorthwindProducts (CategoryId) VALUES (@myCategoryId)", $conn)
$cmd.Parameters.Add((New-Object System.Data.CData.VaultCRM.VaultCRMParameter("@myCategoryId","5")))
$cmd.ExecuteNonQuery()

Delete Vault CRM Data

PowerShell

Remove-VaultCRM -Connection $VaultCRM -Table "NorthwindProducts" -Id "MyId"

ADO.NET

$cmd = New-Object System.Data.CData.VaultCRM.VaultCRMCommand("DELETE FROM NorthwindProducts WHERE Id=@myId", $conn)
$cmd.Parameters.Add((New-Object System.Data.CData.VaultCRM.VaultCRMParameter("@myId","001d000000YBRseAAH")))
$cmd.ExecuteNonQuery()