製品情報をご覧ください

製品情報や無償評価版を製品ページにてご確認いただけます。

製品ページへ

PowerShell Cmdlets でFinancialForce データをCSV にエクスポート

標準PowerShell cmdlets を使ってFinancialForce テーブルにアクセスして、CSV にエクスポート。

CData Cmdlets Module for FinancialForce は、直感的なFinancialForce データ連携を提供する標準cmdlet です。 本記事では、FinancialForce Cmdlets を使ったサンプルを提供します。

FinancialForce への接続を設定

There are several authentication methods available for connecting to FinancialForce: login credentials, SSO, and OAuth.

Authenticating with a Login and Token

Set the User and Password to your login credentials. Additionally, set the SecurityToken. By default, the SecurityToken is required, but you can make it optional by allowing a range of trusted IP addresses.

To disable the security token:

  1. Log in to FinancialForce and enter "Network Access" in the Quick Find box in the setup section.
  2. Add your IP address to the list of trusted IP addresses.

To obtain the security token:

  1. Open the personal information page on FinancialForce.com.
  2. Click the link to reset your security token. The token will be emailed to you.
  3. Specify the security token in the SecurityToken connection property or append it to the Password.

Authenticating with OAuth

If you do not have access to the user name and password or do not want to require them, use the OAuth user consent flow. See the OAuth section in the Help for an authentication guide.

Connecting to FinancialForce Sandbox Accounts

Set UseSandbox to true (false by default) to use a FinancialForce sandbox account. Ensure that you specify a sandbox user name in User.

$conn = Connect-FinancialForce  -User "$User" -Password "$Password" -Security Token "$Security Token"

FinancialForce データを取得してCSV にパイプライン

次の手順で、Account テーブルデータを取得して、結果をCSV ファイルにエクスポートします:

Select-FinancialForce -Connection $conn -Table Account | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myAccountData.csv -NoTypeInformation

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

CData Cmdlets から、次のCmdlets にデータをパイプラインするところでは、接続、テーブル、カラムの情報が必要です。

データの削除

以下のように、指定に合致するレコードを削除することができます:

Select-FinancialForce -Connection $conn -Table Account -Where "Industry = Floppy Disks" | Remove-FinancialForce

データの挿入と更新

CData Cmdlets は、データの加工やクレンジングを行うことができます。以下の手順では、CSV ファイルのデータを、挿入対象のオブジェクトに同じレコードが存在するかを確認した上で、存在する場合にはデータの更新、存在しない場合にはデータの挿入を行います。

Import-Csv -Path C:\MyAccountUpdates.csv | %{
  $record = Select-FinancialForce -Connection $FinancialForce -Table Account -Where ("Id = `'"+$_.Id+"`'")
  if($record){
    Update-FinancialForce -Connection $financialforce -Table Account -Columns ("BillingState","Name") -Values ($_.BillingState, $_.Name) -Where ("Id = `'"+$_.Id+"`'")
  }else{
    Add-FinancialForce -Connection $financialforce -Table Account -Columns ("BillingState","Name") -Values ($_.BillingState, $_.Name)
  }
}

このように、CData Cmdlets でデータ連携をシンプルに構成できます。Cmdlets では、モジュールのインストール、接続プロパティの設定だけで、データ連携の構築を始めることができます。是非、CData PowerShell Cmdlets の無償試用版をダウンロードして、シンプルかつパワフルなデータ連携を体感してください。

 
 
ダウンロード