PowerShell からPonparemall データに接続してデータの取得・更新・挿入・削除・CSV エクスポートを実行する方法

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

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

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

Ponparemall への接続を設定

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

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

    Import-Module PonparemallCmdlets;

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

    $conn = Connect-Ponparemall  -InventoryUserId "$InventoryUserId" -InventoryPassword "$InventoryPassword"

Ponparemall に接続するには、ShopUrl、InventoryUserId、InventoryPassword、OrderUserId、OrderPassword、PaymentUserId、およびPaymentPassword が必要です。

Ponparemall へのアクセスの設定

Ponparemall には各API のId とPassword が必要です。取得するには、以下の手順に従ってください。

• Ponparemall Manager にログインし、メニューの「各種申請」の「WebAPI利用申請」をクリックします。
• Web API メニューの「WebAPIサービス利用申請」をクリックし、利用申請を行います。
• 後日、Ponparemall から必要なId とPassword が送られてきます。

Ponparemall アカウントの認証

次の接続プロパティを設定して接続します。

• ShopUrl：接続先のPonparemall Shop URL を設定。「http://storetst4.ponparemall.com/sample/」に含まれる「sample」の部分を入力します。
• InventoryUserId：「在庫API」のユーザID を設定。このプロパティは、Inventory テーブルにアクセスする場合に必要です。
• InventoryPassword：「在庫API」のパスワードを設定。このプロパティは、Inventory テーブルにアクセスする場合に必要です。
• OrderUserId：「受注API」のユーザID を設定。このプロパティは、Orders テーブルにアクセスする場合に必要です。
• OrderPassword：「受注API」のパスワードを設定。このプロパティは、Orders テーブルにアクセスする場合に必要です。
• PaymentUserId：「決済API」のユーザID を設定。このプロパティは、Payments テーブルにアクセスする場合に必要です。
• PaymentPassword：「決済API」のパスワードを設定。このプロパティは、Payments テーブルにアクセスする場合に必要です。

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

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

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

Select-Ponparemall -Connection $conn -Table Orders | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myOrdersData.csv -NoTypeInformation

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

それでは、続いてデータの削除や挿入・更新を実行してみます。

データの削除

以下のように、フィルタリングで合致するレコードを削除することができます。

Select-Ponparemall -Connection $conn -Table Orders -Where "DateRangeSearchColumn = 2" | Remove-Ponparemall

データの挿入と更新

データの挿入や更新を使って、加工やクレンジングも行えます。以下の手順では、CSV ファイルのデータを読み込んで挿入対象のオブジェクトに同じレコードが存在するかを確認した上で、存在する場合にはデータを更新、存在しない場合にはデータの挿入を行います。

Import-Csv -Path C:\MyOrdersUpdates.csv | %{
  $record = Select-Ponparemall -Connection $Ponparemall -Table Orders -Where ("Id = `'"+$_.Id+"`'")
  if($record){
    Update-Ponparemall -Connection $ponparemall -Table Orders -Columns ("OrderNumber","OrderStatus") -Values ($_.OrderNumber, $_.OrderStatus) -Where ("Id = `'"+$_.Id+"`'")
  }else{
    Add-Ponparemall -Connection $ponparemall -Table Orders -Columns ("OrderNumber","OrderStatus") -Values ($_.OrderNumber, $_.OrderStatus)
  }
}

おわりに

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