Automate Humanity Integration Tasks from PowerShell

The CData API Driver for ADO.NET is a standard ADO.NET Provider that make it easy to accomplish data cleansing, normalization, backup, and other integration tasks by enabling real-time access to Humanity.

ADO.NET Provider

The ADO.NET Provider provides a SQL interface for Humanity; this tutorial shows how to use the Provider to retrieve Humanity data.

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

Start by setting the Profile connection property to the location of the Humanity Profile on disk (e.g. C:\profiles\Humanity.apip). Next, set the ProfileSettings connection property to the connection string for Humanity (see below).

Humanity API Profile Settings

Create an OAuth application from Settings > API V2 in your Humanity account to obtain an App ID and App Secret.

1. Load the provider's assembly:

   [Reflection.Assembly]::LoadFile("C:\Program Files\CData\CData API Driver for ADO.NET\lib\System.Data.CData.API.dll")
       

2. Connect to Humanity:

    
   $conn= New-Object System.Data.CData.API.APIConnection("Profile=C:\profiles\Humanity.apip;Authscheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;")
   $conn.Open()
   

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

   $sql="SELECT Id, Store from Budget"
   
   $da= New-Object System.Data.CData.API.APIDataAdapter($sql, $conn)
   $dt= New-Object System.Data.DataTable
   $da.Fill($dt)
   
   $dt.Rows | foreach {
   	Write-Host $_.id $_.store
   }