接続の確立

Visual Studio 2022 でSSIS を有効化

Visual Studio 2022 を使用している場合、SSIS を使用するにはSQL Server Integration Services プロジェクト拡張機能をインストールする必要があります。

拡張機能 -> 拡張機能の管理に移動します。
拡張機能の管理ウィンドウの検索ボックスで"SQL Server Integration Services Projects 2022" を検索し、リストから拡張機能を選択します。
ダウンロードをクリックします。
Visual Studio を終了し、ダウンロードしたMicrosoft.DataTools.IntegrationServices.exe インストーラーを実行します。デフォルト設定でインストーラーを進めてください。
Visual Studio を開きます。これで、"Integration Services Project" プロジェクトテンプレートが利用可能になるはずです。

SAP Ariba 接続マネージャーの追加

新しい接続マネージャーを以下のように作成します。

"Integration Services Project" テンプレートを使用してVisual Studio プロジェクトを作成します。
接続マネージャーウィンドウ内で右クリックし、メニューから新しい接続を選択します。
説明カラムでCData SAP Ariba Connection Manager を選択し、追加...をクリックします。
次のセクションで説明するように、本製品を設定します。

または、既存のプロジェクトがあり、CData SAP Ariba Source またはCData SAP Ariba Destination がある場合：

データフローでCData SAP Ariba Source またはDestination コンポーネントを右クリックします。
編集...を選択し、編集ウィンドウを開きます。
接続マネージャー：の横にある新規作成...ボタンをクリックします。ドロップダウンのセレクターを使用して接続マネージャーを作成します。
次のセクションで説明するように、本製品を設定します。

SAP Ariba への接続

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

ANID：Ariba Network ID。
API：本製品にSAP Ariba データを取得させたいAPI を指定。ビジネスロールに基づき、Buyer またはSupplier API を選択します。
Environment：接続に使用する開発環境。

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 アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。

SSIS Components for SAP Ariba Procurement