CData SSIS Components for SAP Ariba Procurement はじめに:インストールから接続まで
このガイドでは、CData SSIS Components for SAP Ariba Procurement の使い方を詳しく解説します。コンポーネントのインストール、ライセンスの認証、初回 SSIS 接続マネージャーの設定、そして SQL Server Integration Services ワークフローで SAP Ariba Procurement のデータ を移動・変換するためのデータフロータスクの作成方法を学べます。
インストールとライセンス認証
システム要件
- Windows: Windows 10/11 または Windows Server 2016 以降
- Visual Studio: Visual Studio 2015 以降
- SQL Server: SQL Server 2014、2016、2017、2019、または 2022
SSIS コンポーネントのインストール
- CData アカウントまたは評価版ダウンロードページから SAP Ariba Procurement 用の SSIS Components インストーラーをダウンロードします
- インストーラーを実行し、インストールウィザードに従います
- インストーラーが自動的に接続マネージャー、ソース、宛先コンポーネントを Visual Studio に登録します
- プロンプトが表示されたら、CData Orders チームから送られたプロダクトキーを使用してライセンスを認証します:
XXXX-XXXX-XXXX-XXXX-XXXX- Note: 試用版を実行するには、Trial Key オプションを選択してください。
Visual Studio 2022 での SSIS の有効化
Visual Studio 2022 を使用している場合は、SQL Server Integration Services Projects 拡張機能をインストールする必要があります。
- Visual Studio で 拡張機能 > 拡張機能の管理 を選択します
- SQL Server Integration Services Projects 2022 を検索します
- インストールをクリックします
- Visual Studio を閉じ、ダウンロードした Microsoft.DataTools.IntegrationServices.exe インストーラーを実行します
- Visual Studio を再度開きます。新しいプロジェクトを作成する際に Integration Services Project テンプレートが表示されるようになります
ライセンスの認証
インストール中に SSIS Component ライセンスの認証が求められます。認証を更新または変更する必要がある場合は、以下の手順に従ってください:
ライセンス認証
インストーラーが自動的にライセンスの追加を促します。インストール時に以下を選択できます:
- 既存のサブスクリプションライセンスキーを使用する、または
- 試用版ライセンスを入力する
正規サブスクリプションライセンスを認証するには、CData Orders チームにお問い合わせいただき、[email protected] でプロダクトキーをリクエストしてください。
プロンプトが表示されたら、インストーラーにライセンスキーを入力します。認証が完了すると、追加の手順なしに Visual Studio 内でコンポーネントがライセンス認証され、使用できるようになります。
ランタイムライセンス
SSIS パッケージをデプロイする際は、ランタイムキー(RTK)も使用できます:
- デプロイ前に接続マネージャーで RTK プロパティを設定します
ライセンスに関するよくある質問
ライセンスは複数のマシンで使用できますか?
はい、サブスクリプションプランによります。詳細については [email protected] までお問い合わせください。
ライセンスキーを紛失しました。どうすれば取得できますか?
注文番号を添えて [email protected] までメールでお問い合わせいただければ、ライセンスキーを再送いたします。
ライセンスを別のマシンに移行するにはどうすればよいですか?
はい。ライセンスを別のマシンに移行するには、以下のリンクからライセンス移行リクエストを送信する必要があります:
https://www.cdata.com/lic/transfer/ライセンス移行リクエストが送信され、正常に処理されると、プロダクトキーにアクティベーションが追加され、別のマシンで正規ライセンスを認証できるようになります。このプロセスが完了すると、以前のマシンのライセンスは無効になります。
ライセンスの確認とアップグレードは、セルフサービスポータル portal.cdata.com から行えます。
接続設定
コンポーネントがインストールされ、ライセンスが認証されたら、SSIS 接続マネージャーを使用して SAP Ariba Procurement への接続を設定できます。この接続マネージャーは、ソースおよび宛先コンポーネントで使用されるすべての認証および接続プロパティを保存します。
接続マネージャーの作成
- SSIS パッケージの下部にある接続マネージャーパネルで右クリックし、新しい接続を選択します
- リストから CData SSIS Components for SAP Ariba Procurement を選択します
- 追加をクリックして接続マネージャー UI を開きます
- SAP Ariba Procurement に応じて必要な認証プロパティ(OAuth、API トークン、クライアント資格情報など)を入力します
- ANID:Ariba Network ID
- API:CData 製品にSAP Ariba データを取得させたいAPI を指定してください。ビジネスロールに基づき、Buyer またはSupplier API を選択します(可能な値は、PurchaseOrdersBuyerAPIV1、または PurchaseOrdersSupplierAPIV1 です)
- Environment:接続先がテスト環境か本番環境かを指定してください(可能な値は、TEST またはPRODUCTION です)
- AuthScheme をOAuthClient に設定します
- サービスにアプリケーションを登録し、APIKey、OAuthClientId、およびOAuthClientSecret を取得する必要があります
- APIKey:アプリケーション設定のApplication key
- OAuthClientId:アプリケーション設定のOAuth Client Id
- OAuthClientSecret:アプリケーション設定のOAuth Secret
- CData 製品がSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします
- CData 製品がアクセストークンの期限が切れると自動的にリフレッシュします
- OAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます
- 接続テストをクリックして接続を確認します
接続プロパティの設定
それでは、SAP Ariba Procurement に接続していきましょう。接続するには、以下のプロパティを設定します。
OAuth 認証
続いて、接続プロパティを設定した後、認証のためにOAuth 接続を設定する必要があります。
OAuth アプリケーションの作成について、詳しくはヘルプドキュメントをご確認ください。
OAuth の自動リフレッシュ
以下のプロパティを設定して、接続してみましょう。
接続すると、CData 製品が自動でOAuth プロセスを完了します。
SSIS データフローの作成
接続マネージャーを作成したら、SSIS データフロータスクを使用して SAP Ariba Procurement からデータを取得したり、データをプッシュしたりできます。
データフロータスクの作成
- 制御フロータブで、データフロータスクをデザインサーフェスにドラッグします
- タスクをダブルクリックしてデータフローワークスペースを開きます
ソースコンポーネントの使用
- SSIS ツールボックスから、CData SAP Ariba Procurement Source コンポーネントをデータフローにドラッグします
- ダブルクリックしてソースエディターを開きます
- 作成した CData SAP Ariba Procurement 接続マネージャーを選択します
- レコードを抽出するテーブルまたはビューを選択します
- OK をクリックして設定を保存します
宛先コンポーネントの使用
- SQL Server 宛先をキャンバスにドラッグします
- ダブルクリックして宛先エディターを開きます
- 既存のテーブルを選択するか、新規をクリックしてソースのスキーマに基づいてテーブルを自動生成します
- ソースの出力を宛先の入力に接続し、必要に応じてカラムをマッピングします
- これで SAP Ariba Procurement のデータ を SQL Server データベースにレプリケートするデータフロータスクが作成されました
データフローのテスト
- 制御フロータブに戻ります
- デバッグの開始をクリックします
- 進行状況インジケーターを監視します
- 行数を確認し、データが期待どおりに読み込まれていることを確認します
よくある接続の問題
認証エラー
解決策: SAP Ariba Procurement の OAuth 設定、クライアント ID、シークレット、またはトークンの権限を確認してください。OAuth のトラブルシューティングについては [email protected] までお問い合わせください。
サーバーに接続できない
解決策: ファイアウォール、プロキシ、VPN の設定を確認してください。特定のポート要件については [email protected] までお問い合わせください。
テーブルが見つからない
解決策: SAP Ariba Procurement をクエリする際に、正しいスキーマまたはデータベースを選択しているか確認してください。
次のステップ
SSIS Components のインストール、ライセンス認証、接続設定が完了しました。以下のシナリオを参考に、SSIS ツールをさらに活用してみてください:
サポート
ご不明な点がございましたら、お気軽にお問い合わせください:
- テクニカルサポート: [email protected]
- コミュニティフォーラム: CData Community Site
- ヘルプドキュメント: ローカルにインストールされているほか、オンラインでも参照可能です
FAQ
インストールとライセンス
- SSIS Components のインストールには管理者権限が必要ですか?
はい、Visual Studio 全体で使用するコンポーネントをインストールするには管理者権限が必要です。 - Azure Data Factory にデプロイする際に RTK は必要ですか?
はい。公開前に接続マネージャーで RTK プロパティを設定してください。
接続
- 複数の SAP Ariba Procurement アカウントを使用できますか?
アカウントごとに個別の接続マネージャーを作成してください。 - プロキシ経由で接続できますか?
はい。接続マネージャーのプロパティでプロキシ設定を構成できます。 - 接続をテストするにはどうすればよいですか?
接続マネージャー UI で接続テストをクリックしてください。
パフォーマンスとトラブルシューティング
- データフローが遅いのはなぜですか?
フィルターの追加、行数の制限、ソースコンポーネントでのバッチ処理設定を確認してください。 - ログを有効にするにはどうすればよいですか?
接続マネージャーに以下を追加してください:- Logfile: /path/to/logfile.log
- Verbosity: 3
トラブルシューティングの際は、[email protected] にご連絡の上、ログファイルを安全にアップロードしてください。
この FAQ で解決しない場合は、[email protected] までお問い合わせください。