接続の確立

CData Cmdlets ユーザーは、データモジュールをインストールし、接続プロパティを設定してスクリプトを開始できます。このセクションでは、CSV インポートおよびエクスポートcmdlet などのネイティブPowerShell cmdlet でSAPHybrisC4C Cmdlets を使用する例を示します。

インストールおよび接続

PSGet がある場合は、PowerShell Gallery から次のコマンドを使ってcmdlet をインストールできます。CData サイトからセットアップを取得することもできます。

Install-Module SAPHybrisC4CCmdlets

プロファイルに以下を追加すると、次のセッションでcmdlet がロードされます。

Import-Module SAPHybrisC4CCmdlets;

Connect-SAPHybrisC4C cmdlet を使って、別のcmdlet に渡すことができる接続オブジェクトを作成します。

$conn = Connect-SAPHybrisC4C -Tenant "mytenant.crm.ondemand.com" -User "User" -Password "Password"

SAP Cloud for Customer への接続

SAP Cloud for Customer インスタンスを識別するために以下を設定します。

Tenant：SAP Cloud for Customer テナントのフルドメイン名。
Url：使用するSAP Cloud for Customer インスタンスに対応するURL。デフォルトのサービス"c4codata" と異なる場合は、これを指定する必要があります。そうでなければ、この接続プロパティは省略します。

SAP Cloud for Customer への認証

ユーザー資格情報

AuthScheme をBasic に設定し、以下を指定します。

User：SAP Cloud for Customer ユーザーネーム。
Password：SAP Cloud for Customer パスワード。

Azure AD

AuthScheme をAzureAD に設定します。

カスタム拡張機能の設定

この設定には、SAP Hybris のカスタム拡張機能が必要です。この拡張機能はyempty ツールを使用して作成できます。

接続設定

カスタム拡張機能を設定したのち、以下を設定して認証します。

OAuthClientId：アプリ登録の概要セクションにある、コネクタアプリケーションのアプリケーションId。
OAuthClientSecret：コネクタアプリケーションのクライアントシークレット値。新しいクライアントシークレットを作成すると、Azure AD にこれが表示されます。
CallbackURL：コネクタアプリケーションのリダイレクトURI。例：https://localhost:33333
SSOProperties：以下の追加プロパティを、カンマ区切りでA=B;C=D; のような形式で設定。
- Resource：使用している環境のURL。
- AzureTenant：アプリケーションが登録されているAzure AD テナントのId。

データの取得

Select-SAPHybrisC4C cmdlet はデータを取得するためのネイティブなPowerShell インターフェースを提供します。

$results = Select-SAPHybrisC4C -Connection $conn -Table "AccountCollection" -Columns @("ObjectID, AccountName") -Where "AccountName='MyAccount'"

Invoke-SAPHybrisC4C cmdlet はSQL インターフェースを提供します。このcmdlet を使うと、Query パラメータを介してSQL クエリを実行できます。

cmdlet 出力のパイプ処理

cmdlet は行オブジェクトをパイプラインに一度に一行ずつ返します。以下は、結果をCSV ファイルにエクスポートします。

Select-SAPHybrisC4C -Connection $conn -Table AccountCollection -Where "AccountName <> 'MyAccount'" | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myAccountCollectionData.csv -NoTypeInformation

Select-SAPHybrisC4C からの結果をSelect-Object cmdlet にパイプして、Export-CSV cmdlet にパイプする前にいくつかのプロパティを実行していることがわかるでしょう。これをする理由は、CData Cmdlets は接続、テーブル、およびカラムの情報を結果セットの各行オブジェクトに追加しますが、必ずしもその情報がCSV ファイルに必要ではないからです。

ただし、これによってcmdlet の出力を別のcmdlet にパイプすることが容易になります。以下に、結果セットをJSON に変換する例を示します。

 
PS C:\> $conn  = Connect-SAPHybrisC4C -Tenant "mytenant.crm.ondemand.com" -User "User" -Password "Password"
PS C:\> $row = Select-SAPHybrisC4C -Connection $conn -Table "AccountCollection" -Columns (ObjectID, AccountName) -Where "AccountName <> 'MyAccount'" | select -first 1
PS C:\> $row | ConvertTo-Json
{
  "Connection":  {

  },
  "Table":  "AccountCollection",
  "Columns":  [

  ],
  "ObjectID":  "MyObjectID",
  "AccountName":  "MyAccountName"
}

データの削除

以下は、抽出条件に合うあらゆるレコードを削除します。

Select-SAPHybrisC4C -Connection $conn -Table AccountCollection -Where "AccountName = 'MyAccount'" | Remove-SAPHybrisC4C

データの変更

cmdlet はデータクレンジング同様、データの変換を容易にします。次の例は、レコードがすでに存在するかどうか、挿入する前に更新が必要かどうかをチェックしてから、CSV ファイルのデータをSAP Cloud for Customer にロードします。

Import-Csv -Path C:\MyAccountCollectionUpdates.csv | %{
  $record = Select-SAPHybrisC4C -Connection $conn -Table AccountCollection -Where ("ObjectID = `'"+$_.ObjectID+"`'")
  if($record){
    Update-SAPHybrisC4C -Connection $conn -Table AccountCollection -Columns @("ObjectID","AccountName") -Values @($_.ObjectID, $_.AccountName) -Where "ObjectID  = `'$_.ObjectID`'"
  }else{
    Add-SAPHybrisC4C -Connection $conn -Table AccountCollection -Columns @("ObjectID","AccountName") -Values @($_.ObjectID, $_.AccountName)
  }
}

Cmdlets for SAP Cloud for Customer