接続の確立

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

インストールおよび接続

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

Install-Module SAPAribaSourceCmdlets

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

Import-Module SAPAribaSourceCmdlets;

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

$conn = Connect-SAPAribaSource -API "SupplierDataAPIWithPagination-V4" -APIKey "wWVLn7WTAXrIRMAzZ6VnuEj7Ekot5jnU" -Environment "SANDBOX" -Realm "testRealm" -AuthScheme "OAuthClient" -InitiateOAuth "GETANDREFRESH" -OAuthClientId "testClient" -OAuthClientSecret "testClientSecret"

SAP Ariba への接続

接続するには以下を設定します。

API：本製品にSAP Ariba データを取得させたいAPI を指定。ビジネスロールに基づき、Supplier、Sourcing Project Management、またはContract API を選択します。
DataCenter：アカウントのデータがホストされているデータセンター。
Realm：アクセスしたいサイト名。
Environment：テスト環境、サンドボックス環境、本番環境のどれに接続するかを指定。

Supplier Data API またはContract API に接続する場合は、さらに以下を設定します。

User：API 呼び出しを行うユーザーのId。
PasswordAdapter：認証するUser に関連付けられたパスワード。

最後に、Supplier API に接続している場合は、ProjectId をデータを取得したいソーシングプロジェクトのId に設定します。

SAP Ariba への認証

SAP Ariba API への認証はOAuth 経由で行われます。SAP Ariba のOAuth フローは、ユーザーインタラクションを必要としません。

OAuthClient

AuthScheme をOAuthClient に設定します。

サービスにアプリケーションを登録し、APIKey、OAuthClientId、およびOAuthClientSecret を取得する必要があります。

アプリケーションの作成については、カスタムOAuth アプリの作成を参照してください。

InitiateOAuth のデフォルトは、OAuthClient 認証スキームのGETANDREFRESH です。

OAuth の自動リフレッシュ

OAuth アクセストークンの取得およびリフレッシュ

以下を設定して、接続してください。

APIKey：アプリケーション設定のApplication key。
OAuthClientId：アプリケーション設定のOAuth Client Id。
OAuthClientSecret：アプリケーション設定のOAuth Secret。

接続すると、本製品は自動でOAuth プロセスを完了します。

本製品はSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします。
本製品はアクセストークンの期限が切れると自動的にリフレッシュします。
OAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます。

OAuth の手動リフレッシュ

OAuth アクセストークンの取得

次の接続プロパティを設定し、OAuthAccessToken を取得します。

APIKey：アプリケーション設定のApplication key。
OAuthClientId：アプリケーション設定のOAuth Client Id。
OAuthClientSecret：アプリケーション設定のOAuth Secret。

次に、GetOAuthAccessToken ストアドプロシージャを呼び出します。GrantType インプットをclient_credentials またはopenapi_2lo（レガシーユーザーで利用可能）に設定します。指定されていない場合、GrantType のデフォルトはclient_credentials になります。

アクセストークンとリフレッシュトークンを取得した後、データに接続し、OAuth アクセストークンを自動または手動でリフレッシュすることが可能です。

OAuth アクセストークンの自動リフレッシュ

本製品がOAuth アクセストークンを自動的にリフレッシュするようにするには、最初のデータ接続で次のように設定します。

InitiateOAuth：REFRESH。
APIKey：アプリケーション設定のApplication key。
OAuthClientId：アプリケーション設定のOAuth Client Id。
OAuthClientSecret：アプリケーション設定のOAuth Secret。
OAuthAccessToken：GetOAuthAccessToken によって返されたアクセストークン。
OAuthRefreshToken：GetOAuthAccessToken によって返されたリフレッシュトークン。

OAuth アクセストークンの手動リフレッシュ

データ接続時に手動でOAuth アクセストークンをリフレッシュするために必要な値は、OAuth リフレッシュトークンのみです。 GetOAuthAccessToken によって返されたExpiresIn パラメータ値が経過した後に、RefreshOAuthAccessToken ストアドプロシージャを使用し、手動でOAuthAccessToken をリフレッシュします。次の接続プロパティを設定します。

APIKey：アプリケーション設定のApplication key。
OAuthClientId：アプリケーション設定のOAuth Client Id。
OAuthClientSecret：アプリケーション設定のOAuth Secret。

次に、RefreshOAuthAccessToken を呼び出し、OAuthRefreshToken にGetOAuthAccessToken によって返されたOAuth リフレッシュトークンを指定します。新しいトークンが取得できたら、OAuthAccessToken プロパティにRefreshOAuthAccessToken によって返された値を設定し、新しい接続をオープンします。

最後に、OAuth リフレッシュトークンを保存し、OAuth アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。

データの取得

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

$results = Select-SAPAribaSource -Connection $conn -Table "Vendors" -Columns @("SMVendorID, Category") -Where "SMVendorID='S123456'"

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

cmdlet 出力のパイプ処理

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

Select-SAPAribaSource -Connection $conn -Table Vendors -Where "SMVendorID = 'S123456'" | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myVendorsData.csv -NoTypeInformation

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

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

 
PS C:\> $conn  = Connect-SAPAribaSource -API "SupplierDataAPIWithPagination-V4" -APIKey "wWVLn7WTAXrIRMAzZ6VnuEj7Ekot5jnU" -Environment "SANDBOX" -Realm "testRealm" -AuthScheme "OAuthClient" -InitiateOAuth "GETANDREFRESH" -OAuthClientId "testClient" -OAuthClientSecret "testClientSecret"
PS C:\> $row = Select-SAPAribaSource -Connection $conn -Table "Vendors" -Columns (SMVendorID, Category) -Where "SMVendorID = 'S123456'" | select -first 1
PS C:\> $row | ConvertTo-Json
{
  "Connection":  {

  },
  "Table":  "Vendors",
  "Columns":  [

  ],
  "SMVendorID":  "MySMVendorID",
  "Category":  "MyCategory"
}

データの削除

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

Select-SAPAribaSource -Connection $conn -Table Vendors -Where "SMVendorID = 'S123456'" | Remove-SAPAribaSource

データの変更

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

Import-Csv -Path C:\MyVendorsUpdates.csv | %{
  $record = Select-SAPAribaSource -Connection $conn -Table Vendors -Where ("Id = `'"+$_.Id+"`'")
  if($record){
    Update-SAPAribaSource -Connection $conn -Table Vendors -Columns @("SMVendorID","Category") -Values @($_.SMVendorID, $_.Category) -Where "Id  = `'$_.Id`'"
  }else{
    Add-SAPAribaSource -Connection $conn -Table Vendors -Columns @("SMVendorID","Category") -Values @($_.SMVendorID, $_.Category)
  }
}

Cmdlets for SAP Ariba Source