PowerShell からBlackbaud FE NXT データに接続してデータの取得・CSV エクスポートを実行する方法

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData Cmdlets for FinancialEdgeNXT を使えば、PowerShell からBlackbaud FE NXT に手軽に連携して、データのCRUD やエクスポートを実行できます。

本記事では、Blackbaud FE NXT への接続方法からCSV エクスポート、データの操作までサンプルコード付きで解説していきます。

Blackbaud FE NXT への接続を設定

それでは、まずはBlackbaud FE NXT への接続設定からはじめていきましょう。接続設定にはCData Blackbaud FE NXT Cmdlets が必要となります。右側のサイドバーから製品の全機能が使える30日間の無償トライアルがダウンロードできるので、ぜひご利用ください。

インストールが完了したら、プロファイルに以下の行を追加してください。次のPowerShell セッションでモジュールがロードされます。

    Import-Module FinancialEdgeNXTCmdlets;

Connect-FinancialEdgeNXT コマンドを使ってBlackbaud FE NXT との接続を設定します。各接続プロパティの取得方法は次に説明します。

    $conn = Connect-FinancialEdgeNXT  -SubscriptionKey "$SubscriptionKey"

Blackbaud Financial Edge NXT はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。

認証方法についての詳細は、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

これで接続設定は完了です。

Blackbaud FE NXT データを取得してCSV にパイプライン

接続が完了したので、Accounts テーブルデータを取得して結果をCSV ファイルにエクスポートします。

Select-FinancialEdgeNXT -Connection $conn -Table Accounts | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myAccountsData.csv -NoTypeInformation

このコードでは、Select-FinancialEdgeNXT から取得した結果をSelect-Object に流して、Export-Csv に渡す前にいくつかのプロパティを除外しています。これは、CData Cmdlets が接続情報、テーブル、およびカラム情報を結果セットのそれぞれの行に挿入するためです。それらの情報を表示したくない場合に、Export-Csv コマンドに渡す前に除外を先に行い、そのあとでCSV ファイルにエクスポートします。

おわりに

このように、CData Cmdlets を使えばPowerShell でのBlackbaud FE NXT データへの連携をシンプルに実現できます。ぜひCData PowerShell Cmdlets の30日間無償トライアルをダウンロードして、シンプルかつパワフルなデータ連携をお試しください。