標準PowerShell cmdlets を使ってMYOB AccountRight テーブルにアクセスして、CSV にエクスポート。
CData Cmdlets Module for MYOB AccountRight は、直感的なMYOB AccountRight データ連携を提供する標準cmdlet です。 本記事では、MYOB Cmdlets を使ったサンプルを提供します。
MYOB AccountRight への接続を設定
これらのプロパティは会社のファイルに接続するときに必要です(クラウドインスタンスおよびオンプレミスインスタンスの両方)。
- User:会社のファイルに紐づいているユーザー名。
- Password:会社のファイルに紐づいているパスワード。
- CompanyFileId:会社ファイルのID。指定しない場合は、最初に返された会社ファイルのID が使用されます。CompanyFiles ビュー をクエリしてこれを見ることができます:
SELECT Id FROM CompanyFiles
オンプレミスインスタンスへの接続:
InitiateOAuth:OFF に設定。オンプレミスインスタンスに接続する場合は、上記に加えて、次の接続プロパティを設定する必要があります。
- Url: MYOB インスタンスのURL。
クラウドインスタンスへの接続:
MYOB のクラウドインスタンスに接続するには、OAuth アプリを作成する必要があります。このプロセスの詳細は、カスタムOAuth アプリの作成 にあります。
$conn = Connect-MYOB -OAuthClientId "$OAuthClientId" -OAuthClientSecret "$OAuthClientSecret" -CompanyFileId "$CompanyFileId" -CallbackURL "$CallbackURL" -User "$User" -Password "$Password"
MYOB AccountRight データを取得してCSV にパイプライン
次の手順で、Accounts テーブルデータを取得して、結果をCSV ファイルにエクスポートします:
Select-MYOB -Connection $conn -Table Accounts | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myAccountsData.csv -NoTypeInformation
このように、Select-MYOB から取得した結果を、Select-Object cmdlet に流し、Export-Csv cmdlet に渡す前にいくつかのプロパティを除外しています。これは、CData Cmdlets が接続情報、テーブル、およびカラム情報が結果セットのそれぞれの"行"に挿入されるためです。それらの情報を表示したくない場合に、Export-Csv cmdlet に渡す前に除外を先に行い、それからCSV ファイルにエクスポートします。。
CData Cmdlets から、次のCmdlets にデータをパイプラインするところでは、接続、テーブル、カラムの情報が必要です。データの削除
以下のように、指定に合致するレコードを削除することができます:
Select-MYOB -Connection $conn -Table Accounts -Where "Type = Bank" | Remove-MYOB
データの挿入と更新
CData Cmdlets は、データの加工やクレンジングを行うことができます。以下の手順では、CSV ファイルのデータを、挿入対象のオブジェクトに同じレコードが存在するかを確認した上で、存在する場合にはデータの更新、存在しない場合にはデータの挿入を行います。
Import-Csv -Path C:\MyAccountsUpdates.csv | %{ $record = Select-MYOB -Connection $MYOB -Table Accounts -Where ("Id = `'"+$_.Id+"`'") if($record){ Update-MYOB -Connection $myob -Table Accounts -Columns ("Id","Name") -Values ($_.Id, $_.Name) -Where ("Id = `'"+$_.Id+"`'") }else{ Add-MYOB -Connection $myob -Table Accounts -Columns ("Id","Name") -Values ($_.Id, $_.Name) } }
このように、CData Cmdlets でデータ連携をシンプルに構成できます。Cmdlets では、モジュールのインストール、接続プロパティの設定だけで、データ連携の構築を始めることができます。是非、CData PowerShell Cmdlets の無償試用版をダウンロードして、シンプルかつパワフルなデータ連携を体感してください。