Ready to get started?

Learn more about the CData ADO.NET Provider for Blackbaud FE NXT or download a free trial:

Download Now

Automate Blackbaud FE NXT Integration Tasks from PowerShell

Are you looking for a quick and easy way to access Blackbaud FE NXT data from PowerShell? We show how to use the Cmdlets for Blackbaud FE NXT and the CData ADO.NET Provider for Blackbaud FE NXT to connect to Blackbaud FE NXT data and synchronize, automate, download, and more.

The CData Cmdlets for Blackbaud FE NXT 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 Blackbaud FE NXT.

Cmdlets or ADO.NET?

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

After obtaining the needed connection properties, accessing Blackbaud FE NXT data in PowerShell consists of three basic steps.

Blackbaud Financial Edge NXT uses the OAuth authentication standard. To authenticate using OAuth, you will need to create an app to obtain the OAuthClientId, OAuthClientSecret, and CallbackURL connection properties.

See the Getting Started guide in the CData driver documentation for more information.

PowerShell

  1. Install the module:

    Install-Module FinancialEdgeNXTCmdlets
  2. Connect:

    $financialedgenxt = Connect-FinancialEdgeNXT -SubscriptionKey "$SubscriptionKey"
  3. Search for and retrieve data:

    $modifiedby = "System" $accounts = Select-FinancialEdgeNXT -Connection $financialedgenxt -Table "Accounts" -Where "ModifiedBy = `'$ModifiedBy`'" $accounts

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

    $accounts = Invoke-FinancialEdgeNXT -Connection $financialedgenxt -Query 'SELECT * FROM Accounts WHERE ModifiedBy = @ModifiedBy' -Params @{'@ModifiedBy'='System'}

ADO.NET

  1. Load the provider's assembly:

    [Reflection.Assembly]::LoadFile("C:\Program Files\CData\CData ADO.NET Provider for Blackbaud FE NXT\lib\System.Data.CData.FinancialEdgeNXT.dll")
  2. Connect to Blackbaud FE NXT:

    $conn= New-Object System.Data.CData.FinancialEdgeNXT.FinancialEdgeNXTConnection("SubscriptionKey=MySubscriptionKey;InitiateOAuth=GETANDREFRESH") $conn.Open()
  3. Instantiate the FinancialEdgeNXTDataAdapter, execute an SQL query, and output the results:

    $sql="SELECT AccountId, AccountNumber from Accounts" $da= New-Object System.Data.CData.FinancialEdgeNXT.FinancialEdgeNXTDataAdapter($sql, $conn) $dt= New-Object System.Data.DataTable $da.Fill($dt) $dt.Rows | foreach { Write-Host $_.accountid $_.accountnumber }

Update Blackbaud FE NXT Data

PowerShell

Update-FinancialEdgeNXT -Connection $FinancialEdgeNXT -Columns @('AccountId','AccountNumber') -Values @('MyAccountId', 'MyAccountNumber') -Table Accounts -Id "MyId"

ADO.NET

$cmd = New-Object System.Data.CData.FinancialEdgeNXT.FinancialEdgeNXTCommand("UPDATE Accounts SET ModifiedBy='System' WHERE Id = @myId", $conn) $cmd.Parameters.Add(new System.Data.CData.FinancialEdgeNXT.FinancialEdgeNXTParameter("@myId","10456255-0015501366")) $cmd.ExecuteNonQuery()

Insert Blackbaud FE NXT Data

PowerShell

Add-FinancialEdgeNXT -Connection $FinancialEdgeNXT -Table Accounts -Columns @("AccountId", "AccountNumber") -Values @("MyAccountId", "MyAccountNumber")

ADO.NET

$cmd = New-Object System.Data.CData.FinancialEdgeNXT.FinancialEdgeNXTCommand("INSERT INTO Accounts (ModifiedBy) VALUES (@myModifiedBy)", $conn) $cmd.Parameters.Add(new System.Data.CData.FinancialEdgeNXT.FinancialEdgeNXTParameter("@myModifiedBy","System")) $cmd.ExecuteNonQuery()

Delete Blackbaud FE NXT Data

PowerShell

Remove-FinancialEdgeNXT -Connection $FinancialEdgeNXT -Table "Accounts" -Id "MyId"

ADO.NET

$cmd = New-Object System.Data.CData.FinancialEdgeNXT.FinancialEdgeNXTCommand("DELETE FROM Accounts WHERE Id=@myId", $conn) $cmd.Parameters.Add(new System.Data.CData.FinancialEdgeNXT.FinancialEdgeNXTParameter("@myId","001d000000YBRseAAH")) $cmd.ExecuteNonQuery()