はじめに
この記事では、SAP Cloud Integrationを利用してODataサービスを呼ぶ、というシンプルなシナリオを実装してみます。単に「つなげるだけ」に主眼を置いており、取得したデータを利用することはしていません。シンプルに見えてつまづいた点もあったので記録に残しておきます。
初期設定は以下のチュートリアルを参考に実施します。
Set Up Integration Suite Trial
呼び出すサービス
2つのODataサービスを呼んでみます。いずれも、API Business Hubのサンドボックス環境を使用します。
- SAP GraphのSales Order （OData V4）
- S/4HANA CloudのSales Order (A2X) （OData V2）
事前準備
EDMXファイルのダウンロード
API Business Hubから各ODataサービスのEDMXファイルをダウンロードしておきす。
API Keyの取得
"Show API Key"をクリックしてAPI Keyを表示させ、コピーしておきます。
Integration Flowの作成
以下のようなフローを作成しました。各ステップの設定は以降で説明します。（Graph APIを呼ぶためにHTTPとOData V4と2つの方法を試しています）
Start Timer
タイマーで起動する設定です。このフローはデプロイ時に一度だけ動きます。
Set API Key
このステップはContent Modifierです。Content Modifierでは後続処理に渡すためのヘッダやボディの項目を編集できます。ここではapiKeyというヘッダ項目を定義しました。Valueには、事前準備で取得したAPI Keyを設定します。
Get Graph HTTP
最初はあえてODataアダプターを使わずに、HTTPアダプターでGraphのODataサービスを呼んでみます。
ポイントは、Request HeadersにContent Modifierで設定したapiKeyを指定するところです。ここではヘッダ項目が1つだけですが、複数指定する場合は|で区切って指定します。
Get SO V2
次に、S/4HANA CloudのSales OrderをOData V2のアダプターで呼びます。
ProcessingタブでResource Pathを選ぶときは、"Select"ボタンを押してダウンロードしておいたEDMXファイルを取り込みます。
ステップ1でLocal EDMX Fileを選択し、ダウンロードしておいたファイルを選択します。
ステップ2でエンティティを選択し、取得する項目やTop, Skipといったクエリパラメータを指定します。
Processingタブの下の方では、Request HeadersにapiKeyを設定します。HEADER DETAILSとMETADATA DETAILSの両方に設定します。
Get Graph OData V4
最後に、GraphのSales OrderをOData V4のアダプターで呼びます。
Proccessingタブでは、OData V2と同様に、ダウンロードしておいたEDMXファイルを取り込んでクエリパラメータの設定をします。Request HeadersにapiKeyを設定します。
以上でフローの設定は完了です。
接続のテスト
フローを動かす前に、各バックエンドへの接続がうまくいくかテストしてみましょう。
"TLS"のタブでテストします。証明書の有効性が確認でき、安全に接続できるかどうかがテストされます。
Hostに接続先のホスト名（https://を含まない）を入力し、"Send"をクリックします。
Integration Flowのテスト
作成したフローをデプロイします。タイマー起動なので、デプロイが完了するとすぐに動きます。Monitor Message Processingのタイルを見ると、エラーになっていることがわかります。
エラーのログを見ると、最後のOData V4の接続でエラーになっています。HTTPアダプターでは接続できましたが、OData V4アダプターでは接続できなかったようです。
エラーの詳細は以下です。unable to find valid certification path to requested targetというのが根本原因のようです。
トラブルシューティング
以下のノートによると、ODataV4の場合は接続先のホストの証明書の他に、EDMXが参照する外部のEDMXファイルにかかわる証明書が必要になるそうです。
https://launchpad.support.sap.com/#/notes/0002891906
EDMXファイルを開くと、以下の部分があります。https://oasis-tcs.github.ioの証明書が必要ということになります。
<edmx:Reference Uri="https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Capabilities.V1.xml">
<edmx:Include Alias="Capabilities" Namespace="Org.OData.Capabilities.V1"/>
</edmx:Reference>
証明書をダウンロードするには、ブラウザにhttps://oasis-tcs.github.ioと打ち込み、"Certificate"をクリックします。詳細な手順については以下のノートをご参照ください。
https://launchpad.support.sap.com/#/notes/2715005
証明書をダウンロードしたら、Keystoreからインポートします。
Add>Certificateより、ダウンロードした証明書を選択します。
証明書が追加されました。
念のためoasis-tcs.github.ioへの接続をテストしてみると、正常に終了します。
このあとフローを再度デプロイすると、正常に終了します。
まとめ
ODataサービスを呼ぶという簡単なシナリオでしたが、わかったことがいくつかありあす。
- HTTPリクエストのヘッダは事前にContent Modifierで作成しておく必要がある
- OData V4を使う場合、接続先ホスト以外にも証明書が必要になる
- Connectivity Testをやっておくと吉（接続の問題なのかフローの問題なのかが切り分けれられる）
- 証明書エラーはよく起きる。起こったら粛々と証明書をインポートすること